@donotdev/cli 0.0.20 → 0.0.21

package/templates/root-consumer/guides/wai-way/agents/extractor.md.example

@@ -11,7 +11,7 @@ agent:
   title: Requirements Extractor
   icon: 🧠
   phases: ["0_brainstorm_spec", "1_scaffold_sitemap"]
-  done_when: "Spec COMPLETELY filled with user journeys, entities, rules, permissions - validated by user"
+  done_when: "PRD.md + HLD.md + LLD.md produced from spec_template.md conversation - validated by user"
 
 persona:
   role: Product Strategist & Requirements Engineer
@@ -42,7 +42,7 @@ core_principles:
   - **Spec Drift:** Any changes to the validated spec must be logged in `spec_changes.md` for human review.
 
 phase_0_brainstorm:
-  goal: DEEPLY understand the app and produce COMPLETE validated spec
+  goal: DEEPLY understand the app and produce PRD.md + HLD.md + LLD.md
   mindset: "If I can't answer any question about this app, I haven't asked enough questions yet."
 
   question_flow:
@@ -122,11 +122,16 @@ phase_0_brainstorm:
         - "Which features are 'Delighters' (Marketing/Heroes) vs 'Must-Haves' (CRUD)?"
       done_when: "Navigation hierarchy planned; high-friction paths challenged"
 
-  output: Filled spec_template.md with ALL sections complete, including Section 11 for overrides.
+  output: |
+    Three documents produced in docs/:
+    - docs/PRD.md — requirements, journeys, rules, permissions, overrides (Section 11)
+    - docs/HLD.md — architecture, preset, auth, pages, features
+    - docs/LLD.md — per-entity field specs, state machines, access matrices
+    Then: init_implementation({ from_spec: true }) → .dndev/implementation.md
 
 phase_1_scaffold:
-  goal: Create an Interactive Prototype from the validated spec
-  prerequisite: "spec_template.md is COMPLETE with no empty sections or TBDs"
+  goal: Create an Interactive Prototype from the validated documents
+  prerequisite: "docs/PRD.md, docs/HLD.md, docs/LLD.md are COMPLETE — no TBDs"
   steps:
     - Verify spec is truly complete
     - Create *Page.tsx files for each route in spec
@@ -160,6 +165,9 @@ validation_checklist:
 read_files:
   - "guides/wai-way/blueprints/0_brainstorm.md"
   - "guides/wai-way/spec_template.md"
+  - "guides/wai-way/prd_template.md"
+  - "guides/wai-way/hld_template.md"
+  - "guides/wai-way/lld_template.md"
   - "guides/wai-way/presets_guide.md"
   - "guides/wai-way/entity_patterns.md"
   - "guides/wai-way/page_patterns.md"
@@ -185,12 +193,15 @@ Activate AGENT Extractor.
 
 READ these files FIRST:
 - guides/wai-way/blueprints/0_brainstorm.md (DEEP requirements process)
-- guides/wai-way/spec_template.md (template to fill COMPLETELY)
+- guides/wai-way/spec_template.md (conversation FORMAT — the shell you fill through questions)
+- guides/wai-way/prd_template.md (OUTPUT format for Product Requirements)
+- guides/wai-way/hld_template.md (OUTPUT format for High-Level Design)
+- guides/wai-way/lld_template.md (OUTPUT format for Low-Level Design)
 - guides/wai-way/presets_guide.md (preset = config change)
 - guides/wai-way/entity_patterns.md (common entity schemas)
 - guides/wai-way/page_patterns.md (common page structures)
 
-Your goal: DEEPLY understand the app before any code.
+Your goal: DEEPLY understand the app, then produce docs/PRD.md + docs/HLD.md + docs/LLD.md.
 
 DO NOT RUSH. The #1 cause of wasted work is incomplete requirements.
 
@@ -211,7 +222,12 @@ KEEP ASKING until you can:
 - Define every entity with states and permissions
 - Answer "what happens when X?" for any scenario
 
