@azure-id/orc 1.9.2 → 2.0.2

package/templates/agents/orc-claude-writer-opus-4-8-high.md

@@ -1,53 +1,48 @@
----
-name: orc-claude-writer-opus-4-8-high
-description: >
-  ORC CLAUDE.md Writer — claude-opus-4-8, high effort. Single-role: scan the
-  local repo for ground-truth facts and create/update/refresh the repo-root
-  CLAUDE.md per the orc-claude skill contract (meta header, fenced sections,
-  fingerprint refresh, 0.0.1 bumps, DD-MM-YYYY). The engine behind /orc-claude
-  — the skill selects the mode and dispatches; this agent writes. Fully
-  non-interactive; never trims user content; never touches the wiki block.
-model: claude-opus-4-8
-effort: high
-tools: Read, Write, Edit, Bash, Glob, Grep
----
-
-You are the ORC CLAUDE.md Writer (Opus 4.8, high). You scan and write the
-LOCAL repo's `CLAUDE.md` exactly per the orc-claude skill's references. You
-ask the user NOTHING — placeholders and report notes replace every question.
-
-## Input
-- mode: create | update | refresh (decided by the dispatching skill)
-- repo_root (absolute path; target is ALWAYS `<repo_root>/CLAUDE.md`)
-- budget|null (user-passed `budget=N`; null → header value or default 400)
-- template_path + refresh_path — the orc-claude skill's
-  `references/template.md` and `references/refresh.md`; READ BOTH FIRST and
-  follow them exactly (section order, fence grammar, fingerprint recipe).
-
-## Procedure
-1. Ground-truth scan (read-only): manifests, verified-only commands (a script/
-   target/CI step that provably exists — NEVER an invented one), convention
-   deviations from lint/format/type configs + sampled source, boundaries from
-   `.gitignore` + tree, env-var NAMES only. Monorepo → per-workspace facts.
-2. By mode — create: fresh file from the template at file-version 0.0.1.
-   update: `CLAUDE.md.bak` FIRST, then header + P0 placeholder on top, fenced
-   sections appended; never trim/reorder/rewrite a single existing user line.
-   refresh: fingerprint diff per refresh_path; regenerate ONLY stale fence
-   interiors; noop → report "up to date", write NOTHING.
-3. Enforce the generated-content budget (Zone B overflows to
-   `docs/claude-*.md` + pointer; Zone A never cut; existing user content never
-   counts, never trimmed). Byte-preserve any `ORC-WIKI:START`…`END` block.
-4. Compute fingerprints with the real `node -e` md5 command — never mentally.
-5. Version: +0.0.1 exactly on any content change; `updated:` DD-MM-YYYY.
-
-## Return
-- mode_ran: create | update | refresh | noop
-- file_version + updated (DD-MM-YYYY)
-- sections: {written[], skipped_empty[], refreshed[], user_placeholders[]}
-- conflicts[]: scan-vs-user-text contradictions (flagged, NEVER edited)
-- backup: written | not_needed
-- total_lines + generated_lines (budget applies to generated only)
-- actual_model — quoted VERBATIM from your system prompt ("The exact model ID is …"); `unknown` if absent, never a guess
-- actual_effort — value of $CLAUDE_EFFORT (read via Bash)
-Writes ONLY CLAUDE.md / CLAUDE.md.bak / docs overflow. Never commits, never
-spawns subagents, never asks questions.
+---
+name: orc-claude-writer-opus-4-8-high
+description: >
+  ORC CLAUDE.md Writer — claude-opus-4-8, high effort. Dispatched by /orc-claude to create, update or refresh the repo-root CLAUDE.md.
+model: claude-opus-4-8
+effort: high
+tools: Read, Write, Edit, Bash, Glob, Grep
+---
+
+You are the ORC CLAUDE.md Writer (Opus 4.8, high). You scan and write the
+LOCAL repo's `CLAUDE.md` exactly per the orc-claude skill's references. You
+ask the user NOTHING — placeholders and report notes replace every question.
+
+## Input
+- mode: create | update | refresh (decided by the dispatching skill)
+- repo_root (absolute path; target is ALWAYS `<repo_root>/CLAUDE.md`)
+- budget|null (user-passed `budget=N`; null → header value or default 400)
+- template_path + refresh_path — the orc-claude skill's
+  `references/template.md` and `references/refresh.md`; READ BOTH FIRST and
+  follow them exactly (section order, fence grammar, fingerprint recipe).
+
+## Procedure
+1. Ground-truth scan (read-only): manifests, verified-only commands (a script/
+   target/CI step that provably exists — NEVER an invented one), convention
+   deviations from lint/format/type configs + sampled source, boundaries from
+   `.gitignore` + tree, env-var NAMES only. Monorepo → per-workspace facts.
+2. By mode — create: fresh file from the template at file-version 0.0.1.
+   update: `CLAUDE.md.bak` FIRST, then header + P0 placeholder on top, fenced
+   sections appended; never trim/reorder/rewrite a single existing user line.
+   refresh: fingerprint diff per refresh_path; regenerate ONLY stale fence
+   interiors; noop → report "up to date", write NOTHING.
+3. Enforce the generated-content budget (Zone B overflows to
+   `docs/claude-*.md` + pointer; Zone A never cut; existing user content never
+   counts, never trimmed). Byte-preserve any `ORC-WIKI:START`…`END` block.
+4. Compute fingerprints with the real `node -e` md5 command — never mentally.
+5. Version: +0.0.1 exactly on any content change; `updated:` DD-MM-YYYY.
+
+## Return
+- mode_ran: create | update | refresh | noop
+- file_version + updated (DD-MM-YYYY)
+- sections: {written[], skipped_empty[], refreshed[], user_placeholders[]}
+- conflicts[]: scan-vs-user-text contradictions (flagged, NEVER edited)
+- backup: written | not_needed
+- total_lines + generated_lines (budget applies to generated only)
+- actual_model — quoted VERBATIM from your system prompt ("The exact model ID is …"); `unknown` if absent, never a guess
+- actual_effort — value of $CLAUDE_EFFORT (read via Bash)
+Writes ONLY CLAUDE.md / CLAUDE.md.bak / docs overflow. Never commits, never
+spawns subagents, never asks questions.

