From 76ac113d0ce832842919a7beadf6f85f20e922bd Mon Sep 17 00:00:00 2001 From: Jason Woltje Date: Fri, 6 Feb 2026 13:10:33 -0600 Subject: [PATCH] fix(orchestrator): Add explicit boundaries - orchestrator NEVER edits source code MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Orchestrator was editing source code directly instead of spawning workers. Added CRITICAL section making it explicit: - Orchestrator NEVER edits source code - Orchestrator NEVER runs quality gates - Orchestrator ONLY manages tasks.md and spawns workers - No "quick fixes" — spawn a worker instead Co-Authored-By: Claude Opus 4.5 --- docs/claude/orchestrator.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) 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):