model-orchestrator 0.1.14 → 0.1.16

package/templates/common/TASK_BUNDLE.md

@@ -1,6 +1,6 @@
 # Task Bundle: the brief every delegation carries
 
-A subagent, a second CLI, or a fresh chat window holds none of the rules your main session is holding. It cannot see your conventions, it cannot route, and it will read an unspecified edge as an open one.
+A subagent, a second CLI, or a fresh chat window may hold none of the rules your main session is holding, and that is the default to assume. One exception: a Claude Code subagent loads the project's CLAUDE.md hierarchy at start, so it already carries the standing rules, just not this task's scope. Either way, it cannot see this task's conventions and will read an unspecified edge as an open one.
 
 > A delegate gets an approved, bounded brief. Absence is not permission.
 
@@ -25,7 +25,7 @@ Copy this into the delegate's prompt. Delete nothing; write `none` where a field
 **Denied actions.** <explicit list: do not commit, push, deploy, delete, send, publish, close a ticket...>
 - Anything absent from Capabilities is denied. Absence is not permission.
 
-**Conventions you do not have.** <restate every house rule this task needs; the delegate holds none>
+**Conventions you do not have.** <restate every house rule this task needs; even a delegate that loaded the standing rules still needs this task's scope, and a second CLI or a fresh chat window may hold none of it>
 
 **Report contract.** Return: <exactly what to hand back>. State plainly what you did NOT do
 and anything you could not verify. "Unverified" is an acceptable answer; a confident guess is not.

package/templates/common/protocols/build-protocol.md

@@ -104,14 +104,14 @@ Use a different model family from the one that produced the finding where you ha
 
 | Role | Does | Does not |
 |---|---|---|
-| Builder / orchestrator | Routes, maps, writes, verifies, records. Stages 0, 1, 3, 6, 7 | Hand off the main build |
+{{ROLES_BUILDER_ROW}}
 | Judgment tier | Stage 2 and the architectural arm of Stage 5. Argues with a finished map | Perform the retrieval |
 | Adversarial auditor | The security arm of Stage 5. Attacks the diff | Fix anything |
 | Mechanical gates | Stage 4 and any always-on guard | Be overridden without reading |
 | Cheap workers | Bounded sub-parts: bulk passes, wide searches, long loops | Own a stage |
 | Human | Stage 5b, and any irreversible or architectural call | Be the first line of review |
 
-**Why the builder does not hand off the main build:** a delegated agent does not inherit the session's standing rules and usually cannot delegate further. Any brief must restate every convention it needs (see `TASK_BUNDLE.md`), and that cost is itself a reason to build directly when the work fits.
+{{BUILDER_HANDOFF_NOTE}}
 
 ## Checklist
 

package/templates/intermediate/ROUTING.md

@@ -15,19 +15,15 @@ Rule of thumb: never spend a frontier token on a task a cheap tier finishes corr
 0. **Is there a cheaper or better external lane for this?** Check `DELEGATION_MATRIX.md`. Your enabled lanes, every one called through `bin/cli-run.mjs`:
 {{LANE_STEP0}}
 1. **Bulk and mechanical?** → fast tier{{BULK_LANE}}. Many independent items each needing its own agent turn → a concurrent fan-out lane if you have one.
+1a. **Reading or digesting many files or notes, not writing?** → reader. Different from a bulk pass: reader reports, it does not classify, tag or transform.
 2. **Needs live data?** → {{LIVE_LANE}} standard tier with web tools.
 3. **Reviewing without changing?** → standard tier read-only. Security-critical → {{ATTACK_LANE}}.
 3a. **Holding findings from a review or a scanner?** → finding-verifier before any of them cause a repair. A finding is a claim, not a fact.
+3b. **Checking a tracker item or task against its stated done-signal?** → done-verifier. It probes the named artifact and returns MET, NOT_MET or UNVERIFIABLE; it never closes anything itself.
 4. **Ambiguous, strategic, expensive to get wrong?** → deep tier (deep-planner). Then hand the plan down.
-5. **Everything else that changes files** → the orchestrator builds it directly. Bounded sub-parts go to cheaper tiers; the main build is never handed off whole.
+{{DECISION_RULE5}}
 
-## Who builds
-
-**The orchestrator owns the main build.** It is the only surface that holds these rules: a subagent or a second CLI starts with none of them and cannot route. Handing the main build to one hands it to something the router cannot reach.
-
-Delegate: background and long-running tasks, small tasks, scoping, verification, research, bounded sub-parts. Never delegate: the main build, or any step that must carry a house rule (secrets handling, the loud-negative verification, the durable record).
-
-Every delegation carries `TASK_BUNDLE.md`. Its brief must restate every convention the delegate needs.
+{{WHO_BUILDS}}
 
 ## The Build Protocol, with lanes bound
 
@@ -56,7 +52,7 @@ One writer per run; every other lane proposes. Search before writing, index in t
 
 ## Modifier rules
 
-- **Plan big, execute small**, within a build: deep tier plans at Checkpoint 1, the orchestrator executes, bulk and wide searches go down.
+{{PLAN_BIG_LINE}}{{INLINE_THRESHOLD_NOTE}}
 - **Escalation:** never silently retry at the same tier. Escalate one tier or consult deep once, and say which. Two consults that do not unstick it → stop and tell the human.
 - **De-escalation:** a request that sounds deep but is a lookup routes down.
 - **Long context:** mechanical digestion → fast tier in chunks; judgment over a long input → standard tier.
@@ -71,8 +67,11 @@ One writer per run; every other lane proposes. Search before writing, index in t
 |---|---|
 | "Design the architecture for X" | deep-planner |
 | "Review this service for bugs" | code-reviewer |
-| "Add an endpoint" | the orchestrator builds it |
+{{ADD_ENDPOINT_ROW}}
 | "Why does this silently drop rows sometimes" | deep-planner (unknown cause), then build the fix directly |
 | "Summarize these 30 notes into one index" | bulk-worker |
+| "Read every note in this folder and pull out every mention of X" | reader |
 | "The audit returned 6 findings" | finding-verifier first; repair only what comes back CONFIRMED |
+| "Is issue #123 actually done" | done-verifier |
 {{LANE_EXAMPLES}}
+{{ROUTE_GATE_SECTION}}

package/templates/intermediate/TIERS.md

@@ -23,6 +23,8 @@ Tier sets the price per token. Token discipline sets how many tokens. **Effort s
 | builder | standard | high | a botched deploy is the costly failure |
 | live-researcher | standard | medium | tools do the retrieval |
 | bulk-worker | fast | low | the biggest cost win |
+| done-verifier | fast | low | a done-signal check is a lookup, not a judgment call |
+| reader | fast | low | digestion, not judgment |
 
 ## Three inputs, not one