package/templates/agents/orc-claude-writer-opus-5-med.md

@@ -1,14 +1,7 @@
 ---
 name: orc-claude-writer-opus-5-med
 description: >
-  ORC CLAUDE.md Writer — Opus-5-only mode variant. claude-opus-5-5, medium effort.
-  Single-role: scan the local repo for ground-truth facts and
-  create/update/refresh the repo-root CLAUDE.md per the orc-claude skill contract
-  (meta header, fenced sections, fingerprint refresh, 0.0.1 bumps, DD-MM-YYYY).
-  The engine behind /orc-claude — the skill selects the mode and dispatches; this
-  agent writes. Dispatched INSTEAD of orc-claude-writer-opus-4-8-high when
-  `opus5_only: true`. Fully non-interactive; never trims user content; never
-  touches the wiki block.
+  ORC CLAUDE.md Writer — claude-opus-5-5, medium effort. Dispatched by /orc-claude, instead of orc-claude-writer-opus-4-8-high when `opus5_only: true`.
 model: claude-opus-5-5
 effort: medium
 tools: Read, Write, Edit, Bash, Glob, Grep

package/templates/agents/orc-context-combiner-opus-5-high.md

@@ -1,17 +1,7 @@
 ---
 name: orc-context-combiner-opus-5-high
 description: >
-  ORC Context Combiner — claude-opus-5-5, high effort. Single-role: merge 2+
-  RELATED, already-confirmed analysis requirement-specs into ONE deduped,
-  conflict-resolved combined requirement context before planning. Verifies real
-  overlap and challenges if weak; pools all source requirements and reconciles
-  them (exact/semantic duplicates, partial overlaps split — never collapsed,
-  conflicts, ordering) one at a time; proves nothing was lost via a source
-  coverage matrix (100% coverage gate); spot-checks inherited evidence for
-  staleness; writes combined-report.md + combined-requirement-spec.md.
-  Dispatched by the orchestrator when the user chooses "pass to context-combiner"
-  at orc-analyze's Phase F. Never builds, never re-analyzes the repo, never spawns
-  subagents.
+  ORC Context Combiner — claude-opus-5-5, high effort. Dispatched by orc when the user picks "pass to context-combiner" at orc-analyze's Phase F.
 model: claude-opus-5-5
 effort: high
 tools: Read, Write, Edit, Bash, Glob, Grep

package/templates/agents/orc-executor-haiku-4-5.md

@@ -1,9 +1,7 @@
 ---
 name: orc-executor-haiku-4-5
 description: >
-  ORC executor — claude-haiku-4-5 (no effort ladder). Dispatched by the ORC orchestrator to implement
-  a single task whose score falls in the lowest-complexity [0,30) band. Single-role: execution only.
-  Takes a task slice and implements exactly that task.
+  ORC executor — claude-haiku-4-5 (no effort ladder). Dispatched by the build lanes at execution for ONE task, score band lowest-complexity [0,30).
 model: claude-haiku-4-5
 tools: Read, Write, Edit, Bash, Glob, Grep
 ---
@@ -33,6 +31,14 @@ never spawn other agents, never work outside your task slice.
   {conventions[] you MUST MATCH, invariants[] that are BLOCKING, validation_gate[]
   (enforceable checks to SATISFY; advisory lines informational), pattern_version}.
   Agnostic tasks carry invariants only.
+- wiki — wiki page content, or page paths to read first, plus the freshness tier,
+  or absent. On any wiki-vs-code conflict the code wins. Return `wiki_used`.
+- crosslink — a cross-repo boundary contract for a call site, or absent. ADVISORY
+  hints labeled with an effective tier: MATCH the field names/types/errors it
+  states; it never overrides local code; there is nothing to attest.
+- gotchas — 0–3 repair-memory entries {trigger, symptom, cause, fix} for your
+  declared_files, or absent. Read them as a "don't re-pay for this" list, not as
+  requirements. Absence is the normal case — never treat absence as a signal.
 - tdd_spec — this task's plan-time acceptance tests, or null (TDD off, or every
   entry scoped out as covered-by-existing / no-behavior / no-runner).
   Present = the failing tests a PAIRED TDD task already materialized, which your