-Only THEN fill spec_template.md and present for validation.
+Only THEN present summary for validation, and SPLIT into:
+- docs/PRD.md (requirements, journeys, rules, permissions)
+- docs/HLD.md (architecture, preset, auth, pages, features)
+- docs/LLD.md (per-entity field specs, state machines, access matrices)
+
+Then call init_implementation({ from_spec: true }) to create the macro plan.
 ```
 
 ## EXAMPLE CONVERSATION FLOW (THOROUGH)
@@ -343,3 +359,5 @@ You've done Phase 0 correctly when:
 - [ ] Every entity has CRUD permissions for every role
 - [ ] Every business rule is documented
 - [ ] User has said "yes, that's complete"
+- [ ] docs/PRD.md, docs/HLD.md, docs/LLD.md written and validated
+- [ ] .dndev/implementation.md created via init_implementation({ from_spec: true })

package/templates/root-consumer/guides/wai-way/blueprints/0_brainstorm.md.example

@@ -1,9 +1,9 @@
-# BLUEPRINT: 0_BRAINSTORM → SPEC
+# BLUEPRINT: 0_BRAINSTORM → PRD + HLD + LLD
 
-**Goal:** Deeply understand the app and document ALL requirements before any code.
+**Goal:** Deeply understand the app and produce THREE validated specification documents.
 
 **MCP:** `start_phase(0)` to begin. `complete_phase()` when done.
-**Done when:** `docs/HLD.md` is COMPLETE (using `guides/wai-way/spec_template.md` as template) and user has validated it.
+**Done when:** `docs/PRD.md`, `docs/HLD.md`, `docs/LLD.md` are COMPLETE and user has validated them.
 
 ---
 
@@ -19,7 +19,7 @@ It returns a one-line summary from each framework package README (core, ui, temp
 
 **The #1 cause of wasted work is incomplete requirements.**
 
-Before moving to Phase 1, you MUST have:
+Before producing documents, you MUST have:
 - [ ] Complete understanding of what users DO (not just what data exists)
 - [ ] All user journeys mapped step-by-step
 - [ ] Business rules and validations documented
@@ -37,7 +37,8 @@ User provides idea
     ↓
 Agent calls list_features() → matches needs to existing framework capabilities
     ↓
-    Agent asks IDENTITY questions (who, what, why, and **Aesthetic Essence**)    ↓
+Agent asks IDENTITY questions (who, what, why, and **Aesthetic Essence**)
+    ↓
 Agent asks USER JOURNEY questions (what do users DO step by step?)
     ↓
 Agent asks DATA questions (what entities, relationships, states?)
@@ -46,11 +47,13 @@ Agent asks BUSINESS RULES questions (validations, permissions, constraints)
     ↓
 Agent asks EDGE CASE questions (what if X fails? what about Y?)
     ↓
-Agent fills spec template
+Agent fills spec_template.md FORMAT through conversation
+    ↓
+Agent presents summary for user validation
     ↓
-Agent presents spec for validation
+User confirms → Agent SPLITS into PRD.md + HLD.md + LLD.md
     ↓
-User confirms OR agent asks more questions
+Agent calls init_implementation({ from_spec: true }) → creates implementation.md
 ```
 
 ---
