@azure-id/orc 2.1.0 → 2.1.1

package/CHANGELOG.md

@@ -10,6 +10,60 @@ Format: `### v<version> — <title> _(<date>)_`.
 
 ---
 
+### v2.1.1 — the quick and fast lanes move to Sonnet 5 _(2026-10-02)_
+
+**Still on the unscoped `orc` package?** Do this once first - your `orc upgrade`
+is the pre-v0.56.0 one and cannot install itself. Full detail in the CAUTION at
+the top of this file.
+
+- **Step 1 - release the command from the old package:** `npm uninstall -g orc`
+- **Step 2 - install the current package:** `npm i -g @azure-id/orc`
+- **Step 3 - re-apply it to your project:** `orc update`
+
+**Do not use `npm i -g -f`.** Full detail in v0.56.0 below.
+
+This release changes the models that `/orc-quick`, `/orc-fast` and `orc extra`
+use. Sonnet 4.6 leaves the coding lanes. Sonnet 5 (`claude-sonnet-5-5`) replaces it.
+
+**1. The quick dispatch gate**
+
+- Code entries: `orc-executor-sonnet-5-med` or `orc-executor-opus-5-low`. The
+  default suggestion for a mechanical edit is `orc-executor-sonnet-5-med`.
+- Read-only entries: `orc-recon-sonnet-5-med` or `orc-recon-opus-5-low`.
+- An agent's model change is a rename:
+  `orc-recon-sonnet-4-6-med` → `orc-recon-sonnet-5-med`. The agent count stays 51.
+
+**2. orc extra**
+
+- The `quick-executor` slot uses `orc-executor-sonnet-5-med`.
+- `extra_fallback_agent` options and the fallback menu show
+  `orc-executor-sonnet-5-high`. They showed `orc-executor-sonnet-4-6-high`. A
+  config that names the old agent is still accepted.
+
+**3. /orc-fast**
+
+- The one executor is `orc-executor-sonnet-5-med`. It was
+  `orc-executor-sonnet-4-6-high`. The `fast-executor` extra slot, `orc budget`
+  and the `opus5_only` table use the new name. Under `opus5_only` it is still
+  `orc-executor-opus-5-low`.
+- Run the lane from a Sonnet 5 (or higher) main session. A Sonnet 4.6 session is
+  below the executor's pin.
+
+**4. Text and examples**
+
+- `/orc`: the "even the smallest task gets a cheap subagent" rule names Sonnet 5
+  low. The examples dispatch Sonnet 5 high for scores 31–40.
+- `/orc-grill`: the recon line names `claude-sonnet-5-5 / medium`.
+
+**Not changed:** Sonnet 4.6 stays for the graph noter, the scout, the `orc diy`
+choices and the opt-in executors (`orc-executor-sonnet-4-6-med`,
+`orc-executor-sonnet-4-6-high`).
+
+**What you have to do:** `orc update --prune`. If a script names
+`orc-recon-sonnet-4-6-med`, change it to `orc-recon-sonnet-5-med`.
+
+---
+
 ### v2.1.0 — the review counts, the score table moves up, and old logs can go _(2026-10-02)_
 
 **Still on the unscoped `orc` package?** Do this once first - your `orc upgrade`

package/README.md