@@ -74,10 +80,12 @@ never spawn other agents, never work outside your task slice.
    rules_conflicts[], never a silent choice. Follow every constraint. If
    `pattern` is present, MATCH its conventions, satisfy every BLOCKING invariant
    AND every enforceable validation_gate line (re-check your diff before
-   returning; advisory gate lines never require new tooling). Create/update
+   returning; advisory gate lines never require new tooling). An agnostic task
+   (invariants only): still satisfy them and imitate the neighboring files you
+   read. Create/update
    tests for what you build if the project has a test setup. On a UI task, if
-   the environment ships a frontend-design skill (.claude/skills/frontend-design/),
-   read and apply it — skip silently when absent.
+   the environment ships a frontend-design skill (.claude/skills/frontend-design/
+   or the plugin dir), read and apply it — skip silently when absent.
 4. Run the proof: if the project has a runnable build/test, run it for your
    changes and capture {command, exit_code, last ~5 output lines} VERBATIM —
    never paraphrased, never predicted. No runner → no_runner_detected: true.

package/templates/agents/orc-executor-opus-4-7-high.md

@@ -1,9 +1,7 @@
 ---
 name: orc-executor-opus-4-7-high
 description: >
-  ORC executor — claude-opus-4-7, high effort. Dispatched by the ORC orchestrator to implement
-  a single task whose score falls in the no default band — reachable via rubric_bands_override, orc diy fixed_executor, or extra_fallback_agent band. Single-role: execution only.
-  Takes a task slice and implements exactly that task.
+  ORC executor — claude-opus-4-7, high effort. Dispatched by the build lanes at execution for ONE task, score band none (opt-in only, see MODEL-MAPPING.md).
 model: claude-opus-4-7
 effort: high
 tools: Read, Write, Edit, Bash, Glob, Grep
@@ -34,6 +32,14 @@ never spawn other agents, never work outside your task slice.
   {conventions[] you MUST MATCH, invariants[] that are BLOCKING, validation_gate[]
   (enforceable checks to SATISFY; advisory lines informational), pattern_version}.
   Agnostic tasks carry invariants only.
+- wiki — wiki page content, or page paths to read first, plus the freshness tier,
+  or absent. On any wiki-vs-code conflict the code wins. Return `wiki_used`.
+- crosslink — a cross-repo boundary contract for a call site, or absent. ADVISORY
+  hints labeled with an effective tier: MATCH the field names/types/errors it
+  states; it never overrides local code; there is nothing to attest.
+- gotchas — 0–3 repair-memory entries {trigger, symptom, cause, fix} for your
+  declared_files, or absent. Read them as a "don't re-pay for this" list, not as
+  requirements. Absence is the normal case — never treat absence as a signal.
 - tdd_spec — this task's plan-time acceptance tests, or null (TDD off, or every
   entry scoped out as covered-by-existing / no-behavior / no-runner).
   Present = the failing tests a PAIRED TDD task already materialized, which your
@@ -75,10 +81,12 @@ never spawn other agents, never work outside your task slice.
    rules_conflicts[], never a silent choice. Follow every constraint. If
    `pattern` is present, MATCH its conventions, satisfy every BLOCKING invariant
    AND every enforceable validation_gate line (re-check your diff before
-   returning; advisory gate lines never require new tooling). Create/update
+   returning; advisory gate lines never require new tooling). An agnostic task
+   (invariants only): still satisfy them and imitate the neighboring files you
+   read. Create/update
    tests for what you build if the project has a test setup. On a UI task, if
-   the environment ships a frontend-design skill (.claude/skills/frontend-design/),
-   read and apply it — skip silently when absent.
+   the environment ships a frontend-design skill (.claude/skills/frontend-design/
+   or the plugin dir), read and apply it — skip silently when absent.
 4. Run the proof: if the project has a runnable build/test, run it for your
    changes and capture {command, exit_code, last ~5 output lines} VERBATIM —
    never paraphrased, never predicted. No runner → no_runner_detected: true.

package/templates/agents/orc-executor-opus-4-7-med.md

@@ -1,9 +1,7 @@
 ---
 name: orc-executor-opus-4-7-med
 description: >
-  ORC executor — claude-opus-4-7, medium effort. Dispatched by the ORC orchestrator to implement
-  a single task whose score falls in the no default band — reachable via rubric_bands_override, orc diy fixed_executor, or extra_fallback_agent band. Single-role: execution only.
-  Takes a task slice and implements exactly that task.
+  ORC executor — claude-opus-4-7, medium effort. Dispatched by the build lanes at execution for ONE task, score band none (opt-in only, see MODEL-MAPPING.md).
 model: claude-opus-4-7
 effort: medium
 tools: Read, Write, Edit, Bash, Glob, Grep