@@ -144,7 +147,7 @@ Ask about validations and constraints:
 ```
 ## Business Rules: Orders
 
-- Order total = sum(item.price × item.quantity) + shipping - discount
+- Order total = sum(item.price x item.quantity) + shipping - discount
 - Discount cannot exceed 50% of subtotal
 - Order cannot be cancelled after shipping
 - Stock is reserved when order is confirmed, released if cancelled
@@ -188,35 +191,50 @@ For EACH entity AND action:
 
 ---
 
-### 7. NON-FUNCTIONAL (The "How Well")
+### 7. UX INTENT (The "Where + Flow")
 
-- "How fast should [action] be?"
-- "How many [entities] will exist? (10? 1000? 1M?)"
-- "Who needs to be notified when [event]?"
-- "What needs to work offline?"
-- "What needs real-time updates?"
+- "Where should the shortcut for the North Star action live? (Goal: < 2 clicks)"
+- "Which features are 'Delighters' (Marketing/Heroes) vs 'Must-Haves' (CRUD)?"
 
 ---
 
-## Filling the Spec Template
-
-Only after ALL questions are answered, fill `spec_template.md`:
-
-1. **Identity** - Name, tagline, users
-2. **User Journeys** - Step-by-step flows (NEW)
-3. **Preset** - Based on app type
-4. **Auth** - Providers, roles
-5. **Billing** - If needed
-6. **Entities** - With relationships and states (EXPANDED)
-7. **Business Rules** - Validations, calculations (NEW)
-8. **Pages** - Derived from user journeys
-9. **Features** - i18n, PWA, etc.
+## Producing the Documents
+
+Only after ALL questions are answered, use `spec_template.md` as the FORMAT to organize gathered information, then SPLIT into three documents:
+
+### What Goes Where
+
+**`docs/PRD.md`** (from `prd_template.md`):
+- Identity (name, users, value prop, North Star)
+- User journeys (numbered steps, success/failure criteria)
+- Business rules (validations, calculations, triggers)
+- Permissions matrix (who can CRUD what)
+- Edge cases and error handling
+- Design decision overrides
+
+**`docs/HLD.md`** (from `hld_template.md`):
+- Preset selection and rationale
+- Auth model (providers, roles, self-registration)
+- Billing model (if applicable)
+- Aesthetic essence
+- Page map (routes, purpose, which journey they serve)
+- Entity relationship diagram (text-based overview)
+- Feature flags (i18n, PWA, real-time, uploads, etc.)
+- Architecture decisions and trade-offs
+
+**`docs/LLD.md`** (from `lld_template.md`):
+- Per-entity detailed spec:
+  - Field definitions (name, type, required, validation, visibility)
+  - State machine (from/to/trigger/who/side-effects)
+  - Relationships (type, target, via field, cascade rule)
+  - Access matrix (CRUD per role per condition)
+- Cross-entity validation rules
 
 ---
 
 ## Validation: The Completeness Test
 
-Before presenting spec to user, verify:
+Before producing the three documents, verify:
 
 ### Can You Answer These?
 
@@ -227,24 +245,24 @@ Before presenting spec to user, verify:
 - [ ] "Who can [action] on [entity]?" → Know for every combination
 - [ ] "What if [failure scenario]?" → Have answer for common failures
 
-### Is The Spec Complete?
-
-- [ ] Every entity has fields, relationships, states documented
-- [ ] Every user journey has numbered steps
-- [ ] Every business rule is explicit
-- [ ] Every permission is defined
-- [ ] No "TBD" or "TODO" in the spec
+### Is Everything Complete?
 
-**If ANY checkbox is unchecked, ask more questions.**
+- [ ] Every user journey has 5+ numbered steps
+- [ ] Every entity has fields, states, and state transitions
+- [ ] Every entity has CRUD permissions for every role
+- [ ] Every business rule is documented explicitly
+- [ ] Every page traces back to a user journey
+- [ ] No "TBD", "TODO", or empty fields
+- [ ] User has said "yes, that's complete"
 
 ---
 
-## Presenting the Spec
+## Presenting for Validation
 
-When spec is complete, present it as:
+When ready, present a summary:
 
 ```markdown
-## App Specification Summary
+## Specification Summary
 
 ### Identity
 **Name:** [App Name]
@@ -281,18 +299,17 @@ What's missing or incorrect?
 
 ## Output
 
-Completed spec_template.md with:
-- All user journeys mapped
-- All entities with relationships and states
-- All business rules documented
-- All permissions defined
-- User validation
+User validates → produce three documents in `docs/`:
+
+1. **`docs/PRD.md`** — requirements, journeys, rules, permissions
+2. **`docs/HLD.md`** — architecture, preset, auth, pages, features
+3. **`docs/LLD.md`** — detailed entity specs, state machines, access matrices
 
-**After spec validation, generate the implementation tracker:**
+Then generate the implementation tracker:
 ```
 init_implementation({ from_spec: true })
 ```
-This creates `.dndev/implementation.md` with checklist items for all phases (pages, entities, composition, config). Agents will read and update this file across sessions.
+This creates `.dndev/implementation.md` with checklist items for all phases.
 
-**Spec validated AND complete? Move to Phase 1: SCAFFOLD.**
+**Documents validated AND complete? Move to Phase 1: SCAFFOLD.**
 **Anything unclear? Keep asking questions.**

package/templates/root-consumer/guides/wai-way/blueprints/1_scaffold.md.example

@@ -5,7 +5,7 @@
 **MCP:** `start_phase(1)` to begin. `complete_phase()` when done.
 **Done when:** All routes listed, all *Page.tsx files created with correct PageMeta.
 
-**Prerequisite:** Phase 0 (spec) must be complete.
+**Prerequisite:** Phase 0 complete — `docs/PRD.md`, `docs/HLD.md`, `docs/LLD.md` validated.
 
 ---
 
