{"_id":"@akm1923main/init-project","_rev":"2-bc45874478c6784a04701175fbd04379","name":"@akm1923main/init-project","dist-tags":{"latest":"1.2.0"},"versions":{"1.0.0":{"name":"@akm1923main/init-project","version":"1.0.0","keywords":["scaffold","initializer","cli","ai","project"],"license":"MIT","_id":"@akm1923main/init-project@1.0.0","maintainers":[{"name":"akm1923main","email":"amitkumarbind007@gmail.com"}],"bin":{"init-project":"index.js"},"dist":{"shasum":"bca76a5bd8d637358949a2f52391406897dcaa7b","tarball":"https://registry.npmjs.org/@akm1923main/init-project/-/init-project-1.0.0.tgz","fileCount":36,"integrity":"sha512-0DByMreK5skdHr/ge++9xSnmy1NmNTfusTLY2IzvGAQ0a/l1O7rGr3Ftg/ox46PqosjFlT/wAZfj3Uavf6S2ng==","signatures":[{"sig":"MEUCIQD1qJKVL7Hfl2MqkjsPtGUwMYm9dY13z54W2r0wIu9ThwIgNbn6h/RYhPjxU6SJjLG2Y8PeQYeXVl3yjLRSp4qspGU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":117009},"main":"index.js","type":"commonjs","_npmUser":{"name":"akm1923main","email":"amitkumarbind007@gmail.com"},"_npmVersion":"11.4.1","description":"AI-OS project initializer CLI","directories":{},"_nodeVersion":"22.16.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/init-project_1.0.0_1770935840907_0.7374387740836812","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@akm1923main/init-project","version":"1.2.0","description":"An enterprise-grade project scaffolder for bootstrapping AI-OS (Artificial Intelligence Operating System) projects with a comprehensive suite of pre-built agent skills and development workflows.","author":{"name":"akm1923main","url":"https://github.com/akm1923main"},"main":"index.js","type":"commonjs","license":"MIT","bin":{"init-project":"index.js"},"keywords":["scaffold","initializer","cli","ai","project"],"repository":{"type":"git","url":"git+https://github.com/akm1923main/init-project.git"},"bugs":{"url":"https://github.com/akm1923main/init-project/issues"},"homepage":"https://github.com/akm1923main/init-project#readme","_id":"@akm1923main/init-project@1.2.0","_nodeVersion":"22.16.0","_npmVersion":"11.4.1","dist":{"integrity":"sha512-W84VPhx5nerKo6sBdzK7SAfeldYj/F6/zzFQA5PS5DKTcnMC79abC7x76ohdQNwyuZupHvmFfO2r/M3oITb+aw==","shasum":"b5ef788609c65b9ab90ec49e66c57e2cb74bf288","tarball":"https://registry.npmjs.org/@akm1923main/init-project/-/init-project-1.2.0.tgz","fileCount":33,"unpackedSize":209084,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFcVjDzNzR9cdnQVK2ycNhK6cAB5B4flVWX0K5Sw9c1YAiBD2s6YOZeAqgq2ajB+FV1kis9MhN6vkTeDJUTgRGlS8Q=="}]},"_npmUser":{"name":"akm1923main","email":"amitkumarbind007@gmail.com"},"directories":{},"maintainers":[{"name":"akm1923main","email":"amitkumarbind007@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/init-project_1.2.0_1770977303829_0.14978007165395213"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-12T22:37:20.805Z","modified":"2026-02-13T10:08:24.052Z","1.0.0":"2026-02-12T22:37:21.060Z","1.2.0":"2026-02-13T10:08:23.951Z"},"license":"MIT","keywords":["scaffold","initializer","cli","ai","project"],"description":"An enterprise-grade project scaffolder for bootstrapping AI-OS (Artificial Intelligence Operating System) projects with a comprehensive suite of pre-built agent skills and development workflows.","maintainers":[{"name":"akm1923main","email":"amitkumarbind007@gmail.com"}],"readme":"# 🚀 AI-OS Project Initializer\n\n[![npm version](https://img.shields.io/npm/v/@akm1923main/init-project.svg)](https://www.npmjs.com/package/@akm1923main/init-project)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n> **Scaffold production-grade, AI-driven projects in seconds.**\n> An 11-phase development pipeline with **14 specialist agents**, **14 structured workflows**, and a full state-tracking system — ready to go with one command.\n\n---\n\n## 🤔 Why AI-OS?\n\nBuilding software with AI agents is powerful — but without structure, it becomes chaos. AI-OS gives you a **deterministic, phase-based pipeline** where every agent knows exactly what to do, what it needs, and what it produces.\n\n| Without AI-OS                          | With AI-OS                                               |\n| :------------------------------------- | :------------------------------------------------------- |\n| ❌ Hours of boilerplate setup          | ✅**One command, full structure**                  |\n| ❌ Agents running without coordination | ✅**11-phase pipeline with strict ordering**       |\n| ❌ No state tracking between sessions  | ✅**Evolution ledger + resume logic**              |\n| ❌ Inconsistent project structures     | ✅**Enterprise-grade, standardized architecture**  |\n| ❌ Lost context when switching agents  | ✅**Inter-agent contracts with explicit handoffs** |\n| ❌ No idea what to do next             | ✅**🧭 Helper Agent tells you exactly**            |\n\n---\n\n## ⚡ Quick Start\n\nNo installation needed. Run directly with `npx`:\n\n```bash\nnpx @akm1923main/init-project my-project\n```\n\n**That's it.** Open the generated folder and start with `PROJECT_STATE.md`.\n\n### Options\n\n```bash\nnpx @akm1923main/init-project <project-name> [options]\n\nOptions:\n  --path, -p <dir>   Target directory (default: current directory)\n  --force, -f        Allow existing folder (adds missing items only)\n  --help, -h         Show help\n```\n\n### Examples\n\n```bash\n# Create in current directory\nnpx @akm1923main/init-project my-saas-app\n\n# Create in a specific folder\nnpx @akm1923main/init-project my-saas-app --path ~/projects\n\n# Add missing files to an existing project\nnpx @akm1923main/init-project my-saas-app --force\n```\n\n---\n\n## 🔄 The AI-OS Pipeline\n\nEvery project follows an **11-phase sequential pipeline**. Each phase is owned by a specialist agent that reads upstream artifacts and produces its own output.\n\n```mermaid\nflowchart TD\n    START([\"Project Created\"]) --> P01\n\n    subgraph PLAN [\"Planning Phases\"]\n        P01[\"Phase 01: Idea Refinement\\nAgent: Idea_Analyst\\nOutput: IDEA.md\"]\n        P02[\"Phase 02: Business Analysis\\nAgent: Business_Analyst\\nOutput: PRODUCT_ANALYSIS.md\"]\n        P03[\"Phase 03: PRD Generation\\nAgent: Product_Manager\\nOutput: PRD.md\"]\n        P04[\"Phase 04: Architecture\\nAgent: Architect\\nOutput: ARCHITECTURE.md\"]\n    end\n\n    subgraph BUILD [\"Build Phases\"]\n        P05[\"Phase 05: Task Generation\\nAgent: Staff_Engineer A\\nOutput: TASK_PLAN.md\"]\n        P06[\"Phase 06: Task Execution\\nAgent: Staff_Engineer B\\nOutput: Code in 05_Project\"]\n    end\n\n    subgraph QUALITY [\"Quality Phases\"]\n        P07[\"Phase 07: Testing\\nAgent: Testing_Engineer\\nOutput: TEST_REPORT.md\"]\n        P08[\"Phase 08: Security Audit\\nAgent: Security_Engineer\\nOutput: SECURITY_AUDIT.md\"]\n        P09[\"Phase 09: Performance\\nAgent: Performance_Engineer\\nOutput: PERFORMANCE_REPORT.md\"]\n    end\n\n    subgraph SHIP [\"Ship Phases\"]\n        P10[\"Phase 10: DevOps\\nAgent: DevOps_Engineer\\nOutput: DEVOPS_PLAN.md\"]\n        P11[\"Phase 11: Deployment\\nAgent: Deployment_Engineer\\nOutput: DEPLOYMENT_GUIDE.md\"]\n    end\n\n    P01 --> P02 --> P03 --> P04\n    P04 --> P05 --> P06\n    P06 --> P07 --> P08 --> P09\n    P09 --> P10 --> P11\n    P11 --> DONE([\"Shipped!\"])\n\n    HELPER[\"Helper Agent\\nActivate anytime\"]\n    DOCS[\"Documentation Writer\\nCross-cutting\"]\n    REFACTOR[\"Refactor Specialist\\nCross-cutting\"]\n    ORCHESTRATOR[\"Master Orchestrator\\nCoordinates all agents\"]\n\n    style PLAN fill:#e3f2fd,stroke:#1565c0,color:#000\n    style BUILD fill:#fff3e0,stroke:#e65100,color:#000\n    style QUALITY fill:#e8f5e9,stroke:#2e7d32,color:#000\n    style SHIP fill:#fce4ec,stroke:#c62828,color:#000\n    style HELPER fill:#2d6a4f,stroke:#40916c,color:#fff\n    style DOCS fill:#1d3557,stroke:#457b9d,color:#fff\n    style REFACTOR fill:#6a040f,stroke:#9d0208,color:#fff\n    style ORCHESTRATOR fill:#7b2cbf,stroke:#9d4edd,color:#fff\n    style START fill:#f4a261,stroke:#e76f51,color:#000\n    style DONE fill:#2a9d8f,stroke:#264653,color:#fff\n```\n\n---\n\n## 🤖 Agents (14)\n\nEvery agent has a **defined identity**, **inter-agent communication contracts**, **lifecycle integration**, and **quality checklists**.\n\n### 📐 Pipeline Agents (11)\n\nThese agents own specific phases and execute in sequence:\n\n| Phase | Agent                                     | Role                                                 | Produces                      |\n| :---- | :---------------------------------------- | :--------------------------------------------------- | :---------------------------- |\n| 01    | 💡**Idea_Analyst**                  | Refines raw ideas into structured concepts           | `IDEA.md`                   |\n| 02    | 📊**Business_Analyst**              | Evaluates commercial viability and market fit        | `PRODUCT_ANALYSIS.md`       |\n| 03    | 📌**Product_Manager**               | Generates detailed PRD with functional requirements  | `PRD.md`                    |\n| 04    | 🏗️**Architect**                   | Designs system architecture, tech stack, data models | `ARCHITECTURE.md`           |\n| 05    | 📋**Staff_Engineer** *(Mode A)*   | Decomposes architecture into atomic tasks            | `TASK_PLAN.md` + task files |\n| 06    | ⚙️**Staff_Engineer** *(Mode B)* | Implements each task against architecture            | Code in `05_Project/`       |\n| 07    | 🧪**Testing_Engineer**              | Validates code against PRD requirements              | `TEST_REPORT.md`            |\n| 08    | 🔐**Security_Engineer**             | STRIDE threat modeling + OWASP compliance audit      | `SECURITY_AUDIT.md`         |\n| 09    | ⚡**Performance_Engineer**          | Identifies bottlenecks, evaluates scalability        | `PERFORMANCE_REPORT.md`     |\n| 10    | 🛠️**DevOps_Engineer**             | Designs CI/CD, infrastructure, containerization      | `DEVOPS_PLAN.md`            |\n| 11    | 🌐**Deployment_Engineer**           | Platform-specific deployment + runbooks              | `DEPLOYMENT_GUIDE.md`       |\n\n### 🔀 Cross-Cutting Agents (3)\n\nThese agents can be activated at **any phase**:\n\n| Agent                            | Role                                                  | When to Use                               |\n| :------------------------------- | :---------------------------------------------------- | :---------------------------------------- |\n| 🎯**Master_Orchestrator**  | Coordinates multi-agent workflows, resolves conflicts | Complex multi-phase operations            |\n| 📘**Documentation_Writer** | Generates system documentation from project artifacts | Any phase that needs docs                 |\n| 🔁**Refactor_Specialist**  | Code quality improvements, architectural cleanup      | During or after implementation            |\n| 🧭**Helper_Agent**         | Reads project state and tells you what to do next     | **Anytime you're lost or confused** |\n\n> **💡 New to AI-OS?** Start with the **🧭 Helper Agent** — it reads your project state and tells you exactly which agent to activate and what to do next.\n\n---\n\n## 📋 Workflows (14)\n\nEach workflow defines a **6-stage lifecycle**: Initialize → Validate → Execute → Verify → Close → State Sync.\n\n### Pipeline Workflows\n\n| #     | Workflow                                    | Bound Agent          | Phase |\n| :---- | :------------------------------------------ | :------------------- | :---- |\n| WF-01 | 💡`idea_refinement_workflow.md`           | Idea_Analyst         | 01    |\n| WF-02 | 📊`business_analysis_workflow.md`         | Business_Analyst     | 02    |\n| WF-03 | 📌`prd_generation_workflow.md`            | Product_Manager      | 03    |\n| WF-04 | 🏗️`architecture_generation_workflow.md` | Architect            | 04    |\n| WF-05 | 📋`task_generation_workflow.md`           | Staff_Engineer (A)   | 05    |\n| WF-06 | ⚙️`task_execution_workflow.md`          | Staff_Engineer (B)   | 06    |\n| WF-07 | 🧪`testing_workflow.md`                   | Testing_Engineer     | 07    |\n| WF-08 | 🔐`security_audit_workflow.md`            | Security_Engineer    | 08    |\n| WF-09 | ⚡`performance_review_workflow.md`        | Performance_Engineer | 09    |\n| WF-10 | 🛠️`devops_setup_workflow.md`            | DevOps_Engineer      | 10    |\n| WF-11 | 🌐`deployment_workflow.md`                | Deployment_Engineer  | 11    |\n\n### Cross-Cutting Workflows\n\n| Workflow                             | Purpose                                                      |\n| :----------------------------------- | :----------------------------------------------------------- |\n| 📘`documentation_workflow.md`      | System documentation generation                              |\n| 🔁`refactor_workflow.md`           | Code quality improvement cycles                              |\n| 🏛️`workflow_governance_rules.md` | Supreme governance: arbitration, drift detection, escalation |\n\n---\n\n## 📂 Generated Project Structure\n\n```\nmy-project/\n├── 📊 PROJECT_STATE.md          ← Your project's single source of truth\n├── 🏷️ VERSION.md                ← Version + framework metadata\n├── 📄 README.md                 ← Project-level getting started guide\n├── 🔒 .gitignore\n├── 🔑 .env.example\n│\n├── 📚 01_Knowledge/             ← Reference docs, domain knowledge\n│\n├── 🤖 02_Skills/                ← Agent + workflow definitions (git-ignored)\n│   ├── agents/                  ← 14 agent persona files\n│   └── workflows/               ← 14 workflow files\n│\n├── 📄 03_Project_Info/          ← Agent output artifacts\n│   ├── Idea_Analyst/            ← IDEA.md goes here\n│   ├── Business_Analyst/        ← PRODUCT_ANALYSIS.md goes here\n│   ├── Product_Manager/         ← PRD.md goes here\n│   ├── Architect/               ← ARCHITECTURE.md goes here\n│   ├── Testing_Engineer/        ← TEST_REPORT.md goes here\n│   ├── Security_Engineer/       ← SECURITY_AUDIT.md goes here\n│   ├── Performance_Engineer/    ← PERFORMANCE_REPORT.md goes here\n│   └── DevOps_Engineer/         ← DEVOPS_PLAN.md goes here\n│\n├── 📋 04_Tasks/                 ← Task management\n│   ├── TASK_PLAN.md             ← Master task list\n│   ├── DEVELOPMENT_CHECKLIST.md ← Execution tracker\n│   ├── PROGRESS_LOG.md          ← Chronological completion log\n│   ├── RISK_REGISTER.md         ← Risk tracking\n│   ├── TASKS/                   ← Individual task files\n│   │   └── TEMPLATE_TASK.md     ← Task template\n│   └── ARCHIVE/                 ← Completed task archive\n│\n├── 💻 05_Project/               ← Your actual implementation code\n│   └── README.md\n│\n├── 📘 06_Documentation/         ← Generated system docs\n│\n└── 🧭 07_state/                 ← State tracking & decisions\n    ├── CHANGELOG.md             ← Version-by-version changes\n    ├── DECISIONS.md             ← Every significant decision\n    ├── ADR.md                   ← Architecture Decision Records\n    ├── KNOWN_ISSUES.md          ← Issue tracker\n    └── INCIDENT_LOG.md          ← Production incident log\n```\n\n---\n\n## 🎯 How to Use (Step by Step)\n\n### 1. Create Your Project\n\n```bash\nnpx @akm1923main/init-project my-project\ncd my-project\n```\n\n### 2. Check Your Starting Point\n\nOpen `PROJECT_STATE.md` — it shows you're at **Phase 01** with **Idea_Analyst** as the current agent.\n\n### 3. Activate the Current Agent\n\nTell your AI assistant to act as the **Idea_Analyst** agent. Point it to:\n\n- `02_Skills/agents/Idea_Analyst.md` — agent identity and rules\n- `02_Skills/workflows/idea_refinement_workflow.md` — the workflow to follow\n\n### 4. Work Through the Pipeline\n\nEach agent:\n\n1. Reads its upstream artifacts\n2. Follows its bound workflow (6 stages)\n3. Produces its output artifact\n4. Updates `PROJECT_STATE.md` and `PROGRESS_LOG.md`\n5. Hands off to the next agent\n\n### 5. Lost? Use the Helper Agent\n\nAt **any point**, activate the **🧭 Helper Agent** (`02_Skills/agents/Helper_Agent.md`). It will:\n\n- Read all your project state files\n- Tell you exactly where you are\n- Tell you what to do next\n- Flag any drift or skipped phases\n\n---\n\n## 📊 State Tracking System\n\nAI-OS tracks everything automatically:\n\n| File                                  | What It Tracks                                                |\n| :------------------------------------ | :------------------------------------------------------------ |\n| `PROJECT_STATE.md`                  | 📊 Current phase, agent, pipeline status, resume instructions |\n| `04_Tasks/PROGRESS_LOG.md`          | 📜 Chronological record of every phase completion             |\n| `04_Tasks/TASK_PLAN.md`             | 📋 All tasks with priority, complexity, dependencies          |\n| `04_Tasks/DEVELOPMENT_CHECKLIST.md` | ✅ Per-task completion tracker                                |\n| `04_Tasks/RISK_REGISTER.md`         | ⚠️ Project risks with severity classification               |\n| `07_state/CHANGELOG.md`             | 📜 Version-by-version change history                          |\n| `07_state/DECISIONS.md`             | 🧭 Every decision with phase/agent attribution                |\n| `07_state/ADR.md`                   | 🏛️ Immutable architecture decision records                  |\n| `07_state/KNOWN_ISSUES.md`          | 🐛 Issue tracker with severity levels                         |\n| `07_state/INCIDENT_LOG.md`          | 🚨 Production incident log with response protocol             |\n\n---\n\n## 🏗️ Architecture Principles\n\n| Principle                      | Implementation                                        |\n| :----------------------------- | :---------------------------------------------------- |\n| **Phase-Based Pipeline** | 11 sequential phases with strict ordering             |\n| **Agent Ownership**      | Each phase owned by exactly one specialist agent      |\n| **Artifact Contracts**   | Explicit input/output schemas between agents          |\n| **State Persistence**    | Evolution ledger tracks all progress across sessions  |\n| **Resume Safety**        | Any agent can resume from the last recorded state     |\n| **Drift Detection**      | Governance rules detect and flag inconsistencies      |\n| **Self-Validating**      | Each workflow verifies its own outputs before closing |\n\n---\n\n## ⚙️ How It Works Internally\n\n```mermaid\nflowchart LR\n    A[\"npx init-project my-app\"] --> B[\"Download from npm\"]\n    B --> C[\"Run index.js\"]\n    C --> D[\"Parse CLI args\"]\n    D --> E[\"Create folder structure\"]\n    E --> F[\"Copy 02_Skills\\nagents + workflows\"]\n    F --> G[\"Generate state files\\nPROJECT_STATE, VERSION, etc.\"]\n    G --> H[\"Project ready!\"]\n\n    style A fill:#f4a261,stroke:#e76f51,color:#000\n    style H fill:#2a9d8f,stroke:#264653,color:#fff\n```\n\n1. **`npx`** downloads the latest version from npm\n2. **`index.js`** parses arguments and creates the folder skeleton\n3. **Bundled templates** (`templates/02_Skills/`) are copied as-is — 14 agents, 14 workflows\n4. **Inline templates** generate all state tracking files with initial content\n5. **Zero dependencies** — pure Node.js, no npm packages required\n\n---\n\n## 🐍 Default: Python + uv\n\nThe generated project defaults to Python with [uv](https://github.com/astral-sh/uv) for package management:\n\n```bash\ncd 05_Project\nuv venv\nuv pip install <package>\n```\n\n> You can use any language or framework — just put your code in `05_Project/`.\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! If you have ideas for:\n\n- 🤖 New agent personas\n- 📋 New workflows\n- 🔧 Improvements to templates or scaffolding\n\nPlease open an issue or submit a pull request on our [GitHub repository](https://github.com/Akm1923/init-project).\n\n---\n\n## 📄 License\n\nMIT © [Amit Kumar Bind](https://github.com/Akm1923)\n\n---\n\n---\n\n**Built with ❤️ for AI-driven development**\n\n*AI-OS 14 agents · 14 workflows · 11 phases · Zero dependencies*\n","readmeFilename":"README.md","homepage":"https://github.com/akm1923main/init-project#readme","repository":{"type":"git","url":"git+https://github.com/akm1923main/init-project.git"},"author":{"name":"akm1923main","url":"https://github.com/akm1923main"},"bugs":{"url":"https://github.com/akm1923main/init-project/issues"}}