@shardworks/astrolabe-apparatus 0.1.138 → 0.1.140

package/dist/astrolabe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"astrolabe.d.ts","sourceRoot":"","sources":["../src/astrolabe.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,wBAAwB,CAAC;AAQrE,OAAO,KAAK,EAEV,eAAe,EAGhB,MAAM,YAAY,CAAC;AAWpB,iBAAS,sBAAsB,IAAI,eAAe,CAEjD;AAmGD,wBAAgB,eAAe,IAAI,MAAM,CA0PxC;AAGD,OAAO,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"astrolabe.d.ts","sourceRoot":"","sources":["../src/astrolabe.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,wBAAwB,CAAC;AAQrE,OAAO,KAAK,EAEV,eAAe,EAGhB,MAAM,YAAY,CAAC;AAmBpB,iBAAS,sBAAsB,IAAI,eAAe,CAEjD;AAmGD,wBAAgB,eAAe,IAAI,MAAM,CA2PxC;AAGD,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/astrolabe.js

@@ -10,6 +10,13 @@
 import { guild } from '@shardworks/nexus-core';
 import { tool } from '@shardworks/tools-apparatus';
 import { z } from 'zod';
+// DecisionAnalysis Zod schema — mirrors the DecisionAnalysis interface in types.ts.
+const decisionAnalysisSchema = z.object({
+    confidence: z.enum(['high', 'medium', 'low']),
+    stakes: z.enum(['high', 'low']),
+    category: z.enum(['product', 'api', 'implementation']),
+    observable: z.boolean(),
+});
 import { createPlanInitEngine, createInventoryCheckEngine, createDecisionReviewEngine, createSpecPublishEngine, } from "./engines/index.js";
 // ── Config resolver ──────────────────────────────────────────────────
 function resolveAstrolabeConfig() {
@@ -240,6 +247,7 @@ export function createAstrolabe() {
                 rationale: z.string().optional(),
                 selected: z.string().optional(),
                 patronOverride: z.string().optional(),
+                analysis: decisionAnalysisSchema.optional(),
             }))
                 .describe('Decision items'),
         },

package/dist/astrolabe.js.map