@@ -51,17 +51,18 @@ It shows the canonical pattern:
 
 ---
 
-## Step 3: Review Spec Pages
+## Step 3: Review Pages from HLD
 
-From your spec, you have a list of pages. Now create them.
+From `docs/HLD.md` section 5 (Page Map), you have the list of pages. Now create them.
 
+**READ:** `docs/HLD.md` for the page map and `docs/PRD.md` for the user journeys they serve.
 **READ:** `guides/wai-way/page_patterns.md` for page structure patterns.
 
 ---
 
-## Step 3: Create Page Files
+## Step 4: Create Page Files
 
-For each page in spec:
+For each page in HLD page map:
 
 ```bash
 touch src/pages/AboutPage.tsx

package/templates/root-consumer/guides/wai-way/blueprints/2_entities.md.example

@@ -1,17 +1,17 @@
 # BLUEPRINT: 2_ENTITIES
 
-**Goal:** Define all data models from spec (Single Source of Truth).
+**Goal:** Define all data models from `docs/LLD.md` (Single Source of Truth).
 
 **MCP:** `start_phase(2)` to begin. Use `lookup_symbol('defineEntity')` for types. `complete_phase()` when done.
 **Done when:** All entities defined with fields, access rules, visibility. Exported from index.ts.
 
-**Prerequisite:** Phase 0 (spec) and Phase 1 (scaffold) complete.
+**Prerequisite:** Phase 0 (PRD + HLD + LLD) and Phase 1 (scaffold) complete.
 
 ---
 
-## Step 1: Review Spec Entities
+## Step 1: Review LLD Entities
 
-From your spec, you have a list of entities with fields and access rules.
+From `docs/LLD.md`, you have the per-entity specs: fields, state machines, relationships, access matrices.
 
 **READ:** `guides/wai-way/entity_patterns.md` for common schemas:
 - UserProfile, Post, Product, Order, Review, Comment
@@ -21,12 +21,12 @@ From your spec, you have a list of entities with fields and access rules.
 
 ## Step 2: Create Entity Files
 
-For each entity in spec:
+For each entity in `docs/LLD.md`:
 
 1. Find matching pattern in `entity_patterns.md`
 2. Copy pattern → `entities/[Entity].ts`
-3. Customize fields from spec
-4. Set access rules from spec
+3. Customize fields from LLD field definitions
+4. Set access rules from LLD access matrix
 
 **READ:** `entities/ExampleEntity.ts` for the base pattern.
 
@@ -106,6 +106,6 @@ export { orderEntity } from './Order';
 ## Output
 
 - [ ] All entities from spec defined in `entities/`
-- [ ] Fields match spec
-- [ ] Access rules match spec
+- [ ] Fields match LLD
+- [ ] Access rules match LLD
 - [ ] Exported from `entities/index.ts`

package/templates/root-consumer/guides/wai-way/blueprints/3_compose.md.example

@@ -5,7 +5,7 @@
 **MCP:** `start_phase(3)` to begin. Use `lookup_symbol(component_name)` for types. `complete_phase()` when done.
 **Done when:** All pages functional with content. CRUD pages use EntityList/EntityFormRenderer. All strings hardcoded.
 
-**Prerequisite:** Phase 0-2 complete. Spec validated, entities defined.
+**Prerequisite:** Phase 0-2 complete. PRD + HLD + LLD validated, entities defined.
 
 ---
 

package/templates/root-consumer/guides/wai-way/blueprints/4_configure.md.example

@@ -5,7 +5,7 @@
 **MCP:** `start_phase(4)` to begin. `complete_phase({ files: [...], lesson: "..." })` when done.
 **Done when:** Tests pass, config complete, firestore rules generated.
 
-**Prerequisite:** Phase 0-3 complete. App is functional with hardcoded strings.
+**Prerequisite:** Phase 0-3 complete. PRD + HLD + LLD validated, app is functional with hardcoded strings.
 
 ---
 
@@ -41,7 +41,8 @@ import '@testing-library/jest-dom';
 ## Step 2: Generate Entity Tests
 
 **READ:** `entities/index.ts` — get the list of all entities.
-**READ:** `guides/wai-way/spec_template.md` — get the permissions matrix and business rules.
+**READ:** `docs/PRD.md` — get the permissions matrix and business rules.
+**READ:** `docs/LLD.md` — get the per-entity access matrices.
 
 For **each entity** in `entities/`, create `tests/entities/[EntityName].test.ts`:
 
@@ -61,13 +62,13 @@ For **each page**, create `tests/pages/[PageName].test.tsx`:
 
 - [ ] Page renders without error
 - [ ] PageMeta is defined (title, auth, admin)
-- [ ] Route protection matches spec (public pages have `auth: false`, protected have `auth: true`, admin have `admin: true`)
+- [ ] Route protection matches HLD page map (public pages have `auth: false`, protected have `auth: true`, admin have `admin: true`)
 
 ---
 
 ## Step 4: Generate Access Control Tests
 
-**READ:** The spec's permissions section.
+**READ:** `docs/PRD.md` permissions matrix and `docs/LLD.md` access matrices.
 
 Create `tests/access/access-rules.test.ts`:
 
@@ -99,9 +100,9 @@ Create `firestore.rules` from entity access rules:
 
 ### app.ts
 **READ:** `src/config/app.ts`
-- [ ] `APP_NAME` from spec
+- [ ] `APP_NAME` from PRD
 - [ ] `APP_SHORT_NAME` abbreviation
-- [ ] `preset` from spec (landing/admin/moolti/docs/blog/game/plain)
+- [ ] `preset` from HLD (landing/admin/moolti/docs/blog/game/plain)
 - [ ] Footer legal links
 
 ### legal.ts

package/templates/root-consumer/guides/wai-way/context_map.json.example

@@ -1,36 +1,51 @@
 {
   "description": "WAI-WAY context map - maps phases to required files. READ the scaffolded files, they contain inline documentation.",
   "golden_rule": "THE SCAFFOLDED FILES ARE YOUR DOCUMENTATION. Read the file. Follow the pattern. Extend.",
+  "document_chain": {
+    "spec_template.md": "FORMAT — the empty shell the Extractor fills through conversation. NOT kept as-is.",
+    "docs/PRD.md": "OUTPUT — Product Requirements (journeys, rules, permissions). The WHAT.",
+    "docs/HLD.md": "OUTPUT — High-Level Design (preset, auth, pages, features). The HOW (big picture).",
+    "docs/LLD.md": "OUTPUT — Low-Level Design (per-entity specs, state machines, access). The HOW (detailed).",
+    ".dndev/implementation.md": "MACRO PLAN — checklist per phase. Versioned, archived per project version.",
+    ".dndev/captain-log.json": "SESSION HISTORY — auto-recorded on approve_phase. Never deleted.",
+    ".dndev/LESSONS.md": "GOTCHAS — tagged, scored, filtered by phase. Never deleted."
+  },
   "phases": {
-    "0_brainstorm_spec": {
+    "0_brainstorm": {
       "agent": "extractor",
-      "goal": "Gather requirements through conversation and produce validated spec",
-      "flow": "User idea → Agent questions → Agent fills spec → User validates",
-      "done_when": "spec_template.md filled and validated by user",
+      "goal": "Gather requirements through conversation and produce validated specification documents",
+      "flow": "User idea → Agent questions (using spec_template.md format) → User validates → Agent splits into PRD + HLD + LLD",
+      "done_when": "docs/PRD.md + docs/HLD.md + docs/LLD.md complete and validated by user",
       "read_files": [
         "guides/wai-way/spec_template.md",
+        "guides/wai-way/prd_template.md",
+        "guides/wai-way/hld_template.md",
+        "guides/wai-way/lld_template.md",
         "guides/wai-way/presets_guide.md",
         "guides/wai-way/entity_patterns.md",
         "guides/wai-way/page_patterns.md"
       ],
-      "output": "Validated spec with preset, entities, pages, auth/billing requirements"
+      "output": "docs/PRD.md, docs/HLD.md, docs/LLD.md, .dndev/implementation.md"
     },
-    "1_scaffold_sitemap": {
+    "1_scaffold": {
       "agent": "extractor",
-      "goal": "Running app with all routes defined",
-      "done_when": "All routes listed, all *Page.tsx files created with correct PageMeta",
+      "goal": "Running app with all routes defined as interactive prototype stubs",
+      "done_when": "All routes listed, all *Page.tsx files created with correct PageMeta, clickable prototype",
       "read_files": [
+        "docs/PRD.md",
+        "docs/HLD.md",
         "src/pages/HomePage.tsx",
         "src/config/app.ts",
         "guides/wai-way/page_patterns.md"
       ],
-      "output": "All *Page.tsx files created with correct PageMeta"
+      "output": "All *Page.tsx files created with PageMeta, clickable prototype"
     },
     "2_entities": {
       "agent": "architect",
-      "goal": "Define all data models",
+      "goal": "Define all data models from LLD",
       "done_when": "All entities defined with fields, access, visibility. Exported from index.ts",
       "read_files": [
+        "docs/LLD.md",
         "entities/ExampleEntity.ts",
         "entities/index.ts",
         "guides/wai-way/entity_patterns.md"
@@ -42,6 +57,8 @@
       "goal": "Build pages with components (hardcoded strings)",
       "done_when": "All pages functional, CRUD uses EntityList/EntityFormRenderer, strings hardcoded",
       "read_files": [
+        "docs/PRD.md",
+        "docs/HLD.md",
         "src/pages/ListPageExample.tsx",
         "src/pages/FormPageExample.tsx",
         "src/pages/HomePage.tsx",
@@ -51,24 +68,38 @@
     },
     "4_configure_test": {
       "agent": "polisher",
-      "goal": "Generate tests from spec, firestore rules from entities, finalize config",
+      "goal": "Generate tests, firestore rules, CI/CD, finalize config",
       "done_when": "Tests pass, firestore.rules generated, config complete, mobile responsive",
       "read_files": [
-        "guides/wai-way/spec_template.md",
+        "docs/PRD.md",
+        "docs/LLD.md",
         "entities/index.ts",
         "src/config/app.ts",
         "src/config/legal.ts",
         "guides/dndev/SETUP_TESTING.md"
       ],
-      "output": "Test files, firestore.rules, configured app"
+      "output": "Test files, firestore.rules, CI/CD, configured app"
     }
   },
   "key_files": {
-    "spec": {
-      "guides/wai-way/spec_template.md": "App specification template - fill before coding",
-      "guides/wai-way/presets_guide.md": "Preset decision matrix - landing/admin/moolti/docs/blog/game/plain",
-      "guides/wai-way/entity_patterns.md": "Common entity schemas - UserProfile, Post, Product, Order, etc.",
-      "guides/wai-way/page_patterns.md": "Common page structures - Dashboard, List, Form, Landing, Settings, etc."
+    "spec_documents": {
+      "docs/PRD.md": "Product Requirements — journeys, rules, permissions (produced by P0)",
+      "docs/HLD.md": "High-Level Design — preset, auth, pages, features (produced by P0)",
+      "docs/LLD.md": "Low-Level Design — per-entity specs, state machines, access (produced by P0)"
+    },
+    "spec_formats": {
+      "guides/wai-way/spec_template.md": "Conversation FORMAT — empty shell agent fills through questions",
+      "guides/wai-way/prd_template.md": "Output FORMAT for PRD.md",
+      "guides/wai-way/hld_template.md": "Output FORMAT for HLD.md",
+      "guides/wai-way/lld_template.md": "Output FORMAT for LLD.md",
+      "guides/wai-way/presets_guide.md": "Preset decision matrix",
+      "guides/wai-way/entity_patterns.md": "Common entity schemas",
+      "guides/wai-way/page_patterns.md": "Common page structures"
+    },
+    "operational": {
+      ".dndev/implementation.md": "Active macro plan — checklist per phase (versioned)",
+      ".dndev/captain-log.json": "Full session history — auto-recorded (never deleted)",
+      ".dndev/LESSONS.md": "Decisions, gotchas, anti-patterns (never deleted)"
     },
     "config": {
       "src/config/app.ts": "App name, preset, features, auth routes",
@@ -90,7 +121,7 @@
     }
   },
   "workflow": {
-    "summary": "BRAINSTORM (→ spec) → SCAFFOLD → ENTITIES → COMPOSE → CONFIGURE + TEST",
-    "critical_rule": "Spec is OUTPUT of brainstorming. User validates before coding. Validated spec = mechanical build."
+    "summary": "BRAINSTORM (→ PRD + HLD + LLD) → SCAFFOLD → ENTITIES → COMPOSE → CONFIGURE + TEST",
+    "critical_rule": "spec_template.md is the FORMAT. P0 produces PRD + HLD + LLD. Validated documents = mechanical build."
   }
 }