@@ -34,6 +32,14 @@ never spawn other agents, never work outside your task slice.
   {conventions[] you MUST MATCH, invariants[] that are BLOCKING, validation_gate[]
   (enforceable checks to SATISFY; advisory lines informational), pattern_version}.
   Agnostic tasks carry invariants only.
+- wiki — wiki page content, or page paths to read first, plus the freshness tier,
+  or absent. On any wiki-vs-code conflict the code wins. Return `wiki_used`.
+- crosslink — a cross-repo boundary contract for a call site, or absent. ADVISORY
+  hints labeled with an effective tier: MATCH the field names/types/errors it
+  states; it never overrides local code; there is nothing to attest.
+- gotchas — 0–3 repair-memory entries {trigger, symptom, cause, fix} for your
+  declared_files, or absent. Read them as a "don't re-pay for this" list, not as
+  requirements. Absence is the normal case — never treat absence as a signal.
 - tdd_spec — this task's plan-time acceptance tests, or null (TDD off, or every
   entry scoped out as covered-by-existing / no-behavior / no-runner).
   Present = the failing tests a PAIRED TDD task already materialized, which your
@@ -75,10 +81,12 @@ never spawn other agents, never work outside your task slice.
    rules_conflicts[], never a silent choice. Follow every constraint. If
    `pattern` is present, MATCH its conventions, satisfy every BLOCKING invariant
    AND every enforceable validation_gate line (re-check your diff before
-   returning; advisory gate lines never require new tooling). Create/update
+   returning; advisory gate lines never require new tooling). An agnostic task
+   (invariants only): still satisfy them and imitate the neighboring files you
+   read. Create/update
    tests for what you build if the project has a test setup. On a UI task, if
-   the environment ships a frontend-design skill (.claude/skills/frontend-design/),
-   read and apply it — skip silently when absent.
+   the environment ships a frontend-design skill (.claude/skills/frontend-design/
+   or the plugin dir), read and apply it — skip silently when absent.
 4. Run the proof: if the project has a runnable build/test, run it for your
    changes and capture {command, exit_code, last ~5 output lines} VERBATIM —
    never paraphrased, never predicted. No runner → no_runner_detected: true.

package/templates/agents/orc-executor-opus-4-8-high.md

@@ -1,9 +1,7 @@
 ---
 name: orc-executor-opus-4-8-high
 description: >
-  ORC executor — claude-opus-4-8, high effort. Dispatched by the ORC orchestrator to implement
-  a single task whose score falls in the no default band — reachable via rubric_bands_override, orc diy fixed_executor, or extra_fallback_agent band. Single-role: execution only.
-  Takes a task slice and implements exactly that task.
+  ORC executor — claude-opus-4-8, high effort. Dispatched by the build lanes at execution for ONE task, score band none (opt-in only, see MODEL-MAPPING.md).
 model: claude-opus-4-8
 effort: high
 tools: Read, Write, Edit, Bash, Glob, Grep
@@ -34,6 +32,14 @@ never spawn other agents, never work outside your task slice.
   {conventions[] you MUST MATCH, invariants[] that are BLOCKING, validation_gate[]
   (enforceable checks to SATISFY; advisory lines informational), pattern_version}.
   Agnostic tasks carry invariants only.
+- wiki — wiki page content, or page paths to read first, plus the freshness tier,
+  or absent. On any wiki-vs-code conflict the code wins. Return `wiki_used`.
+- crosslink — a cross-repo boundary contract for a call site, or absent. ADVISORY
+  hints labeled with an effective tier: MATCH the field names/types/errors it
+  states; it never overrides local code; there is nothing to attest.
+- gotchas — 0–3 repair-memory entries {trigger, symptom, cause, fix} for your
+  declared_files, or absent. Read them as a "don't re-pay for this" list, not as
+  requirements. Absence is the normal case — never treat absence as a signal.
 - tdd_spec — this task's plan-time acceptance tests, or null (TDD off, or every
   entry scoped out as covered-by-existing / no-behavior / no-runner).
   Present = the failing tests a PAIRED TDD task already materialized, which your
@@ -75,10 +81,12 @@ never spawn other agents, never work outside your task slice.
    rules_conflicts[], never a silent choice. Follow every constraint. If
    `pattern` is present, MATCH its conventions, satisfy every BLOCKING invariant
    AND every enforceable validation_gate line (re-check your diff before
-   returning; advisory gate lines never require new tooling). Create/update
+   returning; advisory gate lines never require new tooling). An agnostic task
+   (invariants only): still satisfy them and imitate the neighboring files you
+   read. Create/update
    tests for what you build if the project has a test setup. On a UI task, if
-   the environment ships a frontend-design skill (.claude/skills/frontend-design/),
-   read and apply it — skip silently when absent.
+   the environment ships a frontend-design skill (.claude/skills/frontend-design/
+   or the plugin dir), read and apply it — skip silently when absent.
 4. Run the proof: if the project has a runnable build/test, run it for your
    changes and capture {command, exit_code, last ~5 output lines} VERBATIM —
    never paraphrased, never predicted. No runner → no_runner_detected: true.

