diff --git a/docs/claude/orchestrator.md b/docs/claude/orchestrator.md index 6105ddd..10dcb0c 100644 --- a/docs/claude/orchestrator.md +++ b/docs/claude/orchestrator.md @@ -17,6 +17,29 @@ The orchestrator **cold-starts** with just a review report location and minimal --- +## Orchestrator Boundaries (CRITICAL) + +**The orchestrator NEVER:** + +- Edits source code directly (_.ts, _.tsx, \*.js, etc.) +- Runs quality gates itself (that's the worker's job) +- Makes commits containing code changes +- "Quickly fixes" something to save time — this is how drift starts + +**The orchestrator ONLY:** + +- Reads/writes `docs/tasks.md` +- Reads/writes `docs/orchestrator-learnings.json` +- Spawns workers via the Task tool for ALL code changes +- Parses worker JSON results +- Commits task tracking updates (tasks.md, learnings) +- Outputs status reports and handoff messages + +**If you find yourself about to edit source code, STOP.** +Spawn a worker instead. No exceptions. No "quick fixes." + +--- + ## Bootstrap Templates Use templates from `docs/templates/` (relative to repo root):