{"_id":"@alxyrgin/agent-forge","_rev":"5-373d0384c07e3fdd71577721626f8831","name":"@alxyrgin/agent-forge","dist-tags":{"latest":"3.3.0"},"versions":{"1.0.0":{"name":"@alxyrgin/agent-forge","version":"1.0.0","keywords":["claude","claude-code","ai","agents","memory-bank","development-framework","cli","scaffolding"],"author":{"name":"Aleksandr Yarygin"},"license":"MIT","_id":"@alxyrgin/agent-forge@1.0.0","maintainers":[{"name":"alxyrgin","email":"alxyrgin@gmail.com"}],"homepage":"https://github.com/alxyrgin/agent-forge#readme","bugs":{"url":"https://github.com/alxyrgin/agent-forge/issues"},"bin":{"agent-forge":"dist/index.js"},"dist":{"shasum":"48cd8ac6195c081dfe5e10dd8ec5465be643ca3e","tarball":"https://registry.npmjs.org/@alxyrgin/agent-forge/-/agent-forge-1.0.0.tgz","fileCount":38,"integrity":"sha512-HynKLibJO/+2Tm8PLFwPEe5z4S5UwCCXwwgIemE+ha+EYGNS2PuTPLHa1wtcxUAhvoXj8mV29oZV/kauLz1pMg==","signatures":[{"sig":"MEUCIHrlACQq8eOdvyF1Z8bL3So4WZCU6LaxIlzBCdNOPFGtAiEApW9yIwyXsL6X3+QZPV/4tt+B2dQo6aP+vQ8T+T197qo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":127110},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"d9b32d6e806ec1e2303601b87d57999cc092389d","scripts":{"dev":"tsup --watch","lint":"tsc --noEmit","test":"vitest run","build":"tsup","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"alxyrgin","email":"alxyrgin@gmail.com"},"repository":{"url":"git+https://github.com/alxyrgin/agent-forge.git","type":"git"},"_npmVersion":"10.9.2","description":"AI-driven Development Framework for Claude Code — scaffold Memory Bank, agents, skills, and rules in any project","directories":{},"_nodeVersion":"22.14.0","dependencies":{"ejs":"^3.1.10","ora":"^8.1.0","chalk":"^5.3.0","fs-extra":"^11.2.0","inquirer":"^9.3.0","commander":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.2.0","vitest":"^2.0.0","@types/ejs":"^3.1.5","typescript":"^5.5.0","@types/node":"^20.14.0","@types/fs-extra":"^11.0.4","@types/inquirer":"^9.0.7"},"_npmOperationalInternal":{"tmp":"tmp/agent-forge_1.0.0_1772355322981_0.2599855230633539","host":"s3://npm-registry-packages-npm-production"}},"3.0.0":{"name":"@alxyrgin/agent-forge","version":"3.0.0","keywords":["claude","claude-code","ai","agents","memory-bank","development-framework","cli","scaffolding","checkpoint","feature-routing","hooks","quality-gates","tdd","inspector"],"author":{"name":"Aleksandr Yarygin"},"license":"MIT","_id":"@alxyrgin/agent-forge@3.0.0","maintainers":[{"name":"alxyrgin","email":"alxyrgin@gmail.com"}],"homepage":"https://github.com/alxyrgin/agent-forge#readme","bugs":{"url":"https://github.com/alxyrgin/agent-forge/issues"},"bin":{"agent-forge":"dist/index.js"},"dist":{"shasum":"09e791a5cbd98a489e8281ec38663c453eaac718","tarball":"https://registry.npmjs.org/@alxyrgin/agent-forge/-/agent-forge-3.0.0.tgz","fileCount":68,"integrity":"sha512-6heYZz+t+aOTT+n8AwIO5uy9NqyjntU2tgr9Id7cyhdJylUarwuJpZVr+bZUANAhk1hGIJLqL2S5c/qR0gA1sQ==","signatures":[{"sig":"MEUCIQDMPKrP867B2PQpAWlyt5zoX//R2pF/CakwlinrOMLKnAIgWco6RZBRpkNyXx7gUB+j8a5HDGpJbTgwTmdI+rHkzPw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":292277},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"e86f72a4e3262bf66bd14ee10e70ef1a363ab745","scripts":{"dev":"tsup --watch","lint":"tsc --noEmit","test":"vitest run","build":"tsup","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"alxyrgin","email":"alxyrgin@gmail.com"},"repository":{"url":"git+https://github.com/alxyrgin/agent-forge.git","type":"git"},"_npmVersion":"10.9.2","description":"AI-driven Development Framework for Claude Code — scaffold Memory Bank, agents, skills, and rules in any project","directories":{},"_nodeVersion":"22.14.0","dependencies":{"ejs":"^3.1.10","ora":"^8.1.0","chalk":"^5.3.0","fs-extra":"^11.2.0","inquirer":"^9.3.0","commander":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.2.0","vitest":"^2.0.0","@types/ejs":"^3.1.5","typescript":"^5.5.0","@types/node":"^20.14.0","@types/fs-extra":"^11.0.4","@types/inquirer":"^9.0.7"},"_npmOperationalInternal":{"tmp":"tmp/agent-forge_3.0.0_1773481673593_0.15791058220308773","host":"s3://npm-registry-packages-npm-production"}},"3.1.0":{"name":"@alxyrgin/agent-forge","version":"3.1.0","keywords":["claude","claude-code","ai","agents","memory-bank","development-framework","cli","scaffolding","checkpoint","feature-routing","hooks","quality-gates","tdd","inspector"],"author":{"name":"Aleksandr Yarygin"},"license":"MIT","_id":"@alxyrgin/agent-forge@3.1.0","maintainers":[{"name":"alxyrgin","email":"alxyrgin@gmail.com"}],"homepage":"https://github.com/alxyrgin/agent-forge#readme","bugs":{"url":"https://github.com/alxyrgin/agent-forge/issues"},"bin":{"agent-forge":"dist/index.js"},"dist":{"shasum":"d441f1219a3d4e699da465dd5c33efc74531a998","tarball":"https://registry.npmjs.org/@alxyrgin/agent-forge/-/agent-forge-3.1.0.tgz","fileCount":68,"integrity":"sha512-MA6927AVJ5Q9Zup02dWMaVDjvv0Zv7lXNuyJl2gikfpLWQoTqboxLFx2P8fBQqR5S9mlzvxrHnksyXWeH3VQag==","signatures":[{"sig":"MEUCIFX+TiSeUSdvnnLOOKj7ZOb+v4oxU2Qp/k7Q/q361SNaAiEApwEiXC6WrMgZg94eSn2/NDMnSR4y9mMCrujM9IjK7I8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":316680},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"2748505e82fd401b0605362525ae8da4875af096","scripts":{"dev":"tsup --watch","lint":"tsc --noEmit","test":"vitest run","build":"tsup","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"alxyrgin","email":"alxyrgin@gmail.com"},"repository":{"url":"git+https://github.com/alxyrgin/agent-forge.git","type":"git"},"_npmVersion":"10.9.2","description":"AI-driven Development Framework for Claude Code — scaffold Memory Bank, agents, skills, and rules in any project","directories":{},"_nodeVersion":"22.14.0","dependencies":{"ejs":"^3.1.10","ora":"^8.1.0","chalk":"^5.3.0","fs-extra":"^11.2.0","inquirer":"^9.3.0","commander":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.2.0","vitest":"^2.0.0","@types/ejs":"^3.1.5","typescript":"^5.5.0","@types/node":"^20.14.0","@types/fs-extra":"^11.0.4","@types/inquirer":"^9.0.7"},"_npmOperationalInternal":{"tmp":"tmp/agent-forge_3.1.0_1773482876804_0.7152878088847885","host":"s3://npm-registry-packages-npm-production"}},"3.2.0":{"name":"@alxyrgin/agent-forge","version":"3.2.0","keywords":["claude","claude-code","ai","agents","memory-bank","development-framework","cli","scaffolding","checkpoint","feature-routing","hooks","quality-gates","tdd","inspector"],"author":{"name":"Aleksandr Yarygin"},"license":"MIT","_id":"@alxyrgin/agent-forge@3.2.0","maintainers":[{"name":"alxyrgin","email":"alxyrgin@gmail.com"}],"homepage":"https://github.com/alxyrgin/agent-forge#readme","bugs":{"url":"https://github.com/alxyrgin/agent-forge/issues"},"bin":{"agent-forge":"dist/index.js"},"dist":{"shasum":"dbe8c8d0ea0a83f0402c834d5a634f2854d4435c","tarball":"https://registry.npmjs.org/@alxyrgin/agent-forge/-/agent-forge-3.2.0.tgz","fileCount":71,"integrity":"sha512-ezDD0A+UVy+12gj3rvsK25Rei0cA177Y5mcAC4E4ubQzStZUB3ezh4nF51K/cTulF0a+8EH1nn4wqUVYw24RWA==","signatures":[{"sig":"MEQCIHTAlpvRECDqrQezHQmUCRcYpEiuaE3ZaSSf+cfoi3d9AiASQZA45y01QE1PRlssDRdslrLRMaTBSJ+iUJYWnm8gHg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":337279},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"8e25eefefb3084f251c9ee3ab626f7a577e14e76","scripts":{"dev":"tsup --watch","lint":"tsc --noEmit","test":"vitest run","build":"tsup","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"alxyrgin","email":"alxyrgin@gmail.com"},"repository":{"url":"git+https://github.com/alxyrgin/agent-forge.git","type":"git"},"_npmVersion":"10.9.2","description":"AI-driven Development Framework for Claude Code — scaffold Memory Bank, agents, skills, and rules in any project","directories":{},"_nodeVersion":"22.14.0","dependencies":{"ejs":"^3.1.10","ora":"^8.1.0","chalk":"^5.3.0","fs-extra":"^11.2.0","inquirer":"^9.3.0","commander":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.2.0","vitest":"^2.0.0","@types/ejs":"^3.1.5","typescript":"^5.5.0","@types/node":"^20.14.0","@types/fs-extra":"^11.0.4","@types/inquirer":"^9.0.7"},"_npmOperationalInternal":{"tmp":"tmp/agent-forge_3.2.0_1773828078000_0.984874682140388","host":"s3://npm-registry-packages-npm-production"}},"3.3.0":{"name":"@alxyrgin/agent-forge","version":"3.3.0","description":"AI-driven Development Framework for Claude Code — scaffold Memory Bank, agents, skills, and rules in any project","homepage":"https://github.com/alxyrgin/agent-forge#readme","bugs":{"url":"https://github.com/alxyrgin/agent-forge/issues"},"type":"module","main":"dist/index.js","types":"dist/index.d.ts","bin":{"agent-forge":"dist/index.js"},"scripts":{"build":"tsup","dev":"tsup --watch","test":"vitest run","test:watch":"vitest","lint":"tsc --noEmit","prepublishOnly":"npm run build"},"keywords":["claude","claude-code","ai","agents","memory-bank","development-framework","cli","scaffolding","checkpoint","feature-routing","hooks","quality-gates","tdd","inspector"],"author":{"name":"Aleksandr Yarygin"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/alxyrgin/agent-forge.git"},"engines":{"node":">=18.0.0"},"dependencies":{"chalk":"^5.3.0","commander":"^12.1.0","ejs":"^3.1.10","fs-extra":"^11.2.0","inquirer":"^9.3.0","ora":"^8.1.0"},"devDependencies":{"@types/ejs":"^3.1.5","@types/fs-extra":"^11.0.4","@types/inquirer":"^9.0.7","@types/node":"^20.14.0","tsup":"^8.2.0","typescript":"^5.5.0","vitest":"^2.0.0"},"_id":"@alxyrgin/agent-forge@3.3.0","gitHead":"3417c4791dee825de6d32dd0b1f1459006fa4b9e","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-RMcFQ0KMWsnMlQv1vojzWfsMsFyY97DMm5kQjuIML29BJq1h3rOi/JSzHEgChefNLndr7Y6ppqH3u98kn4akFA==","shasum":"269026d9be6054298e52f4f75dc4b9a97f5fa4c6","tarball":"https://registry.npmjs.org/@alxyrgin/agent-forge/-/agent-forge-3.3.0.tgz","fileCount":71,"unpackedSize":337279,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD6XuyDtgJsAMsLMNyLRjklB9Fy1KtIf8tB9H6LZicXrQIhALe2mzBXO+FuOQg19OwdMvVT59y8c/TtoEUiJEUM01md"}]},"_npmUser":{"name":"alxyrgin","email":"alxyrgin@gmail.com"},"directories":{},"maintainers":[{"name":"alxyrgin","email":"alxyrgin@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent-forge_3.3.0_1773928337600_0.36381336419572086"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-01T08:55:22.908Z","modified":"2026-03-19T13:52:17.881Z","1.0.0":"2026-03-01T08:55:23.121Z","3.0.0":"2026-03-14T09:47:53.780Z","3.1.0":"2026-03-14T10:07:56.965Z","3.2.0":"2026-03-18T10:01:18.224Z","3.3.0":"2026-03-19T13:52:17.769Z"},"bugs":{"url":"https://github.com/alxyrgin/agent-forge/issues"},"author":{"name":"Aleksandr Yarygin"},"license":"MIT","homepage":"https://github.com/alxyrgin/agent-forge#readme","keywords":["claude","claude-code","ai","agents","memory-bank","development-framework","cli","scaffolding","checkpoint","feature-routing","hooks","quality-gates","tdd","inspector"],"repository":{"type":"git","url":"git+https://github.com/alxyrgin/agent-forge.git"},"description":"AI-driven Development Framework for Claude Code — scaffold Memory Bank, agents, skills, and rules in any project","maintainers":[{"name":"alxyrgin","email":"alxyrgin@gmail.com"}],"readme":"# agent-forge\n\nAI-driven Development Framework for Claude Code. Generates a complete development infrastructure with 20 specialized agents, quality gates, and TDD pipelines.\n\n[![npm version](https://img.shields.io/npm/v/@alxyrgin/agent-forge.svg)](https://www.npmjs.com/package/@alxyrgin/agent-forge)\n[![license](https://img.shields.io/npm/l/@alxyrgin/agent-forge.svg)](https://github.com/alxyrgin/agent-forge/blob/main/LICENSE)\n[![node](https://img.shields.io/node/v/@alxyrgin/agent-forge.svg)](https://nodejs.org)\n\n## Quick Start\n\n```bash\nnpx @alxyrgin/agent-forge init\n```\n\nThe interactive wizard asks for your project name, tech stack, team, and agent preset — then scaffolds the entire AI infrastructure in seconds. Start working immediately with `/start-session`.\n\n```bash\nnpx @alxyrgin/agent-forge init --yes   # non-interactive, use defaults\n```\n\n## What Gets Generated\n\n| Directory | Contents |\n|-----------|----------|\n| `.claude/CLAUDE.md` | Team Lead instructions — the orchestrator prompt |\n| `.claude/agents/` | 5–20 specialized agents across 4 categories |\n| `.claude/skills/` | 10–21 slash commands for development workflows |\n| `.claude/rules/` | 8 development standards enforced automatically |\n| `.claude/hooks/` | Git/tool hooks (protect-docs, stop hook) |\n| `dev-infra/memory/` | 9 Memory Bank files for persistent context |\n| `dev-infra/tasks/` | Task tracking system (`tasks.json`) |\n| `dev-infra/sessions/` | Session logs |\n| `dev-infra/tests/` | Test structure (acceptance criteria, PMI scenarios, results) |\n\n## Architecture\n\nThe Team Lead (defined in `CLAUDE.md`) orchestrates four categories of specialized agents:\n\n```mermaid\ngraph TD\n    subgraph \"Orchestrator\"\n        TL[\"Team Lead<br/>(CLAUDE.md)\"]\n    end\n\n    subgraph \"Pipeline — 8 agents\"\n        analyst[\"analyst\"]\n        architect[\"architect\"]\n        skeptic[\"skeptic\"]\n        developer[\"developer\"]\n        tester[\"tester\"]\n        inspector[\"inspector\"]\n        reviewer[\"reviewer\"]\n        planner[\"planner\"]\n    end\n\n    subgraph \"Planning — 4 agents\"\n        researcher[\"researcher\"]\n        interviewer[\"interviewer\"]\n        validator[\"validator\"]\n        decomposer[\"decomposer\"]\n    end\n\n    subgraph \"Security — 4 agents\"\n        auditor[\"auditor\"]\n        prompter[\"prompter\"]\n        deployer[\"deployer\"]\n        scaffolder[\"scaffolder\"]\n    end\n\n    subgraph \"Documentation — 4 agents\"\n        librarian[\"librarian\"]\n        writer[\"writer\"]\n        gatekeeper[\"gatekeeper\"]\n        verifier[\"verifier\"]\n    end\n\n    TL --> analyst\n    TL --> researcher\n    TL --> auditor\n    TL --> librarian\n\n    analyst --> architect --> skeptic\n    developer <--> tester\n    tester --> inspector --> reviewer\n```\n\nEach agent has a defined role, a set of allowed tools, a model assignment, and structured JSON output with verdicts. The Team Lead reads each verdict and routes the pipeline accordingly.\n\n## Pipelines\n\nEvery task is classified by size — **S**, **M**, or **L** — and routed through the appropriate pipeline. Larger tasks get more validation steps.\n\n### S-Pipeline. Small tasks (1 file, < 50 lines)\n\n```mermaid\ngraph LR\n    S1[\"checkpoint\"] --> S2[\"developer\"] --> S3[\"tester +<br/>inspector\"] --> S4[\"quick-review\"] --> S5[\"tech-debt\"] --> S6[\"fixation\"]\n\n    style S1 fill:#f0f0f0,stroke:#999\n    style S6 fill:#f0f0f0,stroke:#999\n```\n\n### M-Pipeline. Medium tasks (2–5 files, new module)\n\n```mermaid\ngraph LR\n    M1[\"checkpoint\"] --> M2[\"analyst\"] --> M3[\"TDD RED\"] --> M4[\"developer ↔<br/>tester +<br/>inspector\"] --> M5[\"quality<br/>gates\"] --> M6[\"reviewer\"] --> M7[\"tech-debt\"] --> M8[\"fixation\"]\n\n    style M1 fill:#f0f0f0,stroke:#999\n    style M8 fill:#f0f0f0,stroke:#999\n```\n\n### L-Pipeline. Large tasks (6+ files, architecture changes)\n\n```mermaid\ngraph LR\n    L1[\"checkpoint\"] --> L2[\"analyst\"] --> L3[\"architect +<br/>reviewer<br/>(plan)\"] --> L4[\"skeptic\"] --> L5[\"TDD RED\"] --> L6[\"developer ↔<br/>tester +<br/>inspector\"] --> L7[\"quality<br/>gates\"] --> L8[\"reviewer\"] --> L9[\"tech-debt\"] --> L10[\"fixation\"]\n\n    style L1 fill:#f0f0f0,stroke:#999\n    style L10 fill:#f0f0f0,stroke:#999\n```\n\nKey pipeline features:\n- **TDD RED phase** (M/L) — tester writes failing tests *before* developer writes code\n- **Per-feature loops** (L) — developer and tester iterate on each feature independently\n- **Inspector gate** — validates test quality after tester, before reviewer\n- **Multi-round review** — reviewer runs up to 3 rounds; CRITICAL/HIGH issues go back to developer\n- **Tech-debt is mandatory** for all sizes — never skipped\n\n## Agent Presets\n\nThree presets control how many agents are scaffolded:\n\n| Preset | Agents | Skills | Best for |\n|--------|--------|--------|----------|\n| **minimal** | 5 | 10 | Solo developer, small projects |\n| **core** (default) | 8 | 10 | Teams, production projects |\n| **full** | 20 | 21 | Complex systems, enterprise |\n\n### Preset coverage\n\n| Agent | minimal | core | full |\n|-------|:-------:|:----:|:----:|\n| analyst | x | x | x |\n| architect | | x | x |\n| skeptic | | x | x |\n| developer | x | x | x |\n| tester | x | x | x |\n| inspector | x | x | x |\n| reviewer | x | x | x |\n| planner | | x | x |\n| researcher | | | x |\n| interviewer | | | x |\n| validator | | | x |\n| decomposer | | | x |\n| auditor | | | x |\n| prompter | | | x |\n| deployer | | | x |\n| scaffolder | | | x |\n| librarian | | | x |\n| writer | | | x |\n| gatekeeper | | | x |\n| verifier | | | x |\n\n## Agents\n\n### Pipeline (8 agents)\n\nCore development cycle — from analysis to code review.\n\n| Agent | Description | Verdicts |\n|-------|-------------|----------|\n| **analyst** | Analyzes task requirements from documentation, extracts acceptance criteria and PMI scenarios | `COMPLETE`, `NEEDS_DISCOVERY` |\n| **architect** | Designs module architecture — structure, API contracts, data schemas | `READY`, `NEEDS_INPUT` |\n| **skeptic** | Reality checker — verifies plans against actual codebase, finds \"mirages\" (non-existent files, APIs, modules) | `PASS`, `PASS_WITH_WARNINGS`, `FAIL` |\n| **developer** | Writes code following project patterns, makes failing TDD tests green | `DONE`, `BLOCKED` |\n| **tester** | Parametric testing agent — unit, integration, acceptance, smoke. Supports TDD mode | `PASS`, `FAIL` |\n| **inspector** | Validates test quality — coverage, naming, assertions, mocking, isolation, edge cases | `APPROVE`, `REQUEST_CHANGES` |\n| **reviewer** | Code review with iterations and escalation. Modes: default, plan_review, quick | `APPROVE`, `REQUEST_CHANGES`, `ESCALATE` |\n| **planner** | Project-level planning — milestones, tasks, dependencies, completeness validation | `VALID`, `ISSUES_FOUND` |\n\n### Planning (4 agents)\n\nDeep analysis and task decomposition. Available in the **full** preset.\n\n| Agent | Description |\n|-------|-------------|\n| **researcher** | Codebase exploration — entry points, patterns, dependencies, integrations |\n| **interviewer** | Structured discovery interview — 3 cycles (general, code-informed, edge cases) |\n| **validator** | Specification validation — 4 modes: userspec, techspec, task, completeness |\n| **decomposer** | Task decomposition — generates atomic tasks with TDD anchors, acceptance criteria, and verify steps |\n\n### Security (4 agents)\n\nSecurity audits and infrastructure review. Available in the **full** preset.\n\n| Agent | Description |\n|-------|-------------|\n| **auditor** | Security analysis — OWASP Top 10, hardcoded secrets, threat modeling, access control |\n| **prompter** | LLM prompt review — clarity, few-shot quality, output format, injection safety, token efficiency |\n| **deployer** | CI/CD review — workflow correctness, secrets management, platform config, deploy scripts |\n| **scaffolder** | Project infrastructure review — structure, Docker, pre-commit hooks, .gitignore, dependency management |\n\n### Documentation (4 agents)\n\nDocumentation quality and deployment validation. Available in the **full** preset.\n\n| Agent | Description |\n|-------|-------------|\n| **librarian** | Documentation review — completeness, freshness, absence of bloat, consistency |\n| **writer** | Generates stakeholder-facing reports and internal documentation |\n| **gatekeeper** | Pre-deploy QA — runs tests, verifies acceptance criteria, checks deferred criteria |\n| **verifier** | Post-deploy QA — live environment verification, manual verification plans |\n\n## Skills (Slash Commands)\n\n### Core skills (all presets) — 10 commands\n\n| Command | Description |\n|---------|-------------|\n| `/start-session` | Begin work — sync repo, check checkpoint, load context, show progress |\n| `/end-session` | Save context, checkpoint, create session log, commit and push |\n| `/take-task [id]` | Full development cycle with feature-size routing (S/M/L) |\n| `/complete-task [id]` | Verify task, smoke test, update progress, clear checkpoint |\n| `/status` | Show project status, deadlines, blockers |\n| `/plan [mode]` | Plan, replan, or validate tasks from documentation |\n| `/review [file]` | Code review for a file or task |\n| `/code [task]` | Direct code generation for a specific task |\n| `/test [target]` | Run or generate tests for a target |\n| `/done [id]` | Quick-complete a task with minimal ceremony |\n\n### Extra skills (full preset only) — 11 commands\n\n| Command | Description |\n|---------|-------------|\n| `/interview` | Structured discovery interview (3 cycles, completeness >= 85%) |\n| `/audit-wave` | Comprehensive pre-milestone audit with GO/NO-GO verdict |\n| `/write-report` | Generate non-technical progress report for stakeholders |\n| `/dashboard` | Project dashboard — progress, health, tech debt, activity |\n| `/skill-master [name]` | Create a new custom skill from template |\n| `/decompose [task]` | Break down a task into subtasks with TDD anchors |\n| `/feature [name]` | Scaffold a new feature end-to-end |\n| `/security [target]` | Run security analysis on a target |\n| `/spec [feature]` | Generate specification for a feature |\n| `/techspec [module]` | Generate technical specification for a module |\n| `/prompts [agent]` | Manage and optimize agent prompts |\n\n## Rules\n\n8 development standards that are loaded automatically and enforced across all agents:\n\n| Rule | Purpose |\n|------|---------|\n| `commit-conventions` | Commit message format — `[type](scope): description` |\n| `development-cycle` | Feature-size routing (S/M/L) and pipeline step definitions |\n| `testing-standards` | Test coverage >= 80%, edge cases, access control testing |\n| `shared-resources` | Singleton resource registry — no duplicate DB connections or API clients |\n| `context-loading` | Just-in-time context loading — pass data, not file references |\n| `agent-output-format` | JSON output standard for all agents with structured verdicts |\n| `quality-gates` | Verdict-based routing between pipeline steps |\n| `rollback-protocol` | Rollback procedures for failed deployments |\n\n## Quality Gates\n\nEvery agent returns a structured verdict. The Team Lead reads the verdict and routes the pipeline:\n\n```mermaid\ngraph TD\n    A[\"Agent returns verdict\"] --> B{\"Verdict type?\"}\n    B -->|\"PASS / APPROVE / DONE\"| C[\"Continue pipeline\"]\n    B -->|\"WARNINGS / ATTENTION\"| D[\"Show to user,<br/>continue\"]\n    B -->|\"FAIL / BLOCKED\"| E{\"Retry count < 3?\"}\n    E -->|\"Yes\"| F[\"Return to<br/>previous step\"]\n    E -->|\"No\"| G[\"Escalate to user\"]\n    F --> A\n\n    style C fill:#d4edda,stroke:#28a745\n    style D fill:#fff3cd,stroke:#ffc107\n    style G fill:#f8d7da,stroke:#dc3545\n```\n\n### Verdict matrix\n\n```mermaid\ngraph LR\n    subgraph \"Analysis\"\n        A1[\"analyst\"] -->|COMPLETE| A2[\"architect\"]\n        A1 -->|NEEDS_DISCOVERY| A3[\"ask user\"]\n        A3 --> A1\n    end\n\n    subgraph \"Architecture\"\n        A2 -->|READY| SK[\"skeptic\"]\n        A2 -->|NEEDS_INPUT| A4[\"ask user\"]\n        A4 --> A2\n    end\n\n    subgraph \"Reality Check\"\n        SK -->|PASS| DEV[\"developer\"]\n        SK -->|FAIL| A2\n    end\n\n    subgraph \"Code + Tests\"\n        DEV -->|DONE| TST[\"tester\"]\n        TST -->|PASS| INS[\"inspector\"]\n        TST -->|FAIL| DEV\n        INS -->|APPROVE| REV[\"reviewer\"]\n        INS -->|REQUEST_CHANGES| TST\n    end\n\n    subgraph \"Review\"\n        REV -->|APPROVE| FIN[\"finalize\"]\n        REV -->|REQUEST_CHANGES| DEV\n    end\n\n    style FIN fill:#d4edda,stroke:#28a745\n```\n\n## CLI Commands\n\n### `agent-forge init`\n\nInitialize AI-driven development infrastructure in the current directory.\n\n```bash\nnpx @alxyrgin/agent-forge init           # interactive setup\nnpx @alxyrgin/agent-forge init --yes     # use defaults (TypeScript, core preset)\nnpx @alxyrgin/agent-forge init --overwrite  # overwrite existing files\n```\n\nThe wizard prompts for:\n- Project name and description\n- Technology stack (Python / TypeScript / Go / Rust)\n- Framework and test framework\n- Team members (names, roles, emails)\n- Milestones (optional)\n- Agent preset (minimal / core / full)\n- Commit style (standard / conventional)\n\n### `agent-forge update`\n\nUpdate framework files while preserving your data.\n\n```bash\nnpx @alxyrgin/agent-forge update\n```\n\n**Overwritten** (updated to latest version):\n- `.claude/CLAUDE.md`\n- `.claude/agents/*`\n- `.claude/skills/*`\n- `.claude/rules/*`\n- `.claude/hooks/*`\n- `.claude/settings.json`\n\n**Preserved** (your data stays intact):\n- `dev-infra/memory/*` — your Memory Bank\n- `dev-infra/tasks/*` — your task tracking\n- `dev-infra/sessions/*` — your session logs\n- `dev-infra/tests/*` — your test structure\n\n### `agent-forge doctor`\n\nCheck integrity of the generated structure. Verifies that all expected files exist and are not empty.\n\n```bash\nnpx @alxyrgin/agent-forge doctor\n```\n\n## Memory Bank\n\n9 files that persist context across sessions. The Team Lead reads and updates these automatically.\n\n| File | Purpose |\n|------|---------|\n| `active-context.md` | Current session state — what is done, what is next |\n| `progress.md` | Milestone progress, task statuses |\n| `project-brief.md` | Project overview, team, stack |\n| `decisions.md` | Architectural Decision Records (ADR) |\n| `tech-stack.md` | Technology stack details |\n| `tech-debt.md` | Technical debt registry with lifecycle tracking (open / in_progress / resolved) |\n| `patterns.md` | Code patterns and conventions |\n| `troubleshooting.md` | Problem solutions log |\n| `checkpoint.yml` | Recovery checkpoint for interrupted sessions |\n\n### Checkpoint System\n\nThe checkpoint (`dev-infra/memory/checkpoint.yml`) enables recovery after session interruptions:\n\n- **Automatic saving** — updated after each pipeline step\n- **Recovery on start** — `/start-session` detects an active checkpoint and offers to resume\n- **Cleanup on completion** — `/complete-task` clears the checkpoint\n\n```mermaid\ngraph LR\n    A[\"Session interrupted\"] --> B[\"checkpoint.yml<br/>saved automatically\"]\n    B --> C[\"Next session:<br/>/start-session\"]\n    C --> D{\"Active<br/>checkpoint?\"}\n    D -->|\"Yes\"| E[\"Offer to resume<br/>from last step\"]\n    D -->|\"No\"| F[\"Fresh start\"]\n\n    style B fill:#fff3cd,stroke:#ffc107\n    style E fill:#d4edda,stroke:#28a745\n```\n\n## Generated Structure\n\n```\nyour-project/\n├── .claude/\n│   ├── CLAUDE.md                  # Team Lead instructions\n│   ├── settings.json              # Claude Code hooks and env\n│   ├── hooks/\n│   │   └── protect-docs.sh        # PreToolUse hook — blocks edits in docs/\n│   ├── agents/\n│   │   ├── pipeline/              # analyst, architect, skeptic, developer,\n│   │   │                          # tester, inspector, reviewer, planner\n│   │   ├── planning/              # researcher, validator, interviewer, decomposer\n│   │   ├── security/              # auditor, prompter, deployer, scaffolder\n│   │   └── documentation/         # librarian, writer, gatekeeper, verifier\n│   ├── skills/\n│   │   ├── start-session/SKILL.md\n│   │   ├── take-task/SKILL.md\n│   │   ├── code/SKILL.md\n│   │   ├── test/SKILL.md\n│   │   └── ...                    # 10–21 slash commands\n│   └── rules/\n│       ├── commit-conventions.md\n│       ├── development-cycle.md\n│       ├── testing-standards.md\n│       ├── shared-resources.md\n│       ├── context-loading.md\n│       ├── agent-output-format.md\n│       ├── quality-gates.md\n│       └── rollback-protocol.md\n├── dev-infra/\n│   ├── memory/                    # 9 Memory Bank files\n│   │   ├── active-context.md\n│   │   ├── progress.md\n│   │   ├── checkpoint.yml\n│   │   └── ...\n│   ├── tasks/\n│   │   └── tasks.json             # Task tracking\n│   ├── sessions/                  # Session logs\n│   └── tests/\n│       ├── acceptance/            # Acceptance criteria\n│       ├── pmi/                   # PMI scenarios\n│       └── results/               # Test results\n└── .claude-forge.json             # Manifest for doctor and update\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}