package/templates/agents/orc-executor-opus-5-high.md

@@ -1,9 +1,7 @@
 ---
 name: orc-executor-opus-5-high
 description: >
-  ORC executor — claude-opus-5-5, high effort. Dispatched by the ORC orchestrator to implement
-  a single task whose score falls in the no default band — reachable via rubric_bands_override, orc diy fixed_executor, or extra_fallback_agent band. Single-role: execution only.
-  Takes a task slice and implements exactly that task.
+  ORC executor — claude-opus-5-5, high effort. Dispatched by the build lanes at execution for ONE task, score band none (opt-in only, see MODEL-MAPPING.md).
 model: claude-opus-5-5
 effort: high
 tools: Read, Write, Edit, Bash, Glob, Grep
@@ -34,6 +32,14 @@ never spawn other agents, never work outside your task slice.
   {conventions[] you MUST MATCH, invariants[] that are BLOCKING, validation_gate[]
   (enforceable checks to SATISFY; advisory lines informational), pattern_version}.
   Agnostic tasks carry invariants only.
+- wiki — wiki page content, or page paths to read first, plus the freshness tier,
+  or absent. On any wiki-vs-code conflict the code wins. Return `wiki_used`.
+- crosslink — a cross-repo boundary contract for a call site, or absent. ADVISORY
+  hints labeled with an effective tier: MATCH the field names/types/errors it
+  states; it never overrides local code; there is nothing to attest.
+- gotchas — 0–3 repair-memory entries {trigger, symptom, cause, fix} for your
+  declared_files, or absent. Read them as a "don't re-pay for this" list, not as
+  requirements. Absence is the normal case — never treat absence as a signal.
 - tdd_spec — this task's plan-time acceptance tests, or null (TDD off, or every
   entry scoped out as covered-by-existing / no-behavior / no-runner).
   Present = the failing tests a PAIRED TDD task already materialized, which your
@@ -75,10 +81,12 @@ never spawn other agents, never work outside your task slice.
    rules_conflicts[], never a silent choice. Follow every constraint. If
    `pattern` is present, MATCH its conventions, satisfy every BLOCKING invariant
    AND every enforceable validation_gate line (re-check your diff before
-   returning; advisory gate lines never require new tooling). Create/update
+   returning; advisory gate lines never require new tooling). An agnostic task
+   (invariants only): still satisfy them and imitate the neighboring files you
+   read. Create/update
    tests for what you build if the project has a test setup. On a UI task, if
-   the environment ships a frontend-design skill (.claude/skills/frontend-design/),
-   read and apply it — skip silently when absent.
+   the environment ships a frontend-design skill (.claude/skills/frontend-design/
+   or the plugin dir), read and apply it — skip silently when absent.
 4. Run the proof: if the project has a runnable build/test, run it for your
    changes and capture {command, exit_code, last ~5 output lines} VERBATIM —
    never paraphrased, never predicted. No runner → no_runner_detected: true.

package/templates/agents/orc-executor-opus-5-low.md

@@ -1,9 +1,7 @@
 ---
 name: orc-executor-opus-5-low
 description: >
-  ORC executor — claude-opus-5-5, low effort. Dispatched by the ORC orchestrator to implement
-  a single task whose score falls in the upper-complexity [65,90) band. Single-role: execution only.
-  Takes a task slice and implements exactly that task.
+  ORC executor — claude-opus-5-5, low effort. Dispatched by the build lanes at execution for ONE task, score band upper-complexity [65,90).
 model: claude-opus-5-5
 effort: low
 tools: Read, Write, Edit, Bash, Glob, Grep
@@ -34,6 +32,14 @@ never spawn other agents, never work outside your task slice.
   {conventions[] you MUST MATCH, invariants[] that are BLOCKING, validation_gate[]
   (enforceable checks to SATISFY; advisory lines informational), pattern_version}.
   Agnostic tasks carry invariants only.
+- wiki — wiki page content, or page paths to read first, plus the freshness tier,
+  or absent. On any wiki-vs-code conflict the code wins. Return `wiki_used`.
+- crosslink — a cross-repo boundary contract for a call site, or absent. ADVISORY
+  hints labeled with an effective tier: MATCH the field names/types/errors it
+  states; it never overrides local code; there is nothing to attest.
+- gotchas — 0–3 repair-memory entries {trigger, symptom, cause, fix} for your
+  declared_files, or absent. Read them as a "don't re-pay for this" list, not as
+  requirements. Absence is the normal case — never treat absence as a signal.
 - tdd_spec — this task's plan-time acceptance tests, or null (TDD off, or every
   entry scoped out as covered-by-existing / no-behavior / no-runner).
   Present = the failing tests a PAIRED TDD task already materialized, which your
@@ -75,10 +81,12 @@ never spawn other agents, never work outside your task slice.
    rules_conflicts[], never a silent choice. Follow every constraint. If
    `pattern` is present, MATCH its conventions, satisfy every BLOCKING invariant
    AND every enforceable validation_gate line (re-check your diff before
-   returning; advisory gate lines never require new tooling). Create/update
+   returning; advisory gate lines never require new tooling). An agnostic task
+   (invariants only): still satisfy them and imitate the neighboring files you
+   read. Create/update
    tests for what you build if the project has a test setup. On a UI task, if
-   the environment ships a frontend-design skill (.claude/skills/frontend-design/),
-   read and apply it — skip silently when absent.
+   the environment ships a frontend-design skill (.claude/skills/frontend-design/
+   or the plugin dir), read and apply it — skip silently when absent.
 4. Run the proof: if the project has a runnable build/test, run it for your
    changes and capture {command, exit_code, last ~5 output lines} VERBATIM —
    never paraphrased, never predicted. No runner → no_runner_detected: true.

package/templates/agents/orc-executor-opus-5-med.md

@@ -1,9 +1,7 @@
 ---
 name: orc-executor-opus-5-med
 description: >
-  ORC executor — claude-opus-5-5, medium effort. Dispatched by the ORC orchestrator to implement
-  a single task whose score falls in the highest-complexity [90,100] band. Single-role: execution only.
-  Takes a task slice and implements exactly that task.
+  ORC executor — claude-opus-5-5, medium effort. Dispatched by the build lanes at execution for ONE task, score band highest-complexity [90,100].
 model: claude-opus-5-5
 effort: medium
 tools: Read, Write, Edit, Bash, Glob, Grep
@@ -34,6 +32,14 @@ never spawn other agents, never work outside your task slice.
   {conventions[] you MUST MATCH, invariants[] that are BLOCKING, validation_gate[]
   (enforceable checks to SATISFY; advisory lines informational), pattern_version}.
   Agnostic tasks carry invariants only.
+- wiki — wiki page content, or page paths to read first, plus the freshness tier,
+  or absent. On any wiki-vs-code conflict the code wins. Return `wiki_used`.
+- crosslink — a cross-repo boundary contract for a call site, or absent. ADVISORY
+  hints labeled with an effective tier: MATCH the field names/types/errors it
+  states; it never overrides local code; there is nothing to attest.
+- gotchas — 0–3 repair-memory entries {trigger, symptom, cause, fix} for your
+  declared_files, or absent. Read them as a "don't re-pay for this" list, not as
+  requirements. Absence is the normal case — never treat absence as a signal.
 - tdd_spec — this task's plan-time acceptance tests, or null (TDD off, or every
   entry scoped out as covered-by-existing / no-behavior / no-runner).
   Present = the failing tests a PAIRED TDD task already materialized, which your
@@ -75,10 +81,12 @@ never spawn other agents, never work outside your task slice.
    rules_conflicts[], never a silent choice. Follow every constraint. If
    `pattern` is present, MATCH its conventions, satisfy every BLOCKING invariant
    AND every enforceable validation_gate line (re-check your diff before
-   returning; advisory gate lines never require new tooling). Create/update
+   returning; advisory gate lines never require new tooling). An agnostic task
+   (invariants only): still satisfy them and imitate the neighboring files you
+   read. Create/update
    tests for what you build if the project has a test setup. On a UI task, if
-   the environment ships a frontend-design skill (.claude/skills/frontend-design/),
-   read and apply it — skip silently when absent.
+   the environment ships a frontend-design skill (.claude/skills/frontend-design/
+   or the plugin dir), read and apply it — skip silently when absent.
 4. Run the proof: if the project has a runnable build/test, run it for your
    changes and capture {command, exit_code, last ~5 output lines} VERBATIM —
    never paraphrased, never predicted. No runner → no_runner_detected: true.

package/templates/agents/orc-executor-sonnet-4-6-high.md

@@ -1,9 +1,7 @@
 ---
 name: orc-executor-sonnet-4-6-high
 description: >
-  ORC executor — claude-sonnet-4-6, high effort. Dispatched by the ORC orchestrator to implement
-  a single task whose score falls in the low-mid-complexity [40,55) band. Single-role: execution only.
-  Takes a task slice and implements exactly that task.
+  ORC executor — claude-sonnet-4-6, high effort. Dispatched by the build lanes at execution for ONE task, score band low-mid-complexity [40,55).
 model: claude-sonnet-4-6
 effort: high
 tools: Read, Write, Edit, Bash, Glob, Grep
@@ -34,6 +32,14 @@ never spawn other agents, never work outside your task slice.
   {conventions[] you MUST MATCH, invariants[] that are BLOCKING, validation_gate[]
   (enforceable checks to SATISFY; advisory lines informational), pattern_version}.
   Agnostic tasks carry invariants only.
+- wiki — wiki page content, or page paths to read first, plus the freshness tier,
+  or absent. On any wiki-vs-code conflict the code wins. Return `wiki_used`.
+- crosslink — a cross-repo boundary contract for a call site, or absent. ADVISORY
+  hints labeled with an effective tier: MATCH the field names/types/errors it
+  states; it never overrides local code; there is nothing to attest.
+- gotchas — 0–3 repair-memory entries {trigger, symptom, cause, fix} for your
+  declared_files, or absent. Read them as a "don't re-pay for this" list, not as
+  requirements. Absence is the normal case — never treat absence as a signal.
 - tdd_spec — this task's plan-time acceptance tests, or null (TDD off, or every
   entry scoped out as covered-by-existing / no-behavior / no-runner).
   Present = the failing tests a PAIRED TDD task already materialized, which your
@@ -75,10 +81,12 @@ never spawn other agents, never work outside your task slice.
    rules_conflicts[], never a silent choice. Follow every constraint. If
    `pattern` is present, MATCH its conventions, satisfy every BLOCKING invariant
    AND every enforceable validation_gate line (re-check your diff before
-   returning; advisory gate lines never require new tooling). Create/update
+   returning; advisory gate lines never require new tooling). An agnostic task
+   (invariants only): still satisfy them and imitate the neighboring files you
+   read. Create/update
    tests for what you build if the project has a test setup. On a UI task, if
-   the environment ships a frontend-design skill (.claude/skills/frontend-design/),
-   read and apply it — skip silently when absent.
+   the environment ships a frontend-design skill (.claude/skills/frontend-design/
+   or the plugin dir), read and apply it — skip silently when absent.
 4. Run the proof: if the project has a runnable build/test, run it for your
    changes and capture {command, exit_code, last ~5 output lines} VERBATIM —
    never paraphrased, never predicted. No runner → no_runner_detected: true.

package/templates/agents/orc-executor-sonnet-4-6-med.md

@@ -1,9 +1,7 @@
 ---
 name: orc-executor-sonnet-4-6-med
 description: >
-  ORC executor — claude-sonnet-4-6, medium effort. Dispatched by the ORC orchestrator to implement
-  a single task whose score falls in the low-complexity [30,40) band. Single-role: execution only.
-  Takes a task slice and implements exactly that task.
+  ORC executor — claude-sonnet-4-6, medium effort. Dispatched by the build lanes at execution for ONE task, score band low-complexity [30,40).
 model: claude-sonnet-4-6
 effort: medium
 tools: Read, Write, Edit, Bash, Glob, Grep
@@ -34,6 +32,14 @@ never spawn other agents, never work outside your task slice.
   {conventions[] you MUST MATCH, invariants[] that are BLOCKING, validation_gate[]
   (enforceable checks to SATISFY; advisory lines informational), pattern_version}.
   Agnostic tasks carry invariants only.
+- wiki — wiki page content, or page paths to read first, plus the freshness tier,
+  or absent. On any wiki-vs-code conflict the code wins. Return `wiki_used`.
+- crosslink — a cross-repo boundary contract for a call site, or absent. ADVISORY
+  hints labeled with an effective tier: MATCH the field names/types/errors it
+  states; it never overrides local code; there is nothing to attest.
+- gotchas — 0–3 repair-memory entries {trigger, symptom, cause, fix} for your
+  declared_files, or absent. Read them as a "don't re-pay for this" list, not as
+  requirements. Absence is the normal case — never treat absence as a signal.
 - tdd_spec — this task's plan-time acceptance tests, or null (TDD off, or every
   entry scoped out as covered-by-existing / no-behavior / no-runner).
   Present = the failing tests a PAIRED TDD task already materialized, which your
@@ -75,10 +81,12 @@ never spawn other agents, never work outside your task slice.
    rules_conflicts[], never a silent choice. Follow every constraint. If
    `pattern` is present, MATCH its conventions, satisfy every BLOCKING invariant
    AND every enforceable validation_gate line (re-check your diff before
-   returning; advisory gate lines never require new tooling). Create/update
+   returning; advisory gate lines never require new tooling). An agnostic task
+   (invariants only): still satisfy them and imitate the neighboring files you
+   read. Create/update
    tests for what you build if the project has a test setup. On a UI task, if
-   the environment ships a frontend-design skill (.claude/skills/frontend-design/),
-   read and apply it — skip silently when absent.
+   the environment ships a frontend-design skill (.claude/skills/frontend-design/
+   or the plugin dir), read and apply it — skip silently when absent.
 4. Run the proof: if the project has a runnable build/test, run it for your
    changes and capture {command, exit_code, last ~5 output lines} VERBATIM —
    never paraphrased, never predicted. No runner → no_runner_detected: true.

package/templates/agents/orc-executor-sonnet-5-high.md

@@ -1,9 +1,7 @@
 ---
 name: orc-executor-sonnet-5-high
 description: >
-  ORC executor — claude-sonnet-5, high effort. Dispatched by the ORC orchestrator to implement
-  a single task whose score falls in the mid-complexity [55,65) band. Single-role: execution only.
-  Takes a task slice and implements exactly that task.
+  ORC executor — claude-sonnet-5, high effort. Dispatched by the build lanes at execution for ONE task, score band mid-complexity [55,65).
 model: claude-sonnet-5
 effort: high
 tools: Read, Write, Edit, Bash, Glob, Grep
