{"_id":"@build-fractal/orchestrator","_rev":"10-5bb686b3bc4d8c689f41c1813175a869","name":"@build-fractal/orchestrator","dist-tags":{"latest":"0.10.3"},"versions":{"0.9.3":{"name":"@build-fractal/orchestrator","version":"0.9.3","keywords":["orchestrator","claude-code","codex","cursor","ai-coding","autonomous-agents","spec-driven-development"],"author":{"name":"Build-Fractal"},"license":"MIT","_id":"@build-fractal/orchestrator@0.9.3","maintainers":[{"name":"bkellgren","email":"bkellgren@gmail.com"}],"homepage":"https://github.com/Build-Fractal/orchestrator","bugs":{"url":"https://github.com/Build-Fractal/orchestrator/issues"},"os":["darwin","linux"],"bin":{"orchestrator":"bin/orchestrator"},"dist":{"shasum":"58c7eece213ace1a552017bdc5af4aa89ccdca40","tarball":"https://registry.npmjs.org/@build-fractal/orchestrator/-/orchestrator-0.9.3.tgz","fileCount":525,"integrity":"sha512-Dfz49zAkHyNL3tp+gw61hnJqwm+PesgmW5IF/9lRqc82UAxsgNVxnZBEr5XNPk1BSXyD+QrFRIJtEJ+P4k8NOA==","signatures":[{"sig":"MEQCIB0cD6Jk5LAcJilV6BEhiiI0l6xoTb9Qxx/wtKo4QUeeAiAL8GnehKyFN8LJSJbWglCQTA3X1EY08JKoyriMmNZQGw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4196837},"engines":{"node":">=14"},"gitHead":"fcfee47b2f491a37b2a00eb1488c41cee3cfe22d","scripts":{"postinstall":"bash packaging/npm/postinstall.sh"},"_npmUser":{"name":"bkellgren","email":"bkellgren@gmail.com"},"repository":{"url":"git+https://github.com/Build-Fractal/orchestrator.git","type":"git"},"_npmVersion":"10.8.2","description":"Autonomous multi-phase orchestration skills for Claude Code, Codex, and Cursor","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/orchestrator_0.9.3_1780458323495_0.6520188356603573","host":"s3://npm-registry-packages-npm-production"}},"0.9.4":{"name":"@build-fractal/orchestrator","version":"0.9.4","keywords":["orchestrator","claude-code","codex","cursor","ai-coding","autonomous-agents","spec-driven-development"],"author":{"name":"Build-Fractal"},"license":"MIT","_id":"@build-fractal/orchestrator@0.9.4","maintainers":[{"name":"bkellgren","email":"bkellgren@gmail.com"}],"homepage":"https://github.com/Build-Fractal/orchestrator","bugs":{"url":"https://github.com/Build-Fractal/orchestrator/issues"},"os":["darwin","linux"],"bin":{"orchestrator":"bin/orchestrator"},"dist":{"shasum":"e85c0cccbdd453c2027fe32706439212645db33c","tarball":"https://registry.npmjs.org/@build-fractal/orchestrator/-/orchestrator-0.9.4.tgz","fileCount":525,"integrity":"sha512-KfW+VcOD/2oUVYu5P8xYIOT9+K8xCzygXpej8/iklhuoWLNdGf7XYbswp2owO1fuIDWcqOdI6YbU9VeRp2vfgw==","signatures":[{"sig":"MEQCIG7NM/qlGi+4D6twg2tWehwhCQO2zkzEszXVOdbAGPPTAiBEmwUNULX877iM1R8KJkMvhKWWhD0EmaOylKaB7jWBfw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4198335},"engines":{"node":">=14"},"gitHead":"518209e9132cec8a4daed341c432f4add232a59f","scripts":{"postinstall":"bash packaging/npm/postinstall.sh"},"_npmUser":{"name":"bkellgren","email":"bkellgren@gmail.com"},"repository":{"url":"git+https://github.com/Build-Fractal/orchestrator.git","type":"git"},"_npmVersion":"10.8.2","description":"Autonomous multi-phase orchestration skills for Claude Code, Codex, and Cursor","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/orchestrator_0.9.4_1780458972632_0.8375453658822021","host":"s3://npm-registry-packages-npm-production"}},"0.9.5":{"name":"@build-fractal/orchestrator","version":"0.9.5","keywords":["orchestrator","claude-code","codex","cursor","ai-coding","autonomous-agents","spec-driven-development"],"author":{"name":"Build-Fractal"},"license":"MIT","_id":"@build-fractal/orchestrator@0.9.5","maintainers":[{"name":"bkellgren","email":"bkellgren@gmail.com"}],"homepage":"https://github.com/Build-Fractal/orchestrator","bugs":{"url":"https://github.com/Build-Fractal/orchestrator/issues"},"os":["darwin","linux"],"bin":{"orchestrator":"bin/orchestrator"},"dist":{"shasum":"ef884f7aaa2d516b31d081d256d6585d402c5e70","tarball":"https://registry.npmjs.org/@build-fractal/orchestrator/-/orchestrator-0.9.5.tgz","fileCount":525,"integrity":"sha512-BhxHRkQN4FDuuqRmcAuyjh6NgnWyKjl9hcxL/AroYjvPYT6nUlMN8KdUVd3pg4ZVdouN/kIir2WCPKlpTZM8kg==","signatures":[{"sig":"MEYCIQDXlnhaYBaQJag22dkc+CelrG3aUPITDBNicZJzP9Uf8AIhAOhD9nVo7DyPUPADHE9z3JGgt7WCVrmmw+bM1TX9y0Qz","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4202886},"engines":{"node":">=14"},"gitHead":"4b2c95d0b8ee1dd7f1c3ec8197f51db0b05e3476","scripts":{"postinstall":"bash packaging/npm/postinstall.sh"},"_npmUser":{"name":"bkellgren","email":"bkellgren@gmail.com"},"repository":{"url":"git+https://github.com/Build-Fractal/orchestrator.git","type":"git"},"_npmVersion":"10.8.2","description":"Autonomous multi-phase orchestration skills for Claude Code, Codex, and Cursor","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/orchestrator_0.9.5_1780498352977_0.3247046818649413","host":"s3://npm-registry-packages-npm-production"}},"0.9.6":{"name":"@build-fractal/orchestrator","version":"0.9.6","keywords":["orchestrator","claude-code","codex","cursor","ai-coding","autonomous-agents","spec-driven-development"],"author":{"name":"Build-Fractal"},"license":"MIT","_id":"@build-fractal/orchestrator@0.9.6","maintainers":[{"name":"bkellgren","email":"bkellgren@gmail.com"}],"homepage":"https://github.com/Build-Fractal/orchestrator","bugs":{"url":"https://github.com/Build-Fractal/orchestrator/issues"},"os":["darwin","linux"],"bin":{"orchestrator":"bin/orchestrator"},"dist":{"shasum":"bec28a6cb53d3a21ee3dd129e255d8674cb18089","tarball":"https://registry.npmjs.org/@build-fractal/orchestrator/-/orchestrator-0.9.6.tgz","fileCount":525,"integrity":"sha512-9sB/aHODzpkilHSdW83a1gD06Gf6XOVn6YOLEz3JTV+OzPbKJY5KWzdXJ0fuRojqT4MUXLYi2/bcA9UcO2Jzog==","signatures":[{"sig":"MEQCIFt+aTPaT1Q0Rh0TUK5xYQNnNuAGnpTnFxma+SneP68wAiBe522z0Y/0vDVhffVXEp1gMG6xJU3cg7A9ymXmzJqVVQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4206675},"engines":{"node":">=14"},"gitHead":"fc76acea2c053a21c76cb3e3c1c85bdf7af7b041","scripts":{"postinstall":"bash packaging/npm/postinstall.sh"},"_npmUser":{"name":"bkellgren","email":"bkellgren@gmail.com"},"repository":{"url":"git+https://github.com/Build-Fractal/orchestrator.git","type":"git"},"_npmVersion":"10.8.2","description":"Autonomous multi-phase orchestration skills for Claude Code, Codex, and Cursor","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/orchestrator_0.9.6_1780538528201_0.2869454186737692","host":"s3://npm-registry-packages-npm-production"}},"0.9.7":{"name":"@build-fractal/orchestrator","version":"0.9.7","keywords":["orchestrator","claude-code","codex","cursor","ai-coding","autonomous-agents","spec-driven-development"],"author":{"name":"Build-Fractal"},"license":"MIT","_id":"@build-fractal/orchestrator@0.9.7","maintainers":[{"name":"bkellgren","email":"bkellgren@gmail.com"}],"homepage":"https://github.com/Build-Fractal/orchestrator","bugs":{"url":"https://github.com/Build-Fractal/orchestrator/issues"},"os":["darwin","linux"],"bin":{"orchestrator":"bin/orchestrator"},"dist":{"shasum":"a8926018d168cb3dd5c1ba6653ba312e18da6ff3","tarball":"https://registry.npmjs.org/@build-fractal/orchestrator/-/orchestrator-0.9.7.tgz","fileCount":525,"integrity":"sha512-yPu9DTL0v9rsKjq7uL/2AD2EBkyygZQxX4eHOCNofHxKJqz6XjgQA82vYTkunbs6oS/TvQKpQGAiepkfijR6GA==","signatures":[{"sig":"MEYCIQDR9tGPmCjy0Lqk3q16fKDoeDK3UhG77Sxa9ok5ia9EFgIhAOumjJqE2ihv6KIyHAFQxVkbdhJ2t1LVWxyQ7X5BmezS","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4207927},"engines":{"node":">=14"},"gitHead":"fc5d6db1637014ba9d78efec40e247c0c40c8189","scripts":{"postinstall":"bash packaging/npm/postinstall.sh"},"_npmUser":{"name":"bkellgren","email":"bkellgren@gmail.com"},"repository":{"url":"git+https://github.com/Build-Fractal/orchestrator.git","type":"git"},"_npmVersion":"10.8.2","description":"Autonomous multi-phase orchestration skills for Claude Code, Codex, and Cursor","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/orchestrator_0.9.7_1780585477210_0.8210527020739748","host":"s3://npm-registry-packages-npm-production"}},"0.9.8":{"name":"@build-fractal/orchestrator","version":"0.9.8","keywords":["orchestrator","claude-code","codex","cursor","ai-coding","autonomous-agents","spec-driven-development"],"author":{"name":"Build-Fractal"},"license":"MIT","_id":"@build-fractal/orchestrator@0.9.8","maintainers":[{"name":"bkellgren","email":"bkellgren@gmail.com"}],"homepage":"https://github.com/Build-Fractal/orchestrator","bugs":{"url":"https://github.com/Build-Fractal/orchestrator/issues"},"os":["darwin","linux"],"bin":{"orchestrator":"bin/orchestrator"},"dist":{"shasum":"3c03485324422637b2ceaee212e4dc776be73ad0","tarball":"https://registry.npmjs.org/@build-fractal/orchestrator/-/orchestrator-0.9.8.tgz","fileCount":529,"integrity":"sha512-sqZW+rVXa2G9I4UfYb1y5od84BFEgntpfkHaT9JGxLQyTZ7gG0aIs5DZMQ127+azFTMaPZutJLbrl/mG9qED4A==","signatures":[{"sig":"MEYCIQCHBrumTU/ZN2CLc+Af5OCMkAVtqdts1uwdcqIhxmL7jQIhAIdiDB9PG4AddwPN1jFD1jwJVDIYtazohOh/8NSTbCqI","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4247058},"engines":{"node":">=14"},"gitHead":"79f215268fb7460617f103b0890128a49e54bfaa","scripts":{"postinstall":"bash packaging/npm/postinstall.sh"},"_npmUser":{"name":"bkellgren","email":"bkellgren@gmail.com"},"repository":{"url":"git+https://github.com/Build-Fractal/orchestrator.git","type":"git"},"_npmVersion":"10.8.2","description":"Autonomous multi-phase orchestration skills for Claude Code, Codex, and Cursor","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/orchestrator_0.9.8_1780631640359_0.6862099108663657","host":"s3://npm-registry-packages-npm-production"}},"0.10.0":{"name":"@build-fractal/orchestrator","version":"0.10.0","keywords":["orchestrator","claude-code","codex","cursor","ai-coding","autonomous-agents","spec-driven-development"],"author":{"name":"Build-Fractal"},"license":"MIT","_id":"@build-fractal/orchestrator@0.10.0","maintainers":[{"name":"bkellgren","email":"bkellgren@gmail.com"}],"homepage":"https://github.com/Build-Fractal/orchestrator","bugs":{"url":"https://github.com/Build-Fractal/orchestrator/issues"},"os":["darwin","linux"],"bin":{"orchestrator":"bin/orchestrator"},"dist":{"shasum":"82376b5247cd8f816ea66111b84cd4ee2247fdaa","tarball":"https://registry.npmjs.org/@build-fractal/orchestrator/-/orchestrator-0.10.0.tgz","fileCount":549,"integrity":"sha512-kpjMJU0FuwVF2IhBRVOtZ2u/mTJgvoJ4vgQXN6O7t/1zUWWunh/VLF2Eyh6uRc+AukSg2u47fiD5FnjXolCTSg==","signatures":[{"sig":"MEQCIGp0cm7XsbwpK6tPM3lBefvP9tpi7moLhtGvJopJhQ9sAiB6hDVvzk6VM2w4BUSC6qak0ykZkwhMJxZHIeg6EW4EFA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4435276},"engines":{"node":">=14"},"gitHead":"faeac23bdbae65f852264380df2fee18ee926875","scripts":{"postinstall":"bash packaging/npm/postinstall.sh"},"_npmUser":{"name":"bkellgren","email":"bkellgren@gmail.com"},"repository":{"url":"git+https://github.com/Build-Fractal/orchestrator.git","type":"git"},"_npmVersion":"10.8.2","description":"Autonomous multi-phase orchestration skills for Claude Code, Codex, and Cursor","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/orchestrator_0.10.0_1780805291864_0.698032099119152","host":"s3://npm-registry-packages-npm-production"}},"0.10.1":{"name":"@build-fractal/orchestrator","version":"0.10.1","keywords":["orchestrator","claude-code","codex","cursor","ai-coding","autonomous-agents","spec-driven-development"],"author":{"name":"Build-Fractal"},"license":"MIT","_id":"@build-fractal/orchestrator@0.10.1","maintainers":[{"name":"bkellgren","email":"bkellgren@gmail.com"}],"homepage":"https://github.com/Build-Fractal/orchestrator","bugs":{"url":"https://github.com/Build-Fractal/orchestrator/issues"},"os":["darwin","linux"],"bin":{"orchestrator":"bin/orchestrator"},"dist":{"shasum":"4ba2cf9757d32de671984f514528b7b619151a36","tarball":"https://registry.npmjs.org/@build-fractal/orchestrator/-/orchestrator-0.10.1.tgz","fileCount":549,"integrity":"sha512-01ZuYk8rQ4eputh4Nre9fViYj0RMLd3aokAn0Ndnwr8/ZXHdW4lcXNgFmMAz/iS51yZVSQUPD5oowGi7bVxGpw==","signatures":[{"sig":"MEYCIQDzASnXDj39Ta8Uh4aRWGKuqdOs6BHIU75df7BImJQgzgIhAMM9CVa2M5o+DleU75g3uAdY06CkVb4Ex0rFYjjOS5rv","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4441294},"engines":{"node":">=14"},"gitHead":"a655164f496aceab5a3d633eb1c62083786522a3","scripts":{"postinstall":"bash packaging/npm/postinstall.sh"},"_npmUser":{"name":"bkellgren","email":"bkellgren@gmail.com"},"repository":{"url":"git+https://github.com/Build-Fractal/orchestrator.git","type":"git"},"_npmVersion":"10.8.2","description":"Autonomous multi-phase orchestration skills for Claude Code, Codex, and Cursor","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/orchestrator_0.10.1_1780806415535_0.9676356375966932","host":"s3://npm-registry-packages-npm-production"}},"0.10.2":{"name":"@build-fractal/orchestrator","version":"0.10.2","keywords":["orchestrator","claude-code","codex","cursor","ai-coding","autonomous-agents","spec-driven-development"],"author":{"name":"Build-Fractal"},"license":"MIT","_id":"@build-fractal/orchestrator@0.10.2","maintainers":[{"name":"bkellgren","email":"bkellgren@gmail.com"}],"homepage":"https://github.com/Build-Fractal/orchestrator","bugs":{"url":"https://github.com/Build-Fractal/orchestrator/issues"},"os":["darwin","linux"],"bin":{"orchestrator":"bin/orchestrator"},"dist":{"shasum":"cdc640174dea9d9fda9e8ade87435f83e3e4d2b9","tarball":"https://registry.npmjs.org/@build-fractal/orchestrator/-/orchestrator-0.10.2.tgz","fileCount":549,"integrity":"sha512-Inj3K+51tKWAbDphjxEWdEZuRNUeKVn4XVHGd06ZmujC5Qd93z6xUf6nQXjHqW2+su3zyIjDxuvoalVytYOjWw==","signatures":[{"sig":"MEUCIB8WB6+TNvpkuIe3YIeiwW6yy3u5u0UnSmDYX83NR+KBAiEAnvqPtsonCeVTeCQbSS5kVTrQDE10q2ty451UqmX2mOI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4444819},"engines":{"node":">=14"},"gitHead":"91c4040e62e021edcb7be2ed799952aa522b1177","scripts":{"postinstall":"bash packaging/npm/postinstall.sh"},"_npmUser":{"name":"bkellgren","email":"bkellgren@gmail.com"},"repository":{"url":"git+https://github.com/Build-Fractal/orchestrator.git","type":"git"},"_npmVersion":"10.8.2","description":"Autonomous multi-phase orchestration skills for Claude Code, Codex, and Cursor","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/orchestrator_0.10.2_1780808596145_0.729274196416368","host":"s3://npm-registry-packages-npm-production"}},"0.10.3":{"name":"@build-fractal/orchestrator","version":"0.10.3","description":"Autonomous multi-phase orchestration skills for Claude Code, Codex, and Cursor","homepage":"https://github.com/Build-Fractal/orchestrator","repository":{"type":"git","url":"git+https://github.com/Build-Fractal/orchestrator.git"},"license":"MIT","author":{"name":"Build-Fractal"},"bin":{"orchestrator":"bin/orchestrator"},"scripts":{"postinstall":"bash packaging/npm/postinstall.sh"},"engines":{"node":">=14"},"os":["darwin","linux"],"keywords":["orchestrator","claude-code","codex","cursor","ai-coding","autonomous-agents","spec-driven-development"],"_id":"@build-fractal/orchestrator@0.10.3","gitHead":"ddbcdb0f9d335a7287396f2e2af9640af65049b4","bugs":{"url":"https://github.com/Build-Fractal/orchestrator/issues"},"_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-Tv7FtwbSf1wknnOzWm1/uPfve+akOrIKXSZ+jY4ExchKYnXl/ChmW6olDkVYL4bpdgpaCteBFo9hK+Af8ArnmA==","shasum":"2fa5dd99d737cf5a2c9cc4612fee2c2d965ccdb6","tarball":"https://registry.npmjs.org/@build-fractal/orchestrator/-/orchestrator-0.10.3.tgz","fileCount":552,"unpackedSize":4457740,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAL2/3Cq4AsDU6jvwpdC2YcsXvtvL+Uatewh6p71qFpDAiEAhz6+zSlgZgVK6ciYgMA8VkMKFr+NIGiRhCPrGe0aUVk="}]},"_npmUser":{"name":"bkellgren","email":"bkellgren@gmail.com"},"directories":{},"maintainers":[{"name":"bkellgren","email":"bkellgren@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/orchestrator_0.10.3_1783871790808_0.8396868353396312"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-03T03:45:23.297Z","modified":"2026-07-12T15:56:31.193Z","0.9.3":"2026-06-03T03:45:23.707Z","0.9.4":"2026-06-03T03:56:12.927Z","0.9.5":"2026-06-03T14:52:33.170Z","0.9.6":"2026-06-04T02:02:08.411Z","0.9.7":"2026-06-04T15:04:37.463Z","0.9.8":"2026-06-05T03:54:00.659Z","0.10.0":"2026-06-07T04:08:12.090Z","0.10.1":"2026-06-07T04:26:55.730Z","0.10.2":"2026-06-07T05:03:16.391Z","0.10.3":"2026-07-12T15:56:31.075Z"},"bugs":{"url":"https://github.com/Build-Fractal/orchestrator/issues"},"author":{"name":"Build-Fractal"},"license":"MIT","homepage":"https://github.com/Build-Fractal/orchestrator","keywords":["orchestrator","claude-code","codex","cursor","ai-coding","autonomous-agents","spec-driven-development"],"repository":{"type":"git","url":"git+https://github.com/Build-Fractal/orchestrator.git"},"description":"Autonomous multi-phase orchestration skills for Claude Code, Codex, and Cursor","maintainers":[{"name":"bkellgren","email":"bkellgren@gmail.com"}],"readme":"# Orchestrator\n\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)\n[![Version](https://img.shields.io/badge/version-v0.10.3-green.svg)](./CHANGELOG.md)\n[![Runtime](https://img.shields.io/badge/runtime-Claude%20Code%20%2B%20Cursor-orange.svg)](#try-it-with-zero-commitment)\n[![Spec-driven](https://img.shields.io/badge/spec--driven-development-purple.svg)](./docs/why-this-exists.md)\n\n**Agents dispatch with only the context they need — your decisions, conventions, and related code — never from zero; and every task passes mechanical verification before it counts as done.**\n\nNo context-rebuilding overhead at the start of each task. No self-graded \"looks good to me\" at the end. The mechanism: a per-project knowledge graph injected into each fresh-context dispatch, plus a 4-tier verification ladder ([definition](references/verification-ladder.md)) that runs before a task closes.\n\n---\n\n## See it in 10 seconds\n\nA one-line task dispatch — the relevant knowledge (MEMs: memory entries in the knowledge graph — decisions, conventions, or summaries) is *shown* being injected, not asserted:\n\n```\n$ /orchestrator-do \"fix the broken redirect after sign-up\"\n\n[knowledge-inject] 3 MEMs (auth/sign-up-flow, auth/redirects, conv/error-handling)\n[verify] tier-1 file checks ✓  tier-2 commands (npm test, npm run lint) ✓\n[record] execution-log.jsonl appended · 1 task closed\n```\n\n> **MEM** = a memory entry in the knowledge graph (a decision, convention, or summary). The agent received three relevant MEMs — not the whole codebase. Verification ran mechanically before the task counted as done.\n\n---\n\n## Is this for you?\n\nThree questions. **Two or more \"yes\" → the overhead pays off:**\n\n1. Will the work span **more than one context window**?\n2. Will you **hand it off or resume it later** (another person, another session, after a crash)?\n3. Do you need **mechanical per-task verification** instead of trusting the agent's self-report?\n\n**Otherwise, reach for plain Claude Code first** — for single-context work that fits in one session and never resurfaces, the on-disk discipline is overhead without payoff. See [When this isn't a fit](docs/why-this-exists.md) for the full candor.\n\n---\n\n## What it does\n\n| What you get | Evidence / example |\n|---|---|\n| **Small tasks get sharper** | `/orchestrator-do \"rename X to Y across the auth flow\"` injects the relevant MEMs before dispatch — see the 10-second block above. *(Concrete — try it now.)* |\n| **Verification is mechanical, not vibes** | Every task passes a 4-tier ladder: file checks → command execution → behavioral review → human review. *(Concrete — shown in the dispatch block.)* See [verification-ladder.md](references/verification-ladder.md). |\n| **Load-bearing decisions get reviewed, not rubber-stamped** | Declare `review_gates:` on a phase and each load-bearing decision is surfaced one-by-one at sign-off (accept / override / push back) through your runtime's native prompt — Claude Code `AskUserQuestion`, Cursor MCP elicitation, or a headless `QUESTIONS.md` hand-off — captured to an append-only `REVIEW.md` that populates `SIGNOFF.md`. Opt-in; never deadlocks an autonomous run (declared `defer` / `accept-with-audit` / `refuse-entry` policy). `status`/`doctor` surface unreviewed decisions. *(M034.)* |\n| **Large projects get tractable** | Multi-week features decompose into context-window-sized phases; `/orchestrator-auto` loops `dispatch → verify → record → advance` until done. Dogfooded across **41 closed milestones** — audit trail in [`.orchestrator/milestone-summary.md`](./.orchestrator/milestone-summary.md). |\n| **State survives anything** | All state lives on disk under `.orchestrator/` — crash, terminal kill, or reboot, then `/orchestrator-resume` continues exactly where it stopped. Recovery primitives shipped and dogfooded daily; see [state-machine.md](references/state-machine.md). |\n| **Knowledge compounds** | Every phase emits structured summaries; decisions go to an append-only register; the next phase is cheaper than the last. Three-temperature (hot/warm/cold) graph indexed at [`.orchestrator/KNOWLEDGE.md`](./.orchestrator/KNOWLEDGE.md); see [knowledge-management.md](docs/knowledge-management.md). |\n\n---\n\n## Try it with zero commitment\n\nAlready installed and sitting in a project? One line, no onboarding required:\n\n```bash\n/orchestrator-do \"fix the broken redirect after sign-up\"\n```\n\nIt works without setup, and works *sharper* after `/orchestrator-start` seeds the knowledge graph (about a minute for an existing codebase → 5–15 seed MEMs).\n\n**Not installed yet?** → [Getting Started](docs/getting-started.md) owns the full walkthrough. Pick a channel:\n\n```bash\n# npm (recommended) — installs globally, runs the Claude Code installer for you\nnpm install -g @build-fractal/orchestrator\n\n# curl | bash — no npm required; downloads the signed release tarball\ncurl -fsSL https://github.com/Build-Fractal/orchestrator/releases/latest/download/install.sh | bash\n\n# Homebrew\nbrew install build-fractal/orchestrator/orchestrator\n\n# From source (development / latest unreleased)\ngit clone https://github.com/Build-Fractal/orchestrator.git\ncd orchestrator && bash packaging/install/install-claude-code.sh --project-dir /path/to/your-project\n```\n\nInstalling registers the `/orchestrator-*` skills globally in Claude Code. Then, **in your project, open Claude Code and run `/orchestrator-start`** — the warm onboarding front door (or `/orchestrator-init` for the bare scaffold). The `orchestrator` binary itself is just `--version` / `--help`; the real surface is the Claude Code skills.\n\n> ### 🟣 On Cursor? Two commands.\n>\n> Cursor gets the **same `/orchestrator-*` commands and the same core loop** — knowledge inject, dispatch, verification, and native interactive review gates (via Cursor's MCP elicitation). It installs **per-project** (Cursor keeps everything under `<project>/.cursor/`), so there's no npm step — just clone the repo and point the installer at your project:\n>\n> ```bash\n> git clone https://github.com/Build-Fractal/orchestrator.git\n> cd orchestrator\n> bash packaging/install/install-cursor.sh --project-dir /path/to/your-project\n> ```\n>\n> Then **open your project in Cursor and run `/orchestrator-start`** — the exact same first step as Claude Code. That single install lays down the slash commands (`.cursor/commands/`), an always-on rule (`.cursor/rules/`), the safety shape-guard (`.cursor/hooks.json`), and the review-gate server (`.cursor/mcp.json`).\n>\n> **Good to know:** the install needs only `bash` + `git` — *not* an API key. The `cursor-agent` CLI + `CURSOR_API_KEY` are only needed for **autonomous** runs (`/orchestrator-auto`); the in-IDE commands work without them. Per-run **cost figures aren't wired for Cursor yet** (they report as not-available, never wrong). → [Full Cursor walkthrough](docs/getting-started.md#on-cursor)\n\n**Updating** is one line, and `orchestrator:update` auto-detects how you installed:\n\n```bash\nnpm update -g @build-fractal/orchestrator   # npm / curl installs\nbrew upgrade orchestrator                    # Homebrew installs\n/orchestrator-update                         # from inside any project (dispatches to the right channel)\n```\n\n(Requires Bash 3.2+, git, and optionally jq. macOS + Linux; Windows is fail-closed by design. **Claude Code** and **Cursor** are both supported — see the Cursor callout above. A Codex CLI installer exists with the same flags.)\n\n---\n\n## Pick your path\n\nEach command below assumes you've [installed](docs/getting-started.md) and are in your project directory.\n\n| Your intent | Command | Time | What you get |\n|---|---|---|---|\n| One-shot task, any project | `/orchestrator-do \"fix the broken redirect after sign-up\"` | seconds | Knowledge-injected dispatch; no ceremony |\n| **Join a repo a teammate already set up** (git clone) | install, then `/orchestrator-init` | seconds | Re-stages the runtime + **rebuilds the gitignored knowledge graph**; `/orchestrator-doctor` to confirm. [Details](docs/getting-started.md#joining-a-project-that-already-uses-orchestrator-git-clone) |\n| Onboard an existing codebase | `/orchestrator-start` → codebase ingestion | ~1 min | 5–15 seed MEMs via deterministic structural extraction |\n| Start greenfield, nothing written | `/orchestrator-start` → ideation | 5–10 min | 7-question grilling protocol → vision, scope, users, constraints |\n| Greenfield + materials (briefs, PDFs) | `/orchestrator-start` → materials intake | 5–15 min | Reconciled pre-spec; asked only about real conflicts |\n| Ship a multi-month feature autonomously | `/orchestrator-start` then `/orchestrator-auto` | hours–days | Roadmap → phases → dispatch → verify → advance, untouched |\n| Run it hands-off across context rotations | `/orchestrator-auto --self-continue` | hours–days | Self-continues over rotation boundaries via fresh-process re-entry; halts on completion / blocker / budget / cap. [Details](docs/getting-started.md#self-continuing-autonomous-runs---self-continue) |\n| Add reference docs (regs, glossaries) | `/orchestrator-extract` then `/orchestrator-ingest-reference` | varies | Tiered extraction into the knowledge graph |\n| Give a team visibility | `/orchestrator-wiki-init` (`--deploy --with-giscus`) | ~2 min | mkdocs site of milestones, phases, decisions — GitHub Pages + commentable |\n| Use GitHub Issues / Projects as tracker | `/orchestrator-github-init` | ~2 min | State projected to Issues / Milestones / Projects v2; opt-in, reversible |\n\n> **Coming from spec-kit?** spec-kit is a **migration source, not a dependency** — the orchestrator runs standalone with zero runtime dependency on it. `/orchestrator-start` → migration lifts your existing artifacts in. Expect a real (small) learning curve; the workflow and file layout differ. → [Migrating from spec-kit](docs/migrating-from-speckit.md).\n\n---\n\n## Mental models in one line each\n\n| It's not… | The boundary |\n|---|---|\n| **plain Claude Code** | Use plain Claude Code first for single-context work. Orchestrator adds knowledge injection + verification for *multi-session, hand-off* work. See [Is this for you?](#is-this-for-you) |\n| **spec-kit** | A migration source, not a dependency or runtime. The orchestrator runs standalone. → [migrating-from-speckit](docs/migrating-from-speckit.md) |\n| **conversus** | An *optional* sister tool (multi-agent adversarial review), released separately and **not required**. The orchestrator works standalone without it; the `/orchestrator-conversus-gate` adapter degrades gracefully — deliberation gates are skipped — when it isn't installed. |\n\n---\n\n## Command cheat sheet\n\n**Start with these 5 entry points** — they cover most of what you'll do day to day:\n\n| Entry point | When to use |\n|---|---|\n| `/orchestrator-start` | First time in any project — warm front door, auto-routes onboarding (greenfield-empty / greenfield-with-materials / existing-codebase / migrating) |\n| `/orchestrator-do \"...\"` | Any task — classifies scope, routes to Tier A quick-path, Tier A+ middle flow, or defers larger work to `/orchestrator-specify` |\n| `/orchestrator-auto` | Autonomous loop — `dispatch → verify → record → advance` until milestone completes or a blocker surfaces. Add **`--self-continue`** to keep it running across context-rotation boundaries *without re-invoking by hand* — it re-spawns a fresh process each time and stops on completion, a blocker, budget, or a cap (opt-in, default off) |\n| `/orchestrator-status` | Anytime — read-only one-screen progress + next-action report |\n| `/orchestrator-resume` | After crash or pause — reads `.orchestrator/` state and continues exactly where it stopped |\n\n> **Tier A / A+ / B / C** = task-scope classes, smallest to largest. `/orchestrator-do` picks one automatically; you rarely name them yourself.\n\n**Beyond the entry points**, the orchestrator ships **37 user-facing commands** — planning (`specify`, `roadmap`, `plan-phase`), knowledge (`extract`, `ingest-reference`, `consolidate`), GitHub (`github-init`, `github-sync`, `comments`), diagnostics (`doctor`, `diagnose`, `detective`, `where`, `cost`), wiki, and more. Each lives at [`commands/<name>.md`](./commands/); the full per-feature chain is `evaluate → discuss → roadmap → plan-phase → auto → verify → consolidate`.\n\n---\n\n## Status & credibility\n\n**v0.10.3** — published across npm / Homebrew / curl, in production use and **dogfooded daily on its own development**. Dozens of milestones closed (latest: M045 self-continuing auto — `orchestrator:auto --self-continue`, 2026-07-01; M044 knowledge-activation reliability, 2026-06-07; M034 interactive review gates, 2026-06-06; M043 Cloudflare Pages + Access wiki-deploy target, 2026-06-05; M042 `/orchestrator-corpus-gate`, 2026-05-30); the packaging & distribution launch event shipped 2026-05-09. **Cursor is a supported runtime (M009 + M034, 2026-06-06)** — native commands, dispatch backend, hooks, and interactive review gates. In flight: M046 auto-v2b unified serial core (tier-sized autonomous entry + `--unattended` safety envelope).\n\nFull audit trail: [`.orchestrator/milestone-summary.md`](./.orchestrator/milestone-summary.md) · engineering changelog: [`CHANGELOG.md`](./CHANGELOG.md).\n\nGoverned by 15 constitutional principles ([`.orchestrator/memory/constitution.md`](./.orchestrator/memory/constitution.md)) — e.g. *Evidence Before Claims* (no task closes without fresh verification) and *Knowledge Compounds* (every phase emits docs that make the next cheaper). The full rationale and the prior failures these codify live in [why-this-exists](docs/why-this-exists.md).\n\n---\n\n## Hit a snag? Tell us\n\nReporting takes about 30 seconds, and it genuinely shapes what ships next — on **Claude Code or Cursor**:\n\n| What | Where |\n|---|---|\n| 🐞 Something's broken | **[Open a bug report →](https://github.com/Build-Fractal/orchestrator/issues/new?template=bug_report.yml)** |\n| 💡 Want a feature | [Open a feature request →](https://github.com/Build-Fractal/orchestrator/issues/new?template=feature_request.yml) |\n| ❓ How-to / \"is this normal?\" | [GitHub Discussions →](https://github.com/Build-Fractal/orchestrator/discussions) (not the issue tracker) |\n| 🔒 Security issue | [Private advisory →](https://github.com/Build-Fractal/orchestrator/security/advisories/new) — please don't open a public issue |\n\nTwo things make any report instantly actionable — the bug template asks for both:\n\n1. **Your runtime** — Claude Code or Cursor (+ install channel).\n2. **The output of `/orchestrator-doctor`** — it's read-only and safe to run anytime; paste what it prints.\n\nThat's it. No reproduction wizardry required — a one-paragraph \"I ran X, expected Y, got Z\" plus those two lines is a great report.\n\n---\n\n## Next step\n\n| You are… | Go here |\n|---|---|\n| **Skeptical** — want the \"why\" before you commit | → [Why this exists](docs/why-this-exists.md) |\n| **Ready to install** (Claude Code or Cursor) | → [Getting Started](docs/getting-started.md) |\n| **On Cursor** and want the full setup | → [Getting Started → Cursor](docs/getting-started.md#on-cursor) |\n| **Coming from spec-kit** with existing artifacts | → [Migrating from spec-kit](docs/migrating-from-speckit.md) |\n\n**Want to contribute?** → [CONTRIBUTING.md](CONTRIBUTING.md) (dev setup, tests, conventions). Maintainers cutting a release → [Releasing](references/RELEASING.md).\n\n**See also:** [Knowledge Management](docs/knowledge-management.md) · [Recipe Authoring](docs/recipe-authoring.md) · [Hook Development](docs/hook-development.md) · [Architecture](references/architecture.md) · [Verification Ladder](references/verification-ladder.md) · [State Machine](references/state-machine.md)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}