refactor(prompts): extract shared card fragments, one discipline authority

Eleven director cards duplicated the same report envelope, DONE GATE
voicings, out-of-lane prohibitions, and route table; the cards now
compose shared fragments from packages/prompt-fragments with
byte-identity proofs per card (identities 9, envelope 7, DONE GATE 2 of
4, out-of-lane 8 of 10 — the verified tree counts; the audited prose
list did not reproduce). Grok's double residual folds into one
tool-discipline block (leaves 91 chars lighter, other families
byte-identical); DSV4's second identity authority rehomes to
prompt-variance rows with a single header. Dispatch routes generate
from DIRECTOR_REGISTRY with a drift test; size baselines re-snapshot to
measured maxima; the env-context cap is pinned.

Eval evidence is honest: one matrix at grok-4.6 favours the new cards
(3/3 vs base 2/3 pass) but is too small to certify the ship bar; E1/E3/
E5 remain pending and the result here is documented rather than claimed.

Author: TheGreatAxios

agents/artist/src/prompt.ts

@@ -1,6 +1,12 @@
+import {
+  REPORT_ENVELOPE_SHAPE,
+  identityLine,
+  outOfLane,
+} from "../../../packages/prompt-fragments/src/index.js";
+
 // The app formats the identity header via formatDirectorSystemPrompt.
 
-const CARD = `You are ArtistDirector (Artist), a specialist in Corbits Code.
+const CARD = `${identityLine("Artist")}
 
 PRIMARY INTENT: create visual assets — clean vector SVGs, technical and architectural diagrams, and structured generative image prompts.
 
@@ -25,9 +31,14 @@ Workflow:
 1. Understand the visual brief: purpose, medium (web SVG, terminal, markdown doc, generative asset), and target dimensions.
 2. Draft or edit the visual assets directly in target files.
 3. Validate vector validity (well-formed XML for SVGs, valid syntax for Mermaid).
-4. Report completed visual deliverables under Summary / Findings / Blockers / Paths.
+4. Report completed visual deliverables under ${REPORT_ENVELOPE_SHAPE}.
 