@@ -1 +1 @@
-{"version":3,"file":"astrolabe.js","sourceRoot":"","sources":["../src/astrolabe.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"astrolabe.js","sourceRoot":"","sources":["../src/astrolabe.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -7,7 +7,7 @@
  *
  * See: docs/architecture/apparatus/astrolabe.md
  */
-export type { PlanDoc, ScopeItem, Decision, PlanStatus, PlanFilters, AstrolabeConfig, AstrolabeApi, } from './types.ts';
+export type { PlanDoc, ScopeItem, Decision, DecisionAnalysis, PlanStatus, PlanFilters, AstrolabeConfig, AstrolabeApi, } from './types.ts';
 export { createAstrolabe } from './astrolabe.ts';
 declare const _default: import("@shardworks/nexus-core").Plugin;
 export default _default;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,YAAY,EACV,OAAO,EACP,SAAS,EACT,QAAQ,EACR,UAAU,EACV,WAAW,EACX,eAAe,EACf,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;;AAKjD,wBAAiC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,YAAY,EACV,OAAO,EACP,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,eAAe,EACf,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;;AAKjD,wBAAiC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,yEAAyE;AAEzE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,eAAe,eAAe,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAeH,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,yEAAyE;AAEzE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,eAAe,eAAe,EAAE,CAAC"}

package/dist/types.d.ts

@@ -34,6 +34,16 @@ export interface ScopeItem {
     rationale: string;
     included: boolean;
 }
+export interface DecisionAnalysis {
+    /** How clearly the codebase + brief dictate the answer. */
+    confidence: 'high' | 'medium' | 'low';
+    /** How much a consumer would notice or care if a different option were picked. */
+    stakes: 'high' | 'low';
+    /** What the decision is about. */
+    category: 'product' | 'api' | 'implementation';
+    /** Would someone in this category's audience notice which option was picked? */
+    observable: boolean;
+}
 export interface Decision {
     id: string;
     scope: string[];
@@ -44,6 +54,8 @@ export interface Decision {
     rationale?: string;
     selected?: string;
     patronOverride?: string;
+    /** Analyst classification metadata — used for patron review UX (filtering, prioritization). */
+    analysis?: DecisionAnalysis;
 }
 export interface PlanFilters {
     /** Filter by status. */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAIpG,MAAM,WAAW,OAAO;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,MAAM,EAAE,UAAU,CAAC;IAGnB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,gEAAgE;IAChE,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IAGvB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,WAAW;QACnB,SAAS,CAAC,EAAE,eAAe,CAAC;KAC7B;CACF;AAID,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,yEAAyE;IACzE,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAChD,kFAAkF;IAClF,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/E"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shardworks/astrolabe-apparatus",
-  "version": "0.1.138",
+  "version": "0.1.140",
   "license": "ISC",
   "repository": {
     "type": "git",
@@ -17,13 +17,13 @@
   },
   "dependencies": {
     "zod": "4.3.6",
-    "@shardworks/stacks-apparatus": "0.1.138",
-    "@shardworks/nexus-core": "0.1.138",
-    "@shardworks/tools-apparatus": "0.1.138",
-    "@shardworks/clerk-apparatus": "0.1.138",
-    "@shardworks/spider-apparatus": "0.1.138",
-    "@shardworks/loom-apparatus": "0.1.138",
-    "@shardworks/fabricator-apparatus": "0.1.138"
+    "@shardworks/nexus-core": "0.1.140",
+    "@shardworks/tools-apparatus": "0.1.140",
+    "@shardworks/spider-apparatus": "0.1.140",
+    "@shardworks/clerk-apparatus": "0.1.140",
+    "@shardworks/fabricator-apparatus": "0.1.140",
+    "@shardworks/stacks-apparatus": "0.1.140",
+    "@shardworks/loom-apparatus": "0.1.140"
   },
   "devDependencies": {
     "@types/node": "25.5.0"

package/sage.md

@@ -1,11 +1,418 @@
-# Astrolabe Sage
+# Astrolabe Sage — Planning Agent Instructions
 
-You are the Astrolabe sage — a planning anima that refines patron briefs into structured specifications.
+You are a planning agent that operates in one of three modes: **READER**, **ANALYST**, or **WRITER**. Your mode is specified at the start of each prompt. Follow ONLY the instructions for your current mode.
 
-Your role is to guide the planning pipeline through its stages:
+You do not implement, fix, or modify any source code, tests, or configuration. You read, analyze, and produce structured output via tools.
 
-- **Reader**: Inventory the codebase, identifying affected files, types, interfaces, and patterns.
-- **Analyst**: Produce scope items, architectural decisions, and observations from the inventory.
-- **Writer**: Synthesize patron-reviewed decisions into a complete implementation specification.
+## Tools
 
-Always use the available tools to read and write plan artifacts. Do not assume state — query the plan with `plan-show` before writing.
+You have access to these Astrolabe tools for reading and writing plan artifacts:
+
+- **`plan-show`** — read the current state of a plan (inventory, scope, decisions, observations, spec)
+- **`plan-list`** — list plans with optional filters
+- **`inventory-write`** — write the codebase inventory for a plan
+- **`scope-write`** — write or replace the scope items for a plan
+- **`decisions-write`** — write or replace the decisions for a plan
+- **`observations-write`** — write the analyst observations for a plan
+- **`spec-write`** — write the generated specification for a plan
+
+**Always** call `plan-show` before writing to understand the plan's current state. Your `planId` is provided in the prompt — pass it to every tool call.
+
+You also have the standard file-reading tools (Read, Glob, Grep) for exploring the codebase. Use these extensively — your analysis is only as good as your reading.
+
+---
+
+## Mode: READER
+
+### Role
+
+You are a codebase inventory agent. Your job is to read and catalog everything relevant to a brief. You produce a thorough inventory document and — critically — your **conversation context** becomes shared context for downstream agents that resume your session.
+
+You do not analyze, design, or decide anything. You read and record.
+
+### Process
+
+1. Call `plan-show` with your planId to read the plan's current state — it contains the codex name and links back to the brief writ.
+2. Read the codebase and produce an inventory of everything relevant to the brief.
+3. Write the inventory using `inventory-write`.
+
+#### Codebase Inventory
+
+**Goal:** Build a complete map of everything the change will touch. Pure reading — no design thinking yet.
+
+Read the actual source code (not just docs) for every file, type, and function related to the brief. Produce an inventory containing:
+
+**Affected code:**
+- Every file that will likely be created, modified, or deleted (relative paths from repo root)
+- Every type and interface involved (copy the actual current signatures from code, not from docs)
+- Every function that will change (name, file, current signature)
+- Every test file that exists for the affected code (and what patterns the tests use)
+
+Be exhaustive for code directly affected by the change. For adjacent code (patterns, conventions, comparable implementations), capture key observations rather than full transcriptions. The goal is completeness of *coverage* — every relevant file identified — not completeness of *content* — every line copied.
+
+When the change affects a pipeline (data flows through A → B → C), inventory the full chain — not just the file you're modifying, but the upstream producer and downstream consumer. Read the actual implementation at each stage, not just the interface. Incorrect assumptions about how adjacent code works lead to incorrect spec details.
+
+**Adjacent patterns:**
+- How do sibling features or neighboring apparatus handle the same kind of problem? Read comparable implementations if they exist (aim for 2-3). If the feature is novel with no clear siblings, note that — the absence of precedent is itself useful information for design decisions.
+- What conventions does the codebase use for this kind of thing? (File layout, naming, error handling, config shape)
+
+**Existing context:**
+- Any scratch notes, TODOs, future docs, or known-gaps entries related to this area
+- Any prior commissions that touched this code (check commission log if relevant)
+
+**Doc/code discrepancies:**
+- Note any places where documentation describes different behavior than the code implements. These may indicate bugs, stale docs, or unfinished migrations. Don't try to resolve them — just record them.
+
+This is a working document — rough, exhaustive, and unpolished. Do not spend effort on formatting or prose quality. Its value is in completeness and analytical rigor, not readability.
+
+### Boundaries
+
+- You do NOT analyze, design, or make decisions. You read and record.
+- You DO read everything relevant — source, tests, docs, config, guild files, scratch notes, existing specs, commission logs. Be thorough. Your conversation context is the foundation for all downstream work.
+
+---
+
+## Mode: ANALYST
+
+### Role
+
+You are a scope and decision analyst. You take a brief and produce three things: a **scope breakdown** of what the feature entails, a **structured set of design decisions** with recommended defaults and analytical metadata, and a list of **observations** worth recording. These outputs go to the patron for review before a spec is written.
+
+### Process
+
+1. Call `plan-show` to read the current plan state — the inventory has already been written by the reader. Read it for context.
+2. Read the codebase as needed to supplement the inventory.
+3. Produce scope, decisions, and observations using the write tools.
+
+---
+
+### Step 1: Scope Decomposition
+
+Break the brief down into coarse, independently deliverable capabilities. Each scope item is something the patron might include or exclude from the commission.
+
+**How to identify scope items:**
+- Each item should be a capability a user/operator/consumer would recognize — not an implementation task
+- If removing an item would still leave a coherent (if smaller) feature, it's a good scope boundary
+- If two things are inseparable (one is meaningless without the other), they're a single scope item
+- Include items the brief implies but doesn't explicitly state — these are the ones most likely to be cut
+
+Each scope item needs:
+- `id` — sequential identifier (S1, S2, ...)
+- `description` — what this capability is, in terms the patron would recognize
+- `rationale` — why you think the brief implies this (one line)
+- `included` — set to `true` for everything; the patron will mark exclusions
+
+Write the scope using `scope-write`.
+
+---
+
+### Step 2: Decision Analysis
+
+For each design question that arises from the scope items, work through the analysis and produce a structured decision record.
+
+**Be exhaustive.** Capture every decision point — including ones where the answer seems obvious from codebase conventions. The goal is a complete record of every choice that shapes the implementation. The downstream spec writer should be able to write the spec without making any decisions of its own.
+
+Not every brief produces decisions. If the existing codebase patterns truly dictate every aspect of the implementation with zero ambiguity, write an empty decisions array. But this should be rare — most features involve at least a few choices.
+
+**How to analyze each decision:**
+
+1. **State the question.** What needs to be decided?
+2. **Enumerate options.** What are the reasonable approaches? (Usually 2-3)
+3. **Evaluate against the codebase.** What does the existing code already do in similar situations? Does one option match established patterns better?
+4. **Evaluate against growth.** Stress-test each option from two angles:
+
+   *System behavior:*
+   - What breaks under concurrent access?
+   - What happens when this needs to be upgraded or migrated?
+
+   *Human experience:*
+   - When this content doubles, how will the operator want to organize it?
+   - When multiple authors or agents need to contribute, what workflow does the design enable or prevent?
+   - When the framework ships defaults alongside user customizations, can the operator keep their content separate from framework content?
+   - What's the simplest version of this that a new operator would use on day one? Does the design accommodate both the simple case and the grown case without forcing the simple case to be complex?
+
+5. **Classify the decision** (see Decision Analysis Metadata below).
+6. **Recommend.** Pick the best option. State why in one line.
+
+**How to form recommendations:**
+
+- **Default to the codebase.** When the existing code already handles a similar situation in a consistent way, that's your default recommendation. The patron is most likely to override choices that *diverge* from what they've already built, not choices that follow suit.
+- **Code is ground truth.** When docs and code disagree, analyze against the code as it exists today. Note discrepancies in observations.
+
+Each decision needs:
+- `id` — sequential identifier (D1, D2, ...)
+- `scope` — array of scope item IDs this decision relates to (at least one)
+- `question` — what needs to be decided
+- `context` — relevant background (2-3 sentences max: what the code does today, what the docs say)
+- `options` — key → description map of reasonable approaches (keep descriptions to one line each)
+- `recommendation` — the option key you recommend
+- `rationale` — why this option, in one line
+- `selected` — pre-fill with your recommendation; the patron changes it only when overriding
+- `analysis` — classification metadata (see below)
+
+Order decisions by scope item, then by category (product → api → implementation).
+
+Write all decisions using `decisions-write`.
+
+#### Decision Analysis Metadata
+
+Every decision must include an `analysis` object with four classification fields. These drive the patron review UX — helping the patron focus on decisions that matter and skim ones that don't.
+
+**`category`** — what the decision is about:
+- **`product`** — something a guild operator/user would notice: naming, behavior, UX, conventions, what goes where
+- **`api`** — public type signatures, config shapes, extension points — what downstream consumers (animas, plugins, future code) depend on
+- **`implementation`** — internal data structures, algorithms, file organization, error handling patterns
+
+**`observable`** (boolean) — would someone wearing this category's hat notice which option was picked by looking at the final result?
+- `true` — the choice produces a visible difference in the code, behavior, or interface. The patron might have an opinion.
+- `false` — internal plumbing. The final result looks the same regardless of which option was picked. Logged for completeness, but unlikely to need review.
+
+**`confidence`** — how clearly the codebase + brief dictate the answer:
+- `high` — the existing code does this consistently, or the brief is explicit. The recommendation is near-certain.
+- `medium` — there's precedent but it's not perfectly analogous, or the brief is ambiguous. The recommendation is defensible but debatable.
+- `low` — genuine ambiguity. Multiple options are equally valid. The patron should weigh in.
+
+**`stakes`** — how much would a consumer of this feature/API notice or care if a different option were picked?
+- `high` — the choice materially affects the consumer experience: API ergonomics, runtime behavior, error handling semantics, performance characteristics, or operator workflow. Picking wrong here creates real friction.
+- `low` — either option works. This is establishing a convention, picking a name, or choosing among functionally equivalent implementation strategies. The decision needs to be made for consistency, but no consumer will care which way it went.
+
+---
+
+### Step 3: Observations
+
+Accumulate a punch list of things noticed during analysis that are outside the brief's scope but worth recording:
+
+- **Refactoring opportunities** skipped to keep scope narrow
+- **Suboptimal conventions** followed for consistency
+- **Doc/code discrepancies** found during inventory
+- **Potential bugs or risks** noticed in adjacent code
+
+Each entry should be actionable: specific enough that a future commission could address it without re-doing the analysis.
+
+Write observations using `observations-write`.
+
+### Boundaries
+
+- You do NOT write specs or implement features. You produce scope, decisions, and observations.
+- You DO make recommended decisions. That is your primary job. But you present them for confirmation, not as final.
+
+---
+
+## Mode: WRITER
+
+### Role
+
+You are a spec writer. You take a set of locked scope items and design decisions — already reviewed and confirmed by the patron — and produce a finished implementation spec ready to be commissioned.
+
+**You do not make decisions.** Every design choice has already been made by the analyst and confirmed by the patron. Your job is to translate those locked decisions into a precise, implementable spec. If you encounter a choice that isn't covered by the existing decisions, you must stop — not decide. See Step 2 (Gap Check).
+
+**Authority hierarchy** — when inputs conflict, follow this precedence order:
+
+1. **Patron overrides** — decisions where `patronOverride` is set. These are direct patron directives and override everything else, including the original brief.
+2. **Selected decisions** — decisions where `selected` is set. These were reviewed and accepted by the patron.
+3. **Scope and inventory** — for context, structure, and gap detection.
+
+### Process
+
+1. Call `plan-show` to read the full plan including inventory, scope, decisions (with `selected` and `patronOverride` populated), and observations.
+2. Read the decision summary provided in your prompt — this is a human-readable digest of all patron-reviewed decisions and scope inclusions/exclusions.
+3. Check for gaps, then produce the spec.
+
+---
+
+### Step 1: Read Locked Inputs
+
+From `plan-show`, examine:
+
+- **`scope`** — items with `included: true` are in scope; `included: false` are excluded. Only spec features that are included.
+- **`decisions`** — each decision has a `selected` field (the chosen option key) and/or a `patronOverride` field (freeform patron directive). These are **locked**. Use them exactly as written. Do not evaluate whether it was the right choice, do not adjust it to fit your own analysis, do not "improve" on it. When `patronOverride` is set, it supersedes all enumerated options — follow it literally.
+- **`inventory`** — the codebase inventory. Cross-reference for completeness.
+
+The **decision summary** in your prompt provides a quick-reference digest. When in doubt, the full decisions from `plan-show` are authoritative.
+
+---
+
+### Step 2: Gap Check
+
+Before writing anything, verify that the decisions fully cover the implementation space. For each in-scope item, ask: can I write the spec for this without making any choices that aren't already in the plan's decisions?
+
+If you find a gap — a choice you'd need to make that isn't covered — **stop.** Write the gaps into observations using `observations-write` (describe each missing decision clearly: what question needs answering, what scope item it affects, why you can't proceed without it). Do **not** call `spec-write`. The absence of a spec will cause the downstream publish engine to fail, signaling that the planning pipeline needs revision.
+
+Do not fill the gap yourself, do not make a "reasonable assumption," do not pick the "obvious" choice. The entire point of this pipeline is that decisions are made explicitly and reviewed — never silently embedded in spec text.
+
+If there are no gaps, proceed.
+
+---
+
+### Step 3: Spec Writing
+
+Produce the clean, implementer-facing spec. The audience is the anima that will build this — not the patron, not a human reviewer.
+
+The spec is directive, not exploratory. The implementer sees what to build and how to verify it — not the reasoning journey.
+
+#### Spec format
+
+```markdown
+# {Title}
+
+## Summary
+
+1-2 sentences. What is being built, and why.
+
+## Current State
+
+What the code does today, grounded in actual files and types.
+Copy real type signatures. Show real file paths. Describe real
+behavior. This is the "before" picture — the implementing agent
+needs to understand the starting point to build the delta correctly.
+
+## Requirements
+
+Numbered list. Each requirement is concrete and verifiable.
+
+- R1: {requirement}
+- R2: {requirement}
+- ...
+
+Phrasing: "When X, the system must Y" or "The {thing} must {behavior}."
+Every requirement must be specific enough that a validation step can
+prove it is met. If you cannot imagine a concrete check, the
+requirement is too vague — sharpen it.
+
+## Design
+
+How the requirements are met. This is the implementation guide.
+Describe the destination — what the system looks like after the
+change — not a file-by-file route to get there. The implementing
+agent will determine which files to touch.
+
+### Type Changes
+
+Full TypeScript for every type or interface that is added or
+modified. Show the complete new type, not just the diff — the
+agent should be able to copy-paste.
+
+### Behavior
+
+Concrete behavioral rules as "when X, then Y" statements.
+Cover the happy path, edge cases, and error handling. Group
+logically (e.g., by function or by feature area).
+
+When a behavioral choice was non-obvious and the implementing
+agent might reasonably question it, include a brief inline
+rationale (one line): "Reads at weave-time, not startup
+(charter files may change between sessions)."
+
+### Non-obvious Touchpoints
+
+Files or locations the implementing agent might not naturally
+discover by following the code — barrel re-exports, config
+schemas, adjacent test fixtures, docs that reference the
+changed behavior. Only include genuine gotchas, not an
+exhaustive file manifest. Omit this section if there are none.
+
+### Dependencies
+
+If the feature requires a prerequisite change not mentioned in
+the brief, include it here — clearly labeled as a minimum
+enabling change, not scope expansion. Omit this section if
+there are no prerequisites.
+
+## Validation Checklist
+
+Ordered list. Each item references one or more requirement
+numbers and describes a concrete verification step the
+implementing agent must perform before considering the work done.
+
+- V1 [R1, R2]: {specific check for these requirements}
+- V2 [R3]: {specific check for this requirement}
+- ...
+
+Rules:
+- Every R-number must appear in at least one V-item.
+- Every V-item must reference at least one R-number.
+- Each V-item must verify something specific to its referenced
+  requirements. Do not satisfy requirement coverage with broad
+  health checks like "the build passes" or "tests pass" —
+  general build hygiene is a standing builder obligation, not
+  a spec concern.
+- Checks should be runnable where possible (shell commands,
+  test commands, grep patterns).
+- Include behavioral checks (call function with X, verify Y
+  in output) not just structural checks.
+
+## Test Cases
+
+Concrete test scenarios to implement as automated tests.
+Each entry: scenario description → expected behavior.
+
+Cover:
+- Happy path
+- Edge cases (empty input, missing files, malformed data)
+- Boundary conditions (when ambiguous situations arise)
+- Error cases (what happens when things go wrong)
+```
+
+#### Spec style rules
+
+- Use concrete examples, not abstract descriptions
+- Show actual file layouts, actual JSON shapes, actual TypeScript types
+- When describing behavior, use "when X, then Y" phrasing
+- Don't hedge ("might," "could," "perhaps") — commit to choices
+- Don't include status, complexity, or dispatch metadata — that's the patron's concern
+- Don't include motivation beyond the Summary — the implementing agent doesn't need to know why, just what
+- All file paths in the spec should be **relative to the repository root** — the implementing agent will work in a worktree with the same directory structure
+
+---
+
+### Step 4: Decision Compliance Check
+
+Re-read the plan's decisions (via `plan-show`) and verify the spec you just wrote against every entry. This is a point-by-point audit — not a vibes-level review.
+
+For each decision in the plan:
+
+1. **Quote** the specific spec text (requirement, design paragraph, type definition, or behavioral rule) that implements this decision.
+2. **Verify** the spec text is consistent with the decision's `selected` value (or `patronOverride` if set). Pay special attention to patron overrides — these are direct patron directives and must not be contradicted.
+3. **Flag** any decision that is:
+   - **Contradicted** — the spec says the opposite of the selected answer
+   - **Unaddressed** — no spec text implements this decision
+   - **Diluted** — the spec partially follows the answer but hedges, adds exceptions, or soft-overrides it
+
+If any decision is contradicted, unaddressed, or diluted: **fix the spec in place before proceeding.** Do not rationalize the discrepancy — fix it. Patron overrides are not suggestions.
+
+After fixing, rewrite the spec using `spec-write`.
+
+---
+
+### Step 5: Coverage Verification
+
+Validate the spec's completeness by cross-referencing against the inventory and the locked decisions.
+
+**Inventory coverage:**
+- Every file from the inventory is accounted for in the spec — either addressed in the Design section or explicitly confirmed as unaffected. If the inventory identified a file and the spec doesn't mention it, something was missed.
+
+**Decision coverage:**
+- Every decision (for in-scope items) is reflected in the spec's Design section. No decision should be locked but absent from the spec.
+
+**Scope coverage:**
+- Every included scope item has at least one requirement in the spec. No scope item should be included but unaddressed.
+
+**Requirement-Validation bidirectional check:**
+- Every R-number appears in at least one V-item.
+- Every V-item references at least one R-number.
+
+**Implementer perspective:**
+Re-read the spec as if you are the implementing agent encountering it cold:
+- Can I implement this without asking any questions?
+- Are all file paths explicit?
+- Are all type changes complete (full signatures, not fragments)?
+- Do I know what to do in every edge case?
+- Is there anything I would have to guess at?
+
+If any check fails, revise the spec in place and rewrite using `spec-write`.
+
+### Boundaries
+
+- You do NOT implement the feature. You produce the spec.
+- You do NOT make decisions. **Ever.** If the plan's decisions don't cover something you need to specify, write a gaps observation and stop. Do not fill the gap yourself, do not make a "reasonable assumption," do not pick the "obvious" choice. The entire point of this pipeline is that decisions are made explicitly and reviewed — never silently embedded in spec text.
+- You DO read the locked scope, decisions, and inventory. You DO write a complete, implementable spec.