@@ -7,14 +7,14 @@
 *Intake → analyze → plan → score → parallel subagents → review → verify → ship.*
 
 ![npm](https://img.shields.io/npm/v/%40azure-id%2Forc?style=for-the-badge&color=cb3837&logo=npm)
-![Version](https://img.shields.io/badge/version-2.1.0-blue.svg?style=for-the-badge)
+![Version](https://img.shields.io/badge/version-2.1.1-blue.svg?style=for-the-badge)
 ![License](https://img.shields.io/badge/license-MIT-green.svg?style=for-the-badge)
 ![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg?style=for-the-badge)
 ![Claude Code](https://img.shields.io/badge/Claude_Code-Skills-purple.svg?style=for-the-badge)
 ![Dependencies](https://img.shields.io/badge/dependencies-zero-lightgrey.svg?style=for-the-badge)
 ![GitHub stars](https://img.shields.io/github/stars/azure-id/orc?style=for-the-badge&color=yellow)
 
-**Latest: v2.1.0** · updated 02-10-2026 · [full changelog](CHANGELOG.md)
+**Latest: v2.1.1** · updated 02-10-2026 · [full changelog](CHANGELOG.md)
 
 **On npm: [`@azure-id/orc`](https://www.npmjs.com/package/@azure-id/orc)** — `npm i -g @azure-id/orc`
 
@@ -741,39 +741,27 @@ a current audit: [EVAL-REPORT.md](EVAL-REPORT.md).
 **Full history: [CHANGELOG.md](CHANGELOG.md)** — or `orc changelog`, which prints
 only what is newer than the version you have.
 
-### v2.1.0 — the review counts, the score table moves up, and old logs can go _(2026-10-02)_
-
-- **A new score table with five bands.** Scores 0–40 go to Sonnet 5 (low,
-  medium, high). Scores 41–89 go to Opus 5.5 low, and 90–100 to Opus 5.5 medium.
-  Haiku is no longer in the table. **Every band from 41 needs an Opus 5.5 main
-  session.**
-- **Sonnet 5 runs on `claude-sonnet-5-5`.** The price table is correct again.
-- **The reviewer is `orc-reviewer-opus-5-low`.** In the live eval, low effort
-  found every seeded defect that was still in the diff.
-- **The wiki scanner and the CLAUDE.md writer use Opus 5.5 low** (they used Opus
-  4.8).
-- **Review quality no longer says "0 so far" after real reviews.** It counts
-  reviews from the traces. A clean review counts too.
-- **Your project's own review rule.** When CLAUDE.md or AGENTS.md asks for a
-  different review (for example `/code-review`), the lanes ask "ORC review, that
-  review, or skip". `orc review policy` shows what ORC found.
-- **New lane `/orc-fix`.** It records a fix after a review (Sonar, a red CI, a
-  bug) and who added the bug. The reviewer card shows it, and the panel shows
-  "Fixes after review".
-- **`orc clear logs`** shows old traces and run folders. `--apply` deletes them.
-  Nothing is deleted automatically unless you set `log_retention_auto: on`.
-- **The status line timer:** 1, 2, 3, 5 or 10 seconds. Below 1 second is refused,
-  because Claude Code does not support it.
-- **Behaviour tab fixes:** with `habits: off` you still see Review quality and
-  Gotchas, `/orc-fast` records your answers, and the answer log shows the question.
-
-**What you have to do:** `orc update`. If you compiled an `orc diy` flow, run
-`orc diy compile`. If a script names `orc-reviewer-opus-5-med`, change it to
-`orc-reviewer-opus-5-low`. The cost changes: read the CHANGELOG.
+### v2.1.1 — the quick and fast lanes move to Sonnet 5 _(2026-10-02)_
+
+- **`/orc-quick` offers Sonnet 5 medium and Opus 5.5 low.** For code:
+  `orc-executor-sonnet-5-med` or `orc-executor-opus-5-low`. For a question:
+  `orc-recon-sonnet-5-med` or `orc-recon-opus-5-low`.
+- **`/orc-fast` uses `orc-executor-sonnet-5-med`** (it used Sonnet 4.6 high). Run it
+  from a Sonnet 5 or Opus main session.
+- **`/orc` examples and the "cheap subagent" rule name Sonnet 5.** Sonnet 4.6 stays
+  only for the graph noter, the scout, `orc diy` choices and opt-in names.
+- **The recon agent has a new name:** `orc-recon-sonnet-4-6-med` →
+  `orc-recon-sonnet-5-med`.
+- **`orc extra`:** the `quick-executor` slot uses `orc-executor-sonnet-5-med`. The
+  `extra_fallback_agent` options show `orc-executor-sonnet-5-high` (not Sonnet 4.6).
+
+**What you have to do:** `orc update --prune`. If a script names
+`orc-recon-sonnet-4-6-med`, change it to `orc-recon-sonnet-5-med`.
 
 <details>
-<summary><strong>Earlier releases</strong> — 127 of them, titles only. Full text in <a href="CHANGELOG.md">CHANGELOG.md</a>.</summary>
+<summary><strong>Earlier releases</strong> — 128 of them, titles only. Full text in <a href="CHANGELOG.md">CHANGELOG.md</a>.</summary>
 
+- **v2.1.0** — the review counts, the score table moves up, and old logs can go · _2026-10-02_
 - **v2.0.4** — design the status line to the last cell · _2026-09-30_
 - **v2.0.3** — the status line you designed is the status line you see · _2026-09-30_
 - **v2.0.2** — the lanes record what you answered, and the reviewer always gets the card · _2026-09-28_

package/bin/build-agents.js

@@ -1,205 +1,205 @@
-#!/usr/bin/env node
-"use strict";
-/**
- * Agent generator. Two sets, one rule: a file that differs from its siblings
- * ONLY in frontmatter and the "You are … (<model>, <effort>)" line is GENERATED.
- *
- *   1. The 10 executors — agents-src/executor.template.md × VARIANTS
- *      (name/model/effort + score band).
- *   2. The 8 model-twin pairs (v2.0.0 T15) — agents-src/twins/<family>.template.md
- *      × TWINS (name/model/effort/description + the `who` line). One body per
- *      family: before T15 each pair was two hand-kept copies that nothing
- *      checked against each other.
- *
- * Edit the template (or the table), run `npm run build:agents`, and every copy
- * is stamped out identically. A model change is still a RENAME: a new row, not
- * an edited one.
- *
- * Modes:
- *   node bin/build-agents.js          write both sets into templates/agents/
- *   node bin/build-agents.js --check  fail if any generated file drifted from
- *                                     its template (runs in `npm run verify`
- *                                     and prepack — a hand-edit to a generated
- *                                     agent file fails the build)
- */
-const fs = require("fs");
-const path = require("path");
-
-const ROOT = path.join(__dirname, "..");
-const TEMPLATE = path.join(ROOT, "agents-src", "executor.template.md");
-const OUT_DIR = path.join(ROOT, "templates", "agents");
-
-// Score→model bands mirror templates/agents/MODEL-MAPPING.md and the single
-// score→model table in skills/orc/config.md (documented drift — change
-// together). `effort: null` = a model with NO effort ladder (haiku): the
-// generator omits the `effort:` frontmatter line entirely.
-//
-// v1.0.0 W4 — the table was SIX bands, not eight, and the `opus5_only` ladder is
-// TWO, not three. v2.1.0 made the table FIVE bands (Sonnet 5 low/med/high, then
-// Opus 5.5 low/med). Seven of these agents are named by NO default row:
-// names them, and they ship anyway (D14). They stay reachable through
-// `rubric_bands_override`, `orc diy` `fixed_executor` and `extra_fallback_agent`,
-// and deleting a generated file that no row happens to name today would be a
-// rename-shaped migration for what is only a table change. Their `band` string
-// says so rather than naming a range that no longer exists — a band label that
-// lies is worse than one that admits it is unreachable by default.
-const VARIANTS = [
-  { name: "orc-executor-opus-5-med",     model: "claude-opus-5-5",     effort: "medium", band: "highest-complexity [90,100]" },
-  { name: "orc-executor-opus-5-low",     model: "claude-opus-5-5",     effort: "low",    band: "upper-complexity [41,90)" },
-  { name: "orc-executor-sonnet-5-high",  model: "claude-sonnet-5-5",  effort: "high",   band: "mid-complexity [31,41)" },
-  { name: "orc-executor-sonnet-5-med",   model: "claude-sonnet-5-5",  effort: "medium", band: "low-complexity [21,31)" },
-  { name: "orc-executor-sonnet-5-low",   model: "claude-sonnet-5-5",  effort: "low",    band: "lowest-complexity [0,21)" },
-  // NAMED BY NO BAND since v1.0.0 W4 / v2.1.0 (D14) — kept on disk, dispatched
-  // only when a user names one explicitly.
-  { name: "orc-executor-sonnet-4-6-high", model: "claude-sonnet-4-6", effort: "high",  band: "none (opt-in only, see MODEL-MAPPING.md)" },
-  { name: "orc-executor-sonnet-4-6-med", model: "claude-sonnet-4-6", effort: "medium", band: "none (opt-in only, see MODEL-MAPPING.md)" },
-  { name: "orc-executor-haiku-4-5",      model: "claude-haiku-4-5",  effort: null,     band: "none (opt-in only, see MODEL-MAPPING.md)" },
-  { name: "orc-executor-opus-5-high",    model: "claude-opus-5-5",    effort: "high",   band: "none (opt-in only, see MODEL-MAPPING.md)" },
-  { name: "orc-executor-opus-4-8-high",  model: "claude-opus-4-8",  effort: "high",   band: "none (opt-in only, see MODEL-MAPPING.md)" },
-  { name: "orc-executor-opus-4-7-high",  model: "claude-opus-4-7",  effort: "high",   band: "none (opt-in only, see MODEL-MAPPING.md)" },
-  { name: "orc-executor-opus-4-7-med",   model: "claude-opus-4-7",  effort: "medium", band: "none (opt-in only, see MODEL-MAPPING.md)" },
-];
-
-// v2.0.0 T15 — the model twins. Each family is one template under
-// agents-src/twins/; a row fills five placeholders: {{NAME}}, {{MODEL}},
-// {{EFFORT}}, {{DESC}} (the one-line frontmatter description) and {{WHO}} (the
-// "(Sonnet 5, high)" part of the "You are …" line — absent for a family whose
-// body never names its own model). The pair is a runtime choice (`opus5_only`,
-// the recon gate, the wiki tier ladder), so both halves always ship.
-const TWIN_DIR = path.join(ROOT, "agents-src", "twins");
-const TWINS = [
-  { family: "analyze-mini", variants: [
-    { name: "orc-analyze-mini-sonnet-5-high", model: "claude-sonnet-5-5", effort: "high", who: "Sonnet 5, high",
-      desc: "ORC mini System Analyst — claude-sonnet-5-5, high effort. Dispatched by /orc-mini and /orc-analyze-mini at analysis: single pass, no deep mode, no scouts." },
-    { name: "orc-analyze-mini-opus-5-med", model: "claude-opus-5-5", effort: "medium", who: "Opus 5.5, medium",
-      desc: "ORC mini System Analyst — claude-opus-5-5, medium effort. Dispatched by /orc-mini and /orc-analyze-mini, instead of orc-analyze-mini-sonnet-5-high when `opus5_only: true`." },
-  ] },
-  { family: "planner-mini", variants: [
-    { name: "orc-planner-mini-sonnet-5-high", model: "claude-sonnet-5-5", effort: "high", who: "Sonnet 5, high",
-      desc: "ORC mini Requirement Planner — claude-sonnet-5-5, high effort. Dispatched by /orc-mini at planning." },
-    { name: "orc-planner-mini-opus-5-med", model: "claude-opus-5-5", effort: "medium", who: "Opus 5.5, medium",
-      desc: "ORC mini Requirement Planner — claude-opus-5-5, medium effort. Dispatched by /orc-mini at planning, instead of orc-planner-mini-sonnet-5-high when `opus5_only: true`." },
-  ] },
-  { family: "pattern-codifier", variants: [
-    { name: "orc-pattern-codifier-sonnet-5-high", model: "claude-sonnet-5-5", effort: "high",
-      desc: "ORC Pattern Codifier — claude-sonnet-5-5, high effort. Dispatched by orc-pattern (lazy /orc miss, eager orc-wiki, or manual /orc-pattern) for ONE language." },
-    { name: "orc-pattern-codifier-opus-5-med", model: "claude-opus-5-5", effort: "medium",
-      desc: "ORC Pattern Codifier — claude-opus-5-5, medium effort. Dispatched by orc-pattern, instead of orc-pattern-codifier-sonnet-5-high when `opus5_only: true`." },
-  ] },
-  { family: "recon", variants: [
-    { name: "orc-recon-sonnet-4-6-med", model: "claude-sonnet-4-6", effort: "medium", who: "Sonnet 4.6, medium",
-      desc: "ORC Recon — claude-sonnet-4-6, medium effort. Dispatched by /orc-quick at the dispatch gate, for a read-only question. It never edits." },
-    { name: "orc-recon-opus-5-low", model: "claude-opus-5-5", effort: "low", who: "Opus 5.5, low",
-      desc: "ORC Recon — claude-opus-5-5, low effort. Dispatched by /orc-quick at the dispatch gate, for a WIDE or SUBTLE read-only question. It never edits." },
-  ] },
-  { family: "retro", variants: [
-    { name: "orc-retro-sonnet-5-high", model: "claude-sonnet-5-5", effort: "high", who: "Sonnet 5, high",
-      desc: "ORC Retro miner — claude-sonnet-5-5, high effort. Dispatched by /orc-retro to mine the behavior traces. Read-only, report-only." },
-    { name: "orc-retro-opus-5-med", model: "claude-opus-5-5", effort: "medium", who: "Opus 5.5, medium",
-      desc: "ORC Retro miner — claude-opus-5-5, medium effort. Dispatched by /orc-retro, instead of orc-retro-sonnet-5-high when `opus5_only: true`. Read-only." },
-  ] },
-  { family: "scout", variants: [
-    { name: "orc-scout-sonnet-4-6-high", model: "claude-sonnet-4-6", effort: "high", who: "Sonnet 4.6, high",
-      desc: "ORC Code Scout — claude-sonnet-4-6, high effort. Dispatched by orc in the analyst's DEEP mode (≤max_scouts in parallel), ONE coverage area each." },
-    { name: "orc-scout-opus-5-low", model: "claude-opus-5-5", effort: "low", who: "Opus 5.5, low",
-      desc: "ORC Code Scout — claude-opus-5-5, low effort. Dispatched by orc in the analyst's DEEP mode, instead of orc-scout-sonnet-4-6-high when `opus5_only: true`." },
-  ] },
-  { family: "claude-writer", variants: [
-    { name: "orc-claude-writer-opus-5-low", model: "claude-opus-5-5", effort: "low", who: "Opus 5.5, low",
-      desc: "ORC CLAUDE.md Writer — claude-opus-5-5, low effort. Dispatched by /orc-claude to create, update or refresh the repo-root CLAUDE.md." },
-  ] },
-  { family: "wiki-scanner", variants: [
-    { name: "orc-wiki-scanner-opus-5-low", model: "claude-opus-5-5", effort: "low",
-      desc: "ORC Wiki Scanner — claude-opus-5-5, low effort. Dispatched by orc-wiki per scan-task (DEEP tier), ONE coverage area each." },
-  ] },
-];
-
-
-// Line endings are NOT content here: .gitattributes stores these files with LF
-// and checks them out native, so a Windows worktree is CRLF and a Linux one LF.
-// The injected frontmatter line therefore borrows the TEMPLATE's own ending, and
-// --check compares LF-normalized text — otherwise the guard fails on Windows for
-// a difference git itself does not record.
-const eolOf = (s) => (/\r\n/.test(s) ? "\r\n" : "\n");
-const lf = (s) => s.replace(/\r\n/g, "\n");
-
-function render(template, v) {
-  const effortDesc = v.effort ? `, ${v.effort} effort` : " (no effort ladder)";
-  const effortFm = v.effort ? `effort: ${v.effort}${eolOf(template)}` : "";
-  return template
-    .replace(/\{\{NAME\}\}/g, v.name)
-    .replace(/\{\{MODEL\}\}/g, v.model)
-    .replace(/\{\{EFFORT_DESC\}\}/g, effortDesc)
-    .replace(/\{\{EFFORT_FM\}\}/g, effortFm)
-    .replace(/\{\{BAND\}\}/g, v.band);
-}
-
-function renderTwin(template, v) {
-  return template
-    .replace(/\{\{NAME\}\}/g, v.name)
-    .replace(/\{\{MODEL\}\}/g, v.model)
-    .replace(/\{\{EFFORT\}\}/g, v.effort)
-    .replace(/\{\{DESC\}\}/g, v.desc)
-    .replace(/\{\{WHO\}\}/g, v.who || "");
-}
-
-// Every [template, row, renderer] the generator owns, executors first.
-function jobs() {
-  const template = fs.readFileSync(TEMPLATE, "utf8");
-  if (/\{\{(?!NAME|MODEL|EFFORT_DESC|EFFORT_FM|BAND)\w/.test(template)) {
-    console.error("❌ build-agents: unknown {{placeholder}} in executor.template.md");
-    process.exit(1);
-  }
-  const out = VARIANTS.map((v) => ({ v, out: render(template, v), src: "agents-src/executor.template.md" }));
-  for (const fam of TWINS) {
-    const src = "agents-src/twins/" + fam.family + ".template.md";
-    const t = fs.readFileSync(path.join(TWIN_DIR, fam.family + ".template.md"), "utf8");
-    if (/\{\{(?!(?:NAME|MODEL|EFFORT|DESC|WHO)\}\})\w/.test(t)) {
-      console.error("❌ build-agents: unknown {{placeholder}} in " + src);
-      process.exit(1);
-    }
-    if (/\{\{WHO\}\}/.test(t) !==fam.variants.every((v) => v.who)) {
-      console.error("❌ build-agents: " + src + " and its TWINS rows disagree about {{WHO}}");
-      process.exit(1);
-    }
-    for (const v of fam.variants) out.push({ v, out: renderTwin(t, v), src });
-  }
-  return out;
-}
-
-function main() {
-  const checkMode = process.argv.includes("--check");
-  const all = jobs();
-  let drifted = 0;
-  for (const { v, out, src } of all) {
-    const dest = path.join(OUT_DIR, v.name + ".md");
-    if (checkMode) {
-      const current = fs.existsSync(dest) ? fs.readFileSync(dest, "utf8") : null;
-      if (current === null || lf(current) !== lf(out)) {
-        drifted++;
-        console.error(
-          `❌ generated agent drifted: templates/agents/${v.name}.md\n` +
-            `   This agent is GENERATED — edit ${src}\n` +
-            `   (or the VARIANTS / TWINS table in bin/build-agents.js) and run: npm run build:agents`
-        );
-      }
-    } else {
-      fs.writeFileSync(dest, out);
-      console.log(`  gen  templates/agents/${v.name}.md`);
-    }
-  }
-
-  if (checkMode) {
-    if (drifted) process.exit(1);
-    const twins = all.length - VARIANTS.length;
-    console.log(
-      `✅ ORC executor agents OK — ${VARIANTS.length} files match the template; ${twins} model twins match agents-src/twins/.`
-    );
-  }
-}
-
-// Required by test/payload.test.js, which checks the line-ending rule above
-// without writing to templates/agents/.
-module.exports = { VARIANTS, TWINS, render, renderTwin, lf, eolOf };
-
-if (require.main === module) main();
+#!/usr/bin/env node
+"use strict";
+/**
+ * Agent generator. Two sets, one rule: a file that differs from its siblings
+ * ONLY in frontmatter and the "You are … (<model>, <effort>)" line is GENERATED.
+ *
+ *   1. The 10 executors — agents-src/executor.template.md × VARIANTS
+ *      (name/model/effort + score band).
+ *   2. The 8 model-twin pairs (v2.0.0 T15) — agents-src/twins/<family>.template.md
+ *      × TWINS (name/model/effort/description + the `who` line). One body per
+ *      family: before T15 each pair was two hand-kept copies that nothing
+ *      checked against each other.
+ *
+ * Edit the template (or the table), run `npm run build:agents`, and every copy
+ * is stamped out identically. A model change is still a RENAME: a new row, not
+ * an edited one.
+ *
+ * Modes:
+ *   node bin/build-agents.js          write both sets into templates/agents/
+ *   node bin/build-agents.js --check  fail if any generated file drifted from
+ *                                     its template (runs in `npm run verify`
+ *                                     and prepack — a hand-edit to a generated
+ *                                     agent file fails the build)
+ */
+const fs = require("fs");
+const path = require("path");
+
+const ROOT = path.join(__dirname, "..");
+const TEMPLATE = path.join(ROOT, "agents-src", "executor.template.md");
+const OUT_DIR = path.join(ROOT, "templates", "agents");
+
+// Score→model bands mirror templates/agents/MODEL-MAPPING.md and the single
+// score→model table in skills/orc/config.md (documented drift — change
+// together). `effort: null` = a model with NO effort ladder (haiku): the
+// generator omits the `effort:` frontmatter line entirely.
+//
+// v1.0.0 W4 — the table was SIX bands, not eight, and the `opus5_only` ladder is
+// TWO, not three. v2.1.0 made the table FIVE bands (Sonnet 5 low/med/high, then
+// Opus 5.5 low/med). Seven of these agents are named by NO default row:
+// names them, and they ship anyway (D14). They stay reachable through
+// `rubric_bands_override`, `orc diy` `fixed_executor` and `extra_fallback_agent`,
+// and deleting a generated file that no row happens to name today would be a
+// rename-shaped migration for what is only a table change. Their `band` string
+// says so rather than naming a range that no longer exists — a band label that
+// lies is worse than one that admits it is unreachable by default.
+const VARIANTS = [
+  { name: "orc-executor-opus-5-med",     model: "claude-opus-5-5",     effort: "medium", band: "highest-complexity [90,100]" },
+  { name: "orc-executor-opus-5-low",     model: "claude-opus-5-5",     effort: "low",    band: "upper-complexity [41,90)" },
+  { name: "orc-executor-sonnet-5-high",  model: "claude-sonnet-5-5",  effort: "high",   band: "mid-complexity [31,41)" },
+  { name: "orc-executor-sonnet-5-med",   model: "claude-sonnet-5-5",  effort: "medium", band: "low-complexity [21,31)" },
+  { name: "orc-executor-sonnet-5-low",   model: "claude-sonnet-5-5",  effort: "low",    band: "lowest-complexity [0,21)" },
+  // NAMED BY NO BAND since v1.0.0 W4 / v2.1.0 (D14) — kept on disk, dispatched
+  // only when a user names one explicitly.
+  { name: "orc-executor-sonnet-4-6-high", model: "claude-sonnet-4-6", effort: "high",  band: "none (opt-in only, see MODEL-MAPPING.md)" },
+  { name: "orc-executor-sonnet-4-6-med", model: "claude-sonnet-4-6", effort: "medium", band: "none (opt-in only, see MODEL-MAPPING.md)" },
+  { name: "orc-executor-haiku-4-5",      model: "claude-haiku-4-5",  effort: null,     band: "none (opt-in only, see MODEL-MAPPING.md)" },
+  { name: "orc-executor-opus-5-high",    model: "claude-opus-5-5",    effort: "high",   band: "none (opt-in only, see MODEL-MAPPING.md)" },
+  { name: "orc-executor-opus-4-8-high",  model: "claude-opus-4-8",  effort: "high",   band: "none (opt-in only, see MODEL-MAPPING.md)" },
+  { name: "orc-executor-opus-4-7-high",  model: "claude-opus-4-7",  effort: "high",   band: "none (opt-in only, see MODEL-MAPPING.md)" },
+  { name: "orc-executor-opus-4-7-med",   model: "claude-opus-4-7",  effort: "medium", band: "none (opt-in only, see MODEL-MAPPING.md)" },
+];
+
+// v2.0.0 T15 — the model twins. Each family is one template under
+// agents-src/twins/; a row fills five placeholders: {{NAME}}, {{MODEL}},
+// {{EFFORT}}, {{DESC}} (the one-line frontmatter description) and {{WHO}} (the
+// "(Sonnet 5, high)" part of the "You are …" line — absent for a family whose
+// body never names its own model). The pair is a runtime choice (`opus5_only`,
+// the recon gate, the wiki tier ladder), so both halves always ship.
+const TWIN_DIR = path.join(ROOT, "agents-src", "twins");
+const TWINS = [
+  { family: "analyze-mini", variants: [
+    { name: "orc-analyze-mini-sonnet-5-high", model: "claude-sonnet-5-5", effort: "high", who: "Sonnet 5, high",
+      desc: "ORC mini System Analyst — claude-sonnet-5-5, high effort. Dispatched by /orc-mini and /orc-analyze-mini at analysis: single pass, no deep mode, no scouts." },
+    { name: "orc-analyze-mini-opus-5-med", model: "claude-opus-5-5", effort: "medium", who: "Opus 5.5, medium",
+      desc: "ORC mini System Analyst — claude-opus-5-5, medium effort. Dispatched by /orc-mini and /orc-analyze-mini, instead of orc-analyze-mini-sonnet-5-high when `opus5_only: true`." },
+  ] },
+  { family: "planner-mini", variants: [
+    { name: "orc-planner-mini-sonnet-5-high", model: "claude-sonnet-5-5", effort: "high", who: "Sonnet 5, high",
+      desc: "ORC mini Requirement Planner — claude-sonnet-5-5, high effort. Dispatched by /orc-mini at planning." },
+    { name: "orc-planner-mini-opus-5-med", model: "claude-opus-5-5", effort: "medium", who: "Opus 5.5, medium",
+      desc: "ORC mini Requirement Planner — claude-opus-5-5, medium effort. Dispatched by /orc-mini at planning, instead of orc-planner-mini-sonnet-5-high when `opus5_only: true`." },
+  ] },
+  { family: "pattern-codifier", variants: [
+    { name: "orc-pattern-codifier-sonnet-5-high", model: "claude-sonnet-5-5", effort: "high",
+      desc: "ORC Pattern Codifier — claude-sonnet-5-5, high effort. Dispatched by orc-pattern (lazy /orc miss, eager orc-wiki, or manual /orc-pattern) for ONE language." },
+    { name: "orc-pattern-codifier-opus-5-med", model: "claude-opus-5-5", effort: "medium",
+      desc: "ORC Pattern Codifier — claude-opus-5-5, medium effort. Dispatched by orc-pattern, instead of orc-pattern-codifier-sonnet-5-high when `opus5_only: true`." },
+  ] },
+  { family: "recon", variants: [
+    { name: "orc-recon-sonnet-5-med", model: "claude-sonnet-5-5", effort: "medium", who: "Sonnet 5, medium",
+      desc: "ORC Recon — claude-sonnet-5-5, medium effort. Dispatched by /orc-quick at the dispatch gate, for a read-only question. It never edits." },
+    { name: "orc-recon-opus-5-low", model: "claude-opus-5-5", effort: "low", who: "Opus 5.5, low",
+      desc: "ORC Recon — claude-opus-5-5, low effort. Dispatched by /orc-quick at the dispatch gate, for a WIDE or SUBTLE read-only question. It never edits." },
+  ] },
+  { family: "retro", variants: [
+    { name: "orc-retro-sonnet-5-high", model: "claude-sonnet-5-5", effort: "high", who: "Sonnet 5, high",
+      desc: "ORC Retro miner — claude-sonnet-5-5, high effort. Dispatched by /orc-retro to mine the behavior traces. Read-only, report-only." },
+    { name: "orc-retro-opus-5-med", model: "claude-opus-5-5", effort: "medium", who: "Opus 5.5, medium",
+      desc: "ORC Retro miner — claude-opus-5-5, medium effort. Dispatched by /orc-retro, instead of orc-retro-sonnet-5-high when `opus5_only: true`. Read-only." },
+  ] },
+  { family: "scout", variants: [
+    { name: "orc-scout-sonnet-4-6-high", model: "claude-sonnet-4-6", effort: "high", who: "Sonnet 4.6, high",
+      desc: "ORC Code Scout — claude-sonnet-4-6, high effort. Dispatched by orc in the analyst's DEEP mode (≤max_scouts in parallel), ONE coverage area each." },
+    { name: "orc-scout-opus-5-low", model: "claude-opus-5-5", effort: "low", who: "Opus 5.5, low",
+      desc: "ORC Code Scout — claude-opus-5-5, low effort. Dispatched by orc in the analyst's DEEP mode, instead of orc-scout-sonnet-4-6-high when `opus5_only: true`." },
+  ] },
+  { family: "claude-writer", variants: [
+    { name: "orc-claude-writer-opus-5-low", model: "claude-opus-5-5", effort: "low", who: "Opus 5.5, low",
+      desc: "ORC CLAUDE.md Writer — claude-opus-5-5, low effort. Dispatched by /orc-claude to create, update or refresh the repo-root CLAUDE.md." },
+  ] },
+  { family: "wiki-scanner", variants: [
+    { name: "orc-wiki-scanner-opus-5-low", model: "claude-opus-5-5", effort: "low",
+      desc: "ORC Wiki Scanner — claude-opus-5-5, low effort. Dispatched by orc-wiki per scan-task (DEEP tier), ONE coverage area each." },
+  ] },
+];
+
+
+// Line endings are NOT content here: .gitattributes stores these files with LF
+// and checks them out native, so a Windows worktree is CRLF and a Linux one LF.
+// The injected frontmatter line therefore borrows the TEMPLATE's own ending, and
+// --check compares LF-normalized text — otherwise the guard fails on Windows for
+// a difference git itself does not record.
+const eolOf = (s) => (/\r\n/.test(s) ? "\r\n" : "\n");
+const lf = (s) => s.replace(/\r\n/g, "\n");
+
+function render(template, v) {
+  const effortDesc = v.effort ? `, ${v.effort} effort` : " (no effort ladder)";
+  const effortFm = v.effort ? `effort: ${v.effort}${eolOf(template)}` : "";
+  return template
+    .replace(/\{\{NAME\}\}/g, v.name)
+    .replace(/\{\{MODEL\}\}/g, v.model)
+    .replace(/\{\{EFFORT_DESC\}\}/g, effortDesc)
+    .replace(/\{\{EFFORT_FM\}\}/g, effortFm)
+    .replace(/\{\{BAND\}\}/g, v.band);
+}
+
+function renderTwin(template, v) {
+  return template
+    .replace(/\{\{NAME\}\}/g, v.name)
+    .replace(/\{\{MODEL\}\}/g, v.model)
+    .replace(/\{\{EFFORT\}\}/g, v.effort)
+    .replace(/\{\{DESC\}\}/g, v.desc)
+    .replace(/\{\{WHO\}\}/g, v.who || "");
+}
+
+// Every [template, row, renderer] the generator owns, executors first.
+function jobs() {
+  const template = fs.readFileSync(TEMPLATE, "utf8");
+  if (/\{\{(?!NAME|MODEL|EFFORT_DESC|EFFORT_FM|BAND)\w/.test(template)) {
+    console.error("❌ build-agents: unknown {{placeholder}} in executor.template.md");
+    process.exit(1);
+  }
+  const out = VARIANTS.map((v) => ({ v, out: render(template, v), src: "agents-src/executor.template.md" }));
+  for (const fam of TWINS) {
+    const src = "agents-src/twins/" + fam.family + ".template.md";
+    const t = fs.readFileSync(path.join(TWIN_DIR, fam.family + ".template.md"), "utf8");
+    if (/\{\{(?!(?:NAME|MODEL|EFFORT|DESC|WHO)\}\})\w/.test(t)) {
+      console.error("❌ build-agents: unknown {{placeholder}} in " + src);
+      process.exit(1);
+    }
+    if (/\{\{WHO\}\}/.test(t) !==fam.variants.every((v) => v.who)) {
+      console.error("❌ build-agents: " + src + " and its TWINS rows disagree about {{WHO}}");
+      process.exit(1);
+    }
+    for (const v of fam.variants) out.push({ v, out: renderTwin(t, v), src });
+  }
+  return out;
+}
+
+function main() {
+  const checkMode = process.argv.includes("--check");
+  const all = jobs();
+  let drifted = 0;
+  for (const { v, out, src } of all) {
+    const dest = path.join(OUT_DIR, v.name + ".md");
+    if (checkMode) {
+      const current = fs.existsSync(dest) ? fs.readFileSync(dest, "utf8") : null;
+      if (current === null || lf(current) !== lf(out)) {
+        drifted++;
+        console.error(
+          `❌ generated agent drifted: templates/agents/${v.name}.md\n` +
+            `   This agent is GENERATED — edit ${src}\n` +
+            `   (or the VARIANTS / TWINS table in bin/build-agents.js) and run: npm run build:agents`
+        );
+      }
+    } else {
+      fs.writeFileSync(dest, out);
+      console.log(`  gen  templates/agents/${v.name}.md`);
+    }
+  }
+
+  if (checkMode) {
+    if (drifted) process.exit(1);
+    const twins = all.length - VARIANTS.length;
+    console.log(
+      `✅ ORC executor agents OK — ${VARIANTS.length} files match the template; ${twins} model twins match agents-src/twins/.`
+    );
+  }
+}
+
+// Required by test/payload.test.js, which checks the line-ending rule above
+// without writing to templates/agents/.
+module.exports = { VARIANTS, TWINS, render, renderTwin, lf, eolOf };
+
+if (require.main === module) main();