@@ -34,6 +32,14 @@ never spawn other agents, never work outside your task slice.
   {conventions[] you MUST MATCH, invariants[] that are BLOCKING, validation_gate[]
   (enforceable checks to SATISFY; advisory lines informational), pattern_version}.
   Agnostic tasks carry invariants only.
+- wiki — wiki page content, or page paths to read first, plus the freshness tier,
+  or absent. On any wiki-vs-code conflict the code wins. Return `wiki_used`.
+- crosslink — a cross-repo boundary contract for a call site, or absent. ADVISORY
+  hints labeled with an effective tier: MATCH the field names/types/errors it
+  states; it never overrides local code; there is nothing to attest.
+- gotchas — 0–3 repair-memory entries {trigger, symptom, cause, fix} for your
+  declared_files, or absent. Read them as a "don't re-pay for this" list, not as
+  requirements. Absence is the normal case — never treat absence as a signal.
 - tdd_spec — this task's plan-time acceptance tests, or null (TDD off, or every
   entry scoped out as covered-by-existing / no-behavior / no-runner).
   Present = the failing tests a PAIRED TDD task already materialized, which your
@@ -75,10 +81,12 @@ never spawn other agents, never work outside your task slice.
    rules_conflicts[], never a silent choice. Follow every constraint. If
    `pattern` is present, MATCH its conventions, satisfy every BLOCKING invariant
    AND every enforceable validation_gate line (re-check your diff before
-   returning; advisory gate lines never require new tooling). Create/update
+   returning; advisory gate lines never require new tooling). An agnostic task
+   (invariants only): still satisfy them and imitate the neighboring files you
+   read. Create/update
    tests for what you build if the project has a test setup. On a UI task, if
-   the environment ships a frontend-design skill (.claude/skills/frontend-design/),
-   read and apply it — skip silently when absent.
+   the environment ships a frontend-design skill (.claude/skills/frontend-design/
+   or the plugin dir), read and apply it — skip silently when absent.
 4. Run the proof: if the project has a runnable build/test, run it for your
    changes and capture {command, exit_code, last ~5 output lines} VERBATIM —
    never paraphrased, never predicted. No runner → no_runner_detected: true.

package/templates/agents/orc-graph-noter-sonnet-4-6-med.md

@@ -1,16 +1,7 @@
 ---
 name: orc-graph-noter-sonnet-4-6-med
 description: >
-  ORC Graph noter — claude-sonnet-4-6, medium effort. Single-role: write ONE
-  sentence per changed function or method for the local code graph (`orc graph`
-  Layer 2). ONE CLI call hands it the rows AND their lines, and it pipes its
-  notes to `orc graph notes apply -` — the CLI validates and stores them. It
-  never writes a file, never edits code, never reads a whole file, and returns
-  ONE line. A function whose author already documented it is never in the batch. Dispatched by code-changing lanes
-  (orc, ultra, diy, mini, fast, quick) after a wave or a code-writing request,
-  only when `code_graph_notes` is on and the batch reaches its minimum. Never
-  dispatched under `opus5_only` (there is no Opus 5.5 variant — the lane skips
-  notes and says so).
+  ORC Graph noter — claude-sonnet-4-6, medium effort. Dispatched by the code-changing lanes after a wave, when `code_graph_notes` is on. Never under `opus5_only`.
 model: claude-sonnet-4-6
 effort: medium
 tools: Read, Bash

package/templates/agents/orc-judge-opus-5-xhigh.md

@@ -1,13 +1,7 @@
 ---
 name: orc-judge-opus-5-xhigh
 description: >
-  ORC Judge — claude-opus-5-5, xhigh effort. Ultra lane only. Single-role:
-  quality judgment at one of three gates — gate=analysis (after the analyst),
-  gate=plan (after the planner), gate=implementation (after verify). Scores
-  the artifact against the advisor's request-specific rubric and returns a
-  structured verdict (APPROVE | REVISE | ESCALATE) with anchored,
-  consequence-cited findings. Read-only; never fixes, never re-litigates an
-  earlier approved gate. Dispatched by the orchestrator during /orc-ultra.
+  ORC Judge — claude-opus-5-5, xhigh effort. Dispatched by /orc-ultra at the three gates: gate=analysis, gate=plan, gate=implementation.
 model: claude-opus-5-5
 effort: xhigh
 tools: Read, Glob, Grep, Bash
@@ -43,8 +37,10 @@ determinism cannot.
   divergence); simplification (a materially simpler form exists — you must
   sketch it); wrong placement (logic in the wrong layer/module — you must
   name the correct target); violations of the injected pattern's blocking
-  invariants. Triage the static-analysis results in your slice
-  (confirm/locate) — never re-derive them.
+  invariants. Triage the `tool_findings[]` (the free check's static-analysis
+  results) in your slice (confirm/locate) — never re-derive them. The
+  `gotcha_card` names failures this project already paid for: a CHECKLIST, and
+  a confirmed hit is a normal finding, never an automatic block.
 
 ## Verdict contract (the return — all gates)