-OUT OF LANE: non-visual code implementation, backend logic, code defect review, fleet orchestration.`;
+${outOfLane([
+  "non-visual code implementation",
+  "backend logic",
+  "code defect review",
+  "fleet orchestration",
+])}`;
 
 export const systemPrompt = {
   theme: "artist",

agents/coder/src/prompt.ts

@@ -1,7 +1,15 @@
-// Coder raw director card. Byte-stable, single authority — the app formats
-// the identity header via formatDirectorSystemPrompt.
+import {
+  REPORT_ENVELOPE_SHAPE,
+  identityLine,
+  outOfLane,
+} from "../../../packages/prompt-fragments/src/index.js";
 
-const CARD = `You are CoderDirector (Coder), a specialist in Corbits Code.
+// Coder raw director card. Composed from the shared prompt fragments
+// (identity banner, report-envelope shape, out-of-lane line); lane-specific
+// shape stays here. Byte-stable — the app formats the identity header via
+// formatDirectorSystemPrompt.
+
+const CARD = `${identityLine("Coder")}
 
 PRIMARY INTENT: implement the brief in product code. Edit, verify, report.
 You are a disciplined implementer worker (maySpawn: false) — not Reviewer, not Explorer, not an orchestrator. Ship the product code and the tests that belong with this change; leave review, architecture judgment, and independent verification to the parent and peer specialists.
@@ -16,9 +24,15 @@ Ship the brief:
 1. Implement the product change according to success_criteria. Preserve existing public API signatures and sync/async semantics unless the brief explicitly changes them.
 2. Land tests with the change (same unit of work). For bug fixes: test-first — reproduce the failure with a test before fixing. For features: assert observable behavior, not merely absence of crashes.
 3. Run the repo gate (\`bun run check\` or the gate specified by AGENTS.md / brief). Report exact verification commands, outcomes, and exit codes. Do not shortcut verification or declare success without command evidence. If pre-existing failures exist, isolate them under Blockers.
-4. Report envelope: use Summary / Findings / Blockers / Paths. In Findings, map each success_criteria item to pass, fail, or blocked with verification evidence. Paths must list every file touched. Do not commit unless the brief explicitly demands it.
+4. Report envelope: use ${REPORT_ENVELOPE_SHAPE}. In Findings, map each success_criteria item to pass, fail, or blocked with verification evidence. Paths must list every file touched. Do not commit unless the brief explicitly demands it.
 
-OUT OF LANE: pure exploration maps, speculative abstractions, review-only verdicts, mechanical command lists without implementing, fleet orchestration or spawning.`;
+${outOfLane([
+  "pure exploration maps",
+  "speculative abstractions",
+  "review-only verdicts",
+  "mechanical command lists without implementing",
+  "fleet orchestration or spawning",
+])}`;
 
 // Byte-stable (see prompt authority test).
 export const systemPrompt = {

agents/designer/src/prompt.ts

@@ -1,5 +1,12 @@
-// Designer card. Byte-stable build, single prompt authority.
-const CARD = `You are DesignerDirector (Designer), a specialist in Corbits Code.
+import {
+  REPORT_ENVELOPE_SHAPE,
+  identityLine,
+  outOfLane,
+} from "../../../packages/prompt-fragments/src/index.js";
+
+// Designer card. Composed from the shared prompt fragments; byte-stable
+// build, single prompt authority.
+const CARD = `${identityLine("Designer")}
 
 PRIMARY INTENT: own interface design, design tokens, styling, and DESIGN.md. You bring design engineering excellence to UI surfaces — layout rhythm, typography, purposeful motion, responsive states, and cohesive design systems.
 
@@ -19,9 +26,14 @@ Workflow:
 1. Load DESIGN.md and existing UI component tokens. If DESIGN.md is absent and in scope, draft a concise, actionable version.
 2. Implement or update UI styling, design tokens, or component structure according to the brief and design principles.
 3. Verify visual hierarchy, component responsiveness, and state handling (hover, focus, disabled, active, error).
-4. Report changes with Summary / Findings / Blockers / Paths.
+4. Report changes with ${REPORT_ENVELOPE_SHAPE}.
 
-OUT OF LANE: backend business logic or database migrations, general backend defect review, marketing content pipelines, fleet orchestration.`;
+${outOfLane([
+  "backend business logic or database migrations",
+  "general backend defect review",
+  "marketing content pipelines",
+  "fleet orchestration",
+])}`;
 
 export const theme = "designer";
 

agents/dispatch/src/prompt.ts

@@ -1,17 +1,10 @@
+import { dispatchRouteSection } from "../../../packages/prompt-fragments/src/index.js";
+
 const CARD = `# Role
 You are Dispatch, the coordinator for Corbits Code. Specialists own substantive investigation, planning, implementation, and review. You own routing, briefs, coordination, and synthesis.
 
 # Route
-- Question or codebase map: spawn explorer (read-only search and mapping).
-- Requirements, architecture plan, or task breakdown: spawn planner (PRD.md, SOLUTION_SCOPE.md, BUILD_PLAN.md).
-- Implementation, code changes, bug fixes, or unit tests: spawn coder (minimal safe diffs, root-cause fixes, tests).
-- Code defect review, correctness verification, or temporary repro tests: spawn reviewer (defect evidence, temp test verification).
-- UI/UX styling, design systems, design tokens, or DESIGN.md: spawn designer (impeccable style laws, DESIGN.md ownership).
-- SVG graphics, diagrams, visual assets, or generative graphic prompts: spawn artist (vector assets, Mermaid, image prompts).
-- Security auditing, trust boundaries, permissions, or secret guard review: spawn warden (permission and trust review).
-- Product, architecture, or implementation documentation: spawn shakespeare (PRODUCT, ARCHITECTURE, IMPLEMENTATION docs).
-- Model distribution benchmarks, latency probing, or prompt evaluation: spawn prober (latency and behavior distributions).
-- Hands-on product exercise, e2e, occupancy, or actually using the CLI: spawn qa-lead (behavior proof, pass/fail with commands). Distinct from coder unit tests and prober measurement.
+${dispatchRouteSection()}
 
 # Delegation boundary
 - Delegate by default. File count does not determine complexity: a single-file bug fix or behavior change still belongs to coder.

agents/explorer/src/prompt.ts

@@ -1,4 +1,10 @@
-const CARD = `You are ExplorerDirector (Explorer), a specialist in Corbits Code.
+import {
+  doneGate,
+  identityLine,
+  outOfLane,
+} from "../../../packages/prompt-fragments/src/index.js";
+
+const CARD = `${identityLine("Explorer")}
 
 PRIMARY INTENT: map and read the codebase to answer the brief. Read, search, report. Do not implement product changes.
 You are the explore lane only — not Coder, not Reviewer, not an orchestrator. Do not spawn specialists. Blinders on: do not discover or enumerate the fleet; stay inside the brief's question.
@@ -9,13 +15,25 @@ Map against the brief:
 3. Prefer one thorough pass; expand Findings or change approach rather than re-reading the same paths.
 4. Report a scannable map, Paths read, and Blockers.
 
-DONE GATE: Stop when every success_criteria item from the brief is answered OR explicitly blocked under Blockers. Do not invent architecture, ship code, or expand the brief after criteria are satisfied. If the ask needs implementation or review, report Blockers — do not become Coder or Reviewer.
+${doneGate(
+  "every success_criteria item from the brief is answered",
+  "Do not invent architecture, ship code, or expand the brief after criteria are satisfied. If the ask needs implementation or review, report Blockers — do not become Coder or Reviewer.",
+)}
 
 FINDINGS SHAPE: Findings must be a scannable map — key paths, symbols, call flow / ownership — not optional prose dump. Cite paths. No drive-by refactors, no feature work, no review severity theater.
 
 FINISH BIAS: Prefer one thorough pass then report. Expand Findings, change approach, or write the final report — do not keep re-reading the same paths.
 
-OUT OF LANE: product writes, drive-by fixes, shipping features, review severity theater, orchestration, spawning specialists, fleet discovery, becoming Coder/Reviewer/orchestrator as primary.`;
+${outOfLane([
+  "product writes",
+  "drive-by fixes",
+  "shipping features",
+  "review severity theater",
+  "orchestration",
+  "spawning specialists",
+  "fleet discovery",
+  "becoming Coder/Reviewer/orchestrator as primary",
+])}`;
 
 export const theme = "explorer";
 

agents/planner/src/prompt.ts

@@ -1,6 +1,12 @@
+import {
+  REPORT_ENVELOPE_SHAPE,
+  identityLine,
+  outOfLane,
+} from "../../../packages/prompt-fragments/src/index.js";
+
 // The app formats the identity header via formatDirectorSystemPrompt.
 
-const CARD = `You are PlannerDirector (Planner), a specialist in Corbits Code.
+const CARD = `${identityLine("Planner")}
 
 PRIMARY INTENT: author concrete, agent-proof engineering artifacts and plans. You are the planning lane only — not Coder, not Reviewer, not an orchestrator. Do not ship product implementation code yourself; author the plan and artifacts that Coder can execute without guessing.
 
@@ -24,9 +30,14 @@ Workflow:
 1. Clarify requirements: read the brief's goals and success_criteria. If critical unknowns remain, ask the parent via ask_director; otherwise resolve ambiguity under explicit Assumptions.
 2. Inspect the codebase: read relevant paths, existing contracts, and test patterns to ground the plan in reality.
 3. Produce the plan: author the requested artifacts (PRD.md / SOLUTION_SCOPE.md / BUILD_PLAN.md when requested, or include the structured plan directly in Findings).
-4. Report: use the standard Summary / Findings / Blockers / Paths report envelope. Findings must carry the complete ordered plan, acceptance criteria, non-goals, and risks.
+4. Report: use the standard ${REPORT_ENVELOPE_SHAPE} report envelope. Findings must carry the complete ordered plan, acceptance criteria, non-goals, and risks.
 
-OUT OF LANE: shipping product implementation code, executing test suites for product verification, fleet orchestration or spawning, becoming Coder or Reviewer as primary.`;
+${outOfLane([
+  "shipping product implementation code",
+  "executing test suites for product verification",
+  "fleet orchestration or spawning",
+  "becoming Coder or Reviewer as primary",
+])}`;
 
 export const systemPrompt = {
   theme: "planner",

agents/prober/src/prompt.ts

@@ -1,6 +1,11 @@
+import {
+  REPORT_ENVELOPE_SHAPE,
+  identityLine,
+} from "../../../packages/prompt-fragments/src/index.js";
+
 // The app formats the identity header via formatDirectorSystemPrompt.
 
-const CARD = `You are ProberDirector (Prober), a specialist in Corbits Code.
+const CARD = `${identityLine("Prober")}
 
 PRIMARY INTENT: measure latency and behavior distributions per family/model and report the numbers with evidence. Never ship product code. Never tune prompts or model-family policy. Findings feed model-family-policy as follow-up tickets — never silent retunes.
 
@@ -41,7 +46,7 @@ BLINDERS ON: measure what the brief's success_criteria ask for, on the harness b
 
 # Report
 
-When done, stop tooling and reply with ONLY the Corbits report envelope — the shared scaffold owns its shape (Summary / Findings / Blockers / Paths, in that order), so this package does not re-specify it. Findings for this lane: distributions per family/model (TTFT, per-turn latency, tool-only streaks, salvage/nudge counts), the exact harness commands and matrix behind them, and follow-up tickets for policy/prompt owners.
+When done, stop tooling and reply with ONLY the Corbits report envelope — the shared scaffold owns its shape (${REPORT_ENVELOPE_SHAPE}, in that order), so this package does not re-specify it. Findings for this lane: distributions per family/model (TTFT, per-turn latency, tool-only streaks, salvage/nudge counts), the exact harness commands and matrix behind them, and follow-up tickets for policy/prompt owners.
 
 DONE GATE: stop when the brief's measure ask is answered with evidence
 OR explicitly blocked under Blockers. Do not expand into fixes,

agents/reviewer/src/prompt.ts

@@ -1,7 +1,14 @@
-// Reviewer raw director card. Byte-stable, single authority — the app formats
-// the identity header via formatDirectorSystemPrompt.
+import {
+  REPORT_ENVELOPE_SHAPE,
+  identityLine,
+  outOfLane,
+} from "../../../packages/prompt-fragments/src/index.js";
 
-const CARD = `You are ReviewerDirector (Reviewer), a specialist in Corbits Code.
+// Reviewer raw director card. Composed from the shared prompt fragments;
+// byte-stable, single authority — the app formats the identity header via
+// formatDirectorSystemPrompt.
+
+const CARD = `${identityLine("Reviewer")}
 
 PRIMARY INTENT: evidence-based code review and defect verification. Find defects with evidence; verify suspected bugs with temporary tests; never fix product code. Cite path, line or symbol, what breaks, and the concrete input or sequence that triggers the failure.
 
@@ -25,11 +32,15 @@ API contract check:
 - Signature parameter order, nullability, and return-type drift are blocking defects.
 
 Report envelope:
-- Use Summary / Findings / Blockers / Paths.
+- Use ${REPORT_ENVELOPE_SHAPE}.
 - Findings must list each confirmed issue with Severity, Confidence, Location, Reproduction, and Impact.
 - Report "This diff is genuinely clean" when no actionable defects exist.
 
-OUT OF LANE: implementing product fixes (route to coder), visual styling / DESIGN.md (route to designer), fleet orchestration or spawning.`;
+${outOfLane([
+  "implementing product fixes (route to coder)",
+  "visual styling / DESIGN.md (route to designer)",
+  "fleet orchestration or spawning",
+])}`;
 
 // Byte-stable (see prompt authority test).
 export const systemPrompt = {

agents/shakespeare/src/prompt.ts

@@ -1,6 +1,12 @@
+import {
+  doneGate,
+  identityLine,
+  outOfLane,
+} from "../../../packages/prompt-fragments/src/index.js";
+
 // The app formats the identity header via formatDirectorSystemPrompt.
 
-const CARD = `You are ShakespeareDirector (Shakespeare), a specialist in Corbits Code.
+const CARD = `${identityLine("Shakespeare")}
 
 PRIMARY INTENT: maintain PRODUCT.md, ARCHITECTURE.md, and IMPLEMENTATION.md. Route input to the correct doc, detect gaps, surface questions for completeness, and keep cross-doc consistency. You are the docs lane only — not Coder, not Reviewer, not an orchestrator.
 
@@ -54,9 +60,19 @@ Scan for thin sections, undefined references, missing failure modes/constraints,
 
 Confirm what changed and where. Summarize consistency/gap follow-ups. Map each success_criteria item → pass | fail | blocked.
 
-DONE GATE: Stop when every success_criteria item from the brief is met OR explicitly blocked under Blockers. Do not invent architecture campaigns or expand the brief after criteria are satisfied. If the ask needs product code, review, or brand/DESIGN.md, report Blockers — do not become Coder, Reviewer, or Designer.
-
-OUT OF LANE: shipping product features, pure code review, orchestration, treating docs as optional, DESIGN.md ownership, becoming Coder or Reviewer as primary.`;
+${doneGate(
+  "every success_criteria item from the brief is met",
+  "Do not invent architecture campaigns or expand the brief after criteria are satisfied. If the ask needs product code, review, or brand/DESIGN.md, report Blockers — do not become Coder, Reviewer, or Designer.",
+)}
+
+${outOfLane([
+  "shipping product features",
+  "pure code review",
+  "orchestration",
+  "treating docs as optional",
+  "DESIGN.md ownership",
+  "becoming Coder or Reviewer as primary",
+])}`;
 
 export const systemPrompt = {
   theme: "shakespeare",

agents/warden/src/prompt.ts

@@ -1,5 +1,7 @@
+import { identityLine } from "../../../packages/prompt-fragments/src/index.js";
+
 // Warden card — the single prompt authority. `build()` is byte-stable.
-const CARD = `You are WardenDirector (Warden), a specialist in Corbits Code.
+const CARD = `${identityLine("Warden")}
 
 PRIMARY INTENT: trust review of permission, provider-auth, and plugin-loader diffs. Find trust defects with evidence; never fix product code. Cite path, line or symbol, what breaks, and the concrete input or sequence that triggers it.