hool-cli 0.2.1 → 0.3.0

package/dist/adapters/claude-code.js

@@ -2,6 +2,8 @@ import fs from 'fs/promises';
 import path from 'path';
 import os from 'os';
 const CLAUDE_MCP_CONFIG_PATH = path.join(os.homedir(), '.claude', 'mcp_servers.json');
+const HOOL_START_MARKER = '<!-- HOOL:START -->';
+const HOOL_END_MARKER = '<!-- HOOL:END -->';
 function getMcpSection(projectType) {
     const mcps = ['- **context7**: Use `mcp__context7__resolve-library-id` and `mcp__context7__query-docs` for up-to-date library documentation'];
     if (['web-app', 'browser-game', 'animation'].includes(projectType)) {
@@ -12,8 +14,9 @@ function getMcpSection(projectType) {
     }
     return mcps.join('\n');
 }
-function generateClaudeMd(config) {
-    return `# HOOL — Agent-Driven SDLC
+function generateClaudeMd(config, orchestratorContent) {
+    return `${HOOL_START_MARKER}
+# HOOL — Agent-Driven SDLC
 
 This project uses the HOOL framework. The Product Lead is the sole user-facing agent.
 All other agents are internal — dispatched by the Product Lead as subagents.
@@ -21,12 +24,12 @@ All other agents are internal — dispatched by the Product Lead as subagents.
 ## Quick Start
 
 You are the Product Lead. On every invocation — **before answering any question**:
-1. Read \`.hool/prompts/orchestrator.md\` — your full process and rules
-2. Read \`operations/current-phase.md\` to know where you are
-3. Read \`operations/task-board.md\` to know what's in flight
-4. Read your memory files (\`memory/product-lead/hot.md\`, \`best-practices.md\`, \`issues.md\`)
+1. Read \`operations/current-phase.md\` to know where you are
+2. Read \`operations/task-board.md\` to know what's in flight
+3. Read your memory files (\`memory/product-lead/hot.md\`, \`best-practices.md\`, \`issues.md\`)
+4. Read the full orchestrator prompt below — your complete process and rules
 5. **If there are pending tasks**: Tell the user what's pending and ask if you should proceed, or if they have something else in mind. Do NOT silently wait for explicit instructions — you are the driver, not a passenger.
-6. Continue from where you left off (see Autonomous Execution Loop in orchestrator.md)
+6. Continue from where you left off (see Autonomous Execution Loop below)
 
 ## How to Dispatch Subagents
 
@@ -62,24 +65,49 @@ Phase 4 (Architecture) is the FINAL human gate. After that, you run autonomously
 - You are the **sole user-facing agent** — the user only talks to you
 - All state lives in files: \`phases/\`, \`operations/\`, \`memory/\`
 - Agents never modify their own prompts — escalate to \`operations/needs-human-review.md\`
-- Read your full orchestrator prompt at \`.hool/prompts/orchestrator.md\` for the complete process
+
+---
+
+## Orchestrator Prompt
+
+${orchestratorContent}
+${HOOL_END_MARKER}
 `;
 }
 export class ClaudeCodeAdapter {
     platform = 'claude-code';
     async injectInstructions(config) {
         const claudeMdPath = path.join(config.projectDir, 'CLAUDE.md');
-        const content = generateClaudeMd(config);
-        // Append to existing CLAUDE.md or create new
+        const orchestratorPath = path.join(config.projectDir, '.hool', 'prompts', 'orchestrator.md');
+        let orchestratorContent = '';
+        try {
+            orchestratorContent = await fs.readFile(orchestratorPath, 'utf-8');
+        }
+        catch {
+            // Fallback: read from promptsDir (source) if .hool/prompts doesn't exist yet
+            try {
+                orchestratorContent = await fs.readFile(path.join(config.promptsDir, 'orchestrator.md'), 'utf-8');
+            }
+            catch {
+                orchestratorContent = '<!-- orchestrator.md not found — run hool init to generate -->';
+            }
+        }
+        const content = generateClaudeMd(config, orchestratorContent);
+        // Replace between markers, append, or create new
         try {
             const existing = await fs.readFile(claudeMdPath, 'utf-8');
-            if (existing.includes('HOOL')) {
-                // Already has HOOL instructions, replace
-                const marker = '# HOOL — Agent-Driven SDLC';
-                const idx = existing.indexOf(marker);
-                if (idx >= 0) {
-                    await fs.writeFile(claudeMdPath, existing.slice(0, idx) + content, 'utf-8');
-                }
+            const startIdx = existing.indexOf(HOOL_START_MARKER);
+            const endIdx = existing.indexOf(HOOL_END_MARKER);
+            if (startIdx >= 0 && endIdx >= 0) {
+                // Marker-based replacement — clean upgrade path
+                const before = existing.slice(0, startIdx);
+                const after = existing.slice(endIdx + HOOL_END_MARKER.length);
+                await fs.writeFile(claudeMdPath, before + content + after, 'utf-8');
+            }
+            else if (existing.includes('# HOOL')) {
+                // Legacy format (pre-markers) — replace from old header onwards
+                const legacyIdx = existing.indexOf('# HOOL');
+                await fs.writeFile(claudeMdPath, existing.slice(0, legacyIdx) + content, 'utf-8');
             }
             else {
                 await fs.writeFile(claudeMdPath, existing + '\n\n' + content, 'utf-8');
@@ -118,7 +146,7 @@ export class ClaudeCodeAdapter {
             '',
             '  Start building:',
             '    $ claude',
-            '    > Read .hool/prompts/orchestrator.md and begin Phase 1: Brainstorm',
+            '    > Begin Phase 1: Brainstorm',
             '',
             '  Or if you have the /hool skill registered:',
             '    > /hool start',

package/dist/adapters/claude-code.js.map

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

package/dist/core/templates.js

@@ -19,25 +19,29 @@ export function getOnboardOperationTemplates(mode = 'interactive') {
 - **Phase**: onboarding
 - **Status**: awaiting-analysis
 
-Onboarding an existing project. The Product Lead will:
-1. Scan the project and generate a project profile
-2. Extract architecture, contracts, schema from existing code
-3. Infer a spec from observed behavior (needs human review)
-4. Run gap analysis and surface issues
-5. Seed agent memory with findings
-6. Present a summary for human review
+Onboarding an existing project. See the "Onboarding Process" section in the orchestrator prompt for the full scan checklist and phase doc requirements. The Product Lead will:
+1. Full project scan — read ALL docs, configs, code structure, git history
+2. Reverse-engineer EVERY applicable phase doc (brainstorm, spec, design, architecture, LLDs, test plan)
+3. Populate operations files (bugs from TODOs, tech debt, inconsistencies, client preferences)
+4. Seed agent memory with findings
+5. Present comprehensive summary for human review
 
 After onboarding completes and human reviews, phase transitions to **standby**.
 `,
         'task-board.md': `# Task Board
 
 ## Active Tasks
-- [ ] ONBOARD-001: Project discovery — scan codebase, identify stack
-- [ ] ONBOARD-002: Architecture extraction — reverse-engineer architecture docs
-- [ ] ONBOARD-003: Spec inference — infer product spec from code behavior
-- [ ] ONBOARD-004: Gap analysis — surface issues, tech debt, inconsistencies
-- [ ] ONBOARD-005: Seed agent memory — route findings to agent memory files
-- [ ] ONBOARD-006: Human review gate — present summary for review
+- [ ] ONBOARD-001: Full project scan — read ALL docs (README, CLAUDE.md, CONTRIBUTING, CHANGELOG, docs/, AI instruction files), ALL configs (package.json/pyproject.toml/etc, tsconfig, eslint, docker, CI/CD, .env.example), ALL existing memory (memory/*/best-practices.md, issues.md, cold.md, governor-feedback.md — PRESERVE these), any MEMORY.md/LEARNINGS.md/docs/.agent-memory/, existing HOOL state (operations/, phases/, .hool/*.json), map directory tree, identify entry points, git log -50, git shortlog -sn | assigned: product-lead
+- [ ] ONBOARD-002: Brainstorm extraction — reverse-engineer phases/01-brainstorm/brainstorm.md from README, docs, git history. Capture: vision, goals, target users, key decisions, constraints. Tag all items [INFERRED] | assigned: product-lead | depends: ONBOARD-001
+- [ ] ONBOARD-003: Spec inference — reverse-engineer phases/02-spec/spec.md from code behavior, existing tests (test names ARE spec), API endpoints, UI screens, docs. Write user stories with acceptance criteria. Tag each: [FROM-CODE], [FROM-TESTS], [FROM-DOCS], [INFERRED]. Flag anything that looks like a bug | assigned: product-lead | depends: ONBOARD-001
+- [ ] ONBOARD-004: Architecture extraction — reverse-engineer phases/04-architecture/architecture.md, contracts/, schema.md, flows/ from code structure, configs, dependency graph, API routes, DB schemas/migrations/models | assigned: product-lead | depends: ONBOARD-001
+- [ ] ONBOARD-005: Design extraction (if FE exists) — reverse-engineer phases/03-design/design.md from frontend components, CSS/design tokens, layouts. Skip if no frontend | assigned: product-lead | depends: ONBOARD-001
+- [ ] ONBOARD-006: FE LLD extraction (if FE exists) — reverse-engineer phases/05-fe-scaffold/fe-lld.md from frontend code patterns, component hierarchy, routing, state management. Skip if no frontend | assigned: product-lead | depends: ONBOARD-004
+- [ ] ONBOARD-007: BE LLD extraction (if BE exists) — reverse-engineer phases/06-be-scaffold/be-lld.md from backend code patterns, service layer, middleware, data access. Skip if no backend | assigned: product-lead | depends: ONBOARD-004
+- [ ] ONBOARD-008: Test plan extraction — reverse-engineer phases/07-test-plan/test-plan.md from existing test files, test configs, CI test commands. Map existing tests to spec stories. Capture coverage gaps | assigned: product-lead | depends: ONBOARD-003
+- [ ] ONBOARD-009: Operations population — scan for TODOs/FIXMEs/HACK (→ bugs.md), tech debt/code smells (→ issues.md), doc-vs-code gaps (→ inconsistencies.md), infer client preferences from configs/lint rules (→ client-preferences.md) | assigned: product-lead | depends: ONBOARD-001
+- [ ] ONBOARD-010: Seed agent memory — route findings to agent memory files (see orchestrator "Memory Seeding" section for per-agent routing). Write each finding from the receiving agent's perspective. A finding CAN go to multiple agents if actionable from each role. Skip agents the project doesn't use. Append to existing memory, don't overwrite | assigned: product-lead | depends: ONBOARD-002 ONBOARD-003 ONBOARD-004 ONBOARD-009
+- [ ] ONBOARD-011: Human review gate — write summary to needs-human-review.md listing every phase doc produced with confidence level, all inconsistencies, all issues. Present to user for review | assigned: product-lead | depends: ONBOARD-010
 
 ## Completed Tasks
 _None._
@@ -70,25 +74,29 @@ export function getOnboardCurrentPhase(mode = 'interactive') {
 - **Phase**: onboarding
 - **Status**: awaiting-analysis
 
-Onboarding an existing project. The Product Lead will:
-1. Scan the project and generate a project profile
-2. Extract architecture, contracts, schema from existing code
-3. Infer a spec from observed behavior (needs human review)
-4. Run gap analysis and surface issues
-5. Seed agent memory with findings
-6. Present a summary for human review
+Onboarding an existing project. See the "Onboarding Process" section in the orchestrator prompt for the full scan checklist and phase doc requirements. The Product Lead will:
+1. Full project scan — read ALL docs, configs, code structure, git history
+2. Reverse-engineer EVERY applicable phase doc (brainstorm, spec, design, architecture, LLDs, test plan)
+3. Populate operations files (bugs from TODOs, tech debt, inconsistencies, client preferences)
+4. Seed agent memory with findings
+5. Present comprehensive summary for human review
 
 After onboarding completes and human reviews, phase transitions to **standby**.
 `;
 }
 export function getOnboardTasksPrepend() {
     return `## Re-onboard Tasks
-- [ ] ONBOARD-001: Project discovery — scan codebase, identify stack
-- [ ] ONBOARD-002: Architecture extraction — reverse-engineer architecture docs
-- [ ] ONBOARD-003: Spec inference — infer product spec from code behavior
-- [ ] ONBOARD-004: Gap analysis — surface issues, tech debt, inconsistencies
-- [ ] ONBOARD-005: Seed agent memory — route findings to agent memory files
-- [ ] ONBOARD-006: Human review gate — present summary for review
+- [ ] ONBOARD-001: Full project scan — read ALL docs (README, CLAUDE.md, CONTRIBUTING, CHANGELOG, docs/, AI instruction files), ALL configs (package.json/pyproject.toml/etc, tsconfig, eslint, docker, CI/CD, .env.example), ALL existing memory (memory/*/best-practices.md, issues.md, cold.md, governor-feedback.md — PRESERVE these), any MEMORY.md/LEARNINGS.md/docs/.agent-memory/, existing HOOL state (operations/, phases/, .hool/*.json), map directory tree, identify entry points, git log -50, git shortlog -sn. Compare against existing phase docs for drift | assigned: product-lead
+- [ ] ONBOARD-002: Update brainstorm — compare phases/01-brainstorm/brainstorm.md against current README/docs/git history. Update or create if missing. Tag changes [RE-ONBOARD] | assigned: product-lead | depends: ONBOARD-001
+- [ ] ONBOARD-003: Update spec — compare phases/02-spec/spec.md against current code behavior, tests, API endpoints. Add new stories, mark removed features. Tag: [FROM-CODE], [FROM-TESTS], [FROM-DOCS], [INFERRED] | assigned: product-lead | depends: ONBOARD-001
+- [ ] ONBOARD-004: Update architecture — compare phases/04-architecture/ against current code structure, configs, deps. Update architecture.md, contracts/, schema.md, flows/ | assigned: product-lead | depends: ONBOARD-001
+- [ ] ONBOARD-005: Update design (if FE exists) — compare phases/03-design/ against current frontend. Skip if no frontend | assigned: product-lead | depends: ONBOARD-001
+- [ ] ONBOARD-006: Update FE LLD (if FE exists) — compare phases/05-fe-scaffold/fe-lld.md against current frontend code. Skip if no frontend | assigned: product-lead | depends: ONBOARD-004
+- [ ] ONBOARD-007: Update BE LLD (if BE exists) — compare phases/06-be-scaffold/be-lld.md against current backend code. Skip if no backend | assigned: product-lead | depends: ONBOARD-004
+- [ ] ONBOARD-008: Update test plan — compare phases/07-test-plan/ against current test files. Map new tests to stories. Flag coverage gaps | assigned: product-lead | depends: ONBOARD-003
+- [ ] ONBOARD-009: Update operations — rescan for TODOs/FIXMEs (→ bugs.md), tech debt (→ issues.md), doc-vs-code gaps (→ inconsistencies.md), preferences from configs (→ client-preferences.md) | assigned: product-lead | depends: ONBOARD-001
+- [ ] ONBOARD-010: Seed agent memory — route findings to agent memory files (see orchestrator "Memory Seeding" section for per-agent routing). Write each finding from the receiving agent's perspective. A finding CAN go to multiple agents if actionable from each role. Skip agents the project doesn't use. Append to existing memory, don't overwrite | assigned: product-lead | depends: ONBOARD-002 ONBOARD-003 ONBOARD-004 ONBOARD-009
+- [ ] ONBOARD-011: Human review gate — write summary to needs-human-review.md listing changes since last onboard, new inconsistencies, updated phase docs with confidence levels | assigned: product-lead | depends: ONBOARD-010
 
 `;
 }

package/dist/core/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/core/templates.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,qBAAqB,CAAC,OAAe,aAAa;IAChE,OAAO;QACL,kBAAkB,EAAE,kCAAkC,IAAI,sDAAsD;QAEhH,eAAe,EAAE,mFAAmF;QAEpG,SAAS,EAAE,4CAA4C;QAEvD,WAAW,EAAE,uCAAuC;QAEpD,oBAAoB,EAAE,wDAAwD;QAE9E,uBAAuB,EAAE,2DAA2D;QAEpF,uBAAuB,EAAE,gOAAgO;QAEzP,mBAAmB,EAAE,i4BAAi4B;QAEt5B,iBAAiB,EAAE,sCAAsC;KAC1D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,OAAe,aAAa;IACvE,OAAO;QACL,kBAAkB,EAAE;;cAEV,IAAI;;;;;;;;;;;;;CAajB;QAEG,eAAe,EAAE;;;;;;;;;;;;CAYpB;QAEG,SAAS,EAAE;;;CAGd;QAEG,WAAW,EAAE;;;CAGhB;QAEG,oBAAoB,EAAE;;;CAGzB;QAEG,uBAAuB,EAAE;;;CAG5B;QAEG,uBAAuB,EAAE,gOAAgO;QAEzP,mBAAmB,EAAE,i4BAAi4B;QAEt5B,iBAAiB,EAAE,sCAAsC;KAC1D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAe,aAAa;IACjE,OAAO;;cAEK,IAAI;;;;;;;;;;;;;CAajB,CAAC;AACF,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO;;;;;;;;CAQR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,QAAQ,EAAE,kGAAkG;QAE5G,SAAS,EAAE,gBAAgB;QAE3B,mBAAmB,EAAE,4DAA4D;QAEjF,WAAW,EAAE,oDAAoD;QAEjE,sBAAsB,EAAE,6CAA6C;KACtE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/core/templates.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,qBAAqB,CAAC,OAAe,aAAa;IAChE,OAAO;QACL,kBAAkB,EAAE,kCAAkC,IAAI,sDAAsD;QAEhH,eAAe,EAAE,mFAAmF;QAEpG,SAAS,EAAE,4CAA4C;QAEvD,WAAW,EAAE,uCAAuC;QAEpD,oBAAoB,EAAE,wDAAwD;QAE9E,uBAAuB,EAAE,2DAA2D;QAEpF,uBAAuB,EAAE,gOAAgO;QAEzP,mBAAmB,EAAE,i4BAAi4B;QAEt5B,iBAAiB,EAAE,sCAAsC;KAC1D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,OAAe,aAAa;IACvE,OAAO;QACL,kBAAkB,EAAE;;cAEV,IAAI;;;;;;;;;;;;CAYjB;QAEG,eAAe,EAAE;;;;;;;;;;;;;;;;;CAiBpB;QAEG,SAAS,EAAE;;;CAGd;QAEG,WAAW,EAAE;;;CAGhB;QAEG,oBAAoB,EAAE;;;CAGzB;QAEG,uBAAuB,EAAE;;;CAG5B;QAEG,uBAAuB,EAAE,gOAAgO;QAEzP,mBAAmB,EAAE,i4BAAi4B;QAEt5B,iBAAiB,EAAE,sCAAsC;KAC1D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAe,aAAa;IACjE,OAAO;;cAEK,IAAI;;;;;;;;;;;;CAYjB,CAAC;AACF,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO;;;;;;;;;;;;;CAaR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,QAAQ,EAAE,kGAAkG;QAE5G,SAAS,EAAE,gBAAgB;QAE3B,mBAAmB,EAAE,4DAA4D;QAEjF,WAAW,EAAE,oDAAoD;QAEjE,sBAAsB,EAAE,6CAA6C;KACtE,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hool-cli",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Agent-Driven SDLC — scaffold and configure HOOL for any project",
   "bin": {
     "hool": "./dist/index.js"

package/prompts/orchestrator.md

@@ -83,6 +83,142 @@ You may ONLY write to these paths:
 
 ---
 
+## Onboarding Process (Existing Codebase)
+
+When `operations/current-phase.md` says **phase: onboarding**, you are reverse-engineering an existing project into HOOL's phase structure. Your goal: read EVERYTHING available and fill as many phase docs as the evidence supports.
+
+### What to Scan (Prescriptive — Read ALL of These)
+
+**Documentation first** — the richest source of intent:
+- `README.md`, `CONTRIBUTING.md`, `CHANGELOG.md`, any `docs/` directory
+- Existing `CLAUDE.md`, `.cursor/rules/`, `.cursorrules`, any AI instruction files
+- Wiki pages, API docs, OpenAPI/Swagger specs, architecture decision records (ADRs)
+- Inline code comments, JSDoc/docstrings, module-level documentation
+
+**Configuration and metadata:**
+- `package.json` / `pyproject.toml` / `Cargo.toml` / `go.mod` / `*.csproj` — stack, deps, scripts
+- `tsconfig.json` / `eslint.*` / `prettier.*` / `.editorconfig` — coding conventions
+- `Dockerfile`, `docker-compose.*`, `Procfile` — deployment and infrastructure
+- CI/CD configs (`.github/workflows/`, `.gitlab-ci.yml`, `Jenkinsfile`)
+- `.env.example`, `.env.template` — required environment variables (never read `.env` itself)
+
+**Source code structure:**
+- Directory tree — `ls` or `find` to map the full project layout
+- Entry points (`src/index.*`, `main.*`, `app.*`, `server.*`)
+- Routing files (Express routes, Next.js pages, Django urls, etc.)
+- Database schemas, migrations, seed files, ORMs/models
+- API endpoints, controllers, services, middleware
+- Frontend components, pages, layouts, design system tokens
+- State management (stores, reducers, contexts)
+- Shared utilities, constants, types/interfaces
+
+**Testing:**
+- Test directories (`tests/`, `__tests__/`, `spec/`, `*.test.*`, `*.spec.*`)
+- Test config (`jest.config.*`, `vitest.config.*`, `playwright.config.*`, `cypress.config.*`)
+- Test fixtures, mocks, factories
+
+**Git history:**
+- `git log --oneline -50` — recent activity and commit patterns
+- `git log --all --oneline --graph -20` — branch structure
+- `git shortlog -sn` — contributors
+
+**Existing memory and knowledge stores:**
+- `memory/*/best-practices.md` — accumulated patterns and gotchas from previous HOOL cycles (PRESERVE — hard-won agent learnings)
+- `memory/*/issues.md` — personal issues each agent has logged (PRESERVE)
+- `memory/*/cold.md` — full agent journals (scan for relevant context, don't overwrite)
+- `memory/*/hot.md` — recent context snapshots (will be rebuilt, but read first to understand where agents left off)
+- `memory/*/governor-feedback.md` — corrective feedback from governor (PRESERVE — active directives)
+- `docs/.agent-memory/` — if present (e.g. Astra-style memory), read for accumulated project knowledge
+- Platform-specific memory (`~/.claude/projects/*/memory/`) — check if the platform has stored project-level learnings
+- Any `MEMORY.md`, `LEARNINGS.md`, or similar knowledge-base files in the project root or docs/
+
+**Existing HOOL state (re-onboard only):**
+- `operations/` — all operations files (current-phase, task-board, bugs, issues, inconsistencies, client-preferences, governor-rules, governor-log)
+- `phases/` — all existing phase docs (compare against code for drift — UPDATE rather than replace)
+- `.hool/agents.json` — verify agent manifest matches current agent count and prompts
+- `.hool/mcps.json` — verify MCP manifest matches current registry
+
+### What to Produce (Fill Every Applicable Phase)
+
+For each phase, write the doc ONLY if you have enough evidence. Mark confidence levels. Skip phases the project type doesn't need (check project-profile.md).
+
+**Phase 01 — Brainstorm** (`phases/01-brainstorm/brainstorm.md`):
+- Extract from: README, docs, git history, commit messages, PR descriptions
+- Capture: project vision, goals, target users, key decisions made, constraints, scope boundaries
+- Tag with `[INFERRED]` — this is what the project appears to be, not what someone explicitly told you
+
+**Phase 02 — Spec** (`phases/02-spec/spec.md`, `features/`):
+- Extract from: code behavior, existing tests (test names ARE spec), API endpoints, UI screens, docs
+- Capture: user stories with acceptance criteria inferred from what the code actually does
+- Mark each story: `[FROM-CODE]`, `[FROM-TESTS]`, `[FROM-DOCS]`, `[INFERRED]`
+- WARNING: bugs may appear as features — flag anything that looks wrong
+
+**Phase 03 — Design** (`phases/03-design/design.md`, `cards/`, `flows/`):
+- Extract from: frontend components, CSS/design tokens, layout files, screenshots if available
+- Capture: screen inventory, component list, design system (colors, typography, spacing)
+- Only if the project has a frontend/UI
+
+**Phase 04 — Architecture** (`phases/04-architecture/architecture.md`, `contracts/`, `schema.md`, `flows/`):
+- Extract from: code structure, configs, dependency graph, API routes, DB schemas
+- Capture: tech stack, system diagram, module breakdown, data flows
+- `contracts/` — reverse-engineer API contracts from route handlers, controllers, API docs
+- `schema.md` — reverse-engineer from migrations, model files, ORM definitions
+- `flows/` — reverse-engineer key data flows from code paths
+
+**Phase 05 — FE LLD** (`phases/05-fe-scaffold/fe-lld.md`):
+- Extract from: frontend code patterns, component hierarchy, routing, state management
+- Capture: component tree, page structure, data fetching patterns, conventions
+- Only if the project has a frontend
+
+**Phase 06 — BE LLD** (`phases/06-be-scaffold/be-lld.md`):
+- Extract from: backend code patterns, service layer, middleware, data access
+- Capture: module layout, service patterns, middleware chain, error handling conventions
+- Only if the project has a backend
+
+**Phase 07 — Test Plan** (`phases/07-test-plan/test-plan.md`, `cases/`):
+- Extract from: existing test files, test configs, CI test commands
+- Capture: what's tested, what's not, test framework, coverage gaps
+- Map existing tests to spec user stories
+
+**Operations:**
+- `operations/bugs.md` — known bugs from issues, TODOs, FIXMEs in code
+- `operations/issues.md` — tech debt, code smells, deprecated patterns
+- `operations/inconsistencies.md` — doc-vs-code gaps, config mismatches, stale docs
+- `operations/client-preferences.md` — infer from existing configs, lint rules, conventions
+
+**Memory Seeding** (ONBOARD-010):
+Route findings to agent memory files. Do NOT blindly duplicate — identify which agents each finding is actionable for and write it from that agent's perspective.
+
+Per-agent routing:
+- **be-tech-lead/best-practices.md** — architectural patterns, module boundaries, API design conventions, error handling patterns, dependency management gotchas. Tag: `[PATTERN]` or `[GOTCHA]`
+- **be-tech-lead/issues.md** — architectural debt, missing abstractions, coupling issues
+- **fe-tech-lead/best-practices.md** — component patterns, state management conventions, styling system, routing patterns. Tag: `[PATTERN]` or `[GOTCHA]`
+- **fe-tech-lead/issues.md** — FE architectural debt, inconsistent patterns
+- **be-dev/best-practices.md** — concrete coding conventions (naming, file structure, import order), common pitfalls in this codebase. Tag: `[PATTERN]` or `[GOTCHA]`
+- **be-dev/issues.md** — code-level debt (TODOs, FIXMEs, deprecated usage, copy-paste code)
+- **fe-dev/best-practices.md** — FE coding conventions, component naming, test patterns. Tag: `[PATTERN]` or `[GOTCHA]`
+- **fe-dev/issues.md** — FE code-level debt
+- **qa/best-practices.md** — test framework conventions, coverage expectations, test data patterns. Tag: `[PATTERN]`
+- **qa/issues.md** — coverage gaps, missing test types, flaky test patterns, untested critical paths
+- **forensic/issues.md** — known fragile areas, previous incidents if visible in git history, areas with high churn
+- **governor/best-practices.md** — project-specific rules inferred from lint configs, CI checks, existing conventions. Tag: `[PATTERN]`
+
+Rules:
+- A single finding CAN go to multiple agents if actionable from each perspective — but write it differently for each role
+- Skip agents the project doesn't use (no FE agents for CLI tools, etc.)
+- Preserve existing memory entries — append, don't overwrite
+- Use the standard tags: `[PATTERN]`, `[GOTCHA]`, `[ARCH-*]` for best-practices; plain text for issues
+
+### Onboarding Gate
+
+After all tasks complete:
+1. Write summary to `operations/needs-human-review.md` listing every phase doc you produced, with confidence level
+2. List all inconsistencies and issues found
+3. Present to user: "Here's what I found. Please review before we proceed."
+4. After human review, transition `operations/current-phase.md` to **standby**
+
+---
+
 ## Phase 0: Project Init
 
 ### Writes
@@ -451,8 +587,8 @@ Spawn **Forensic** subagent with context:
 After Phase 11 completes (all bugs resolved, QA passes), the Product Lead runs a cross-agent retrospective.
 
 ### Reads
-- `memory/*/best-practices.md` — all 7 agents' accumulated patterns and gotchas
-- `memory/*/issues.md` — all 7 agents' personal issues logs
+- `memory/*/best-practices.md` — all 8 agents' accumulated patterns and gotchas
+- `memory/*/issues.md` — all 8 agents' personal issues logs
 - `operations/inconsistencies.md` — what mismatches surfaced during the cycle
 - `operations/bugs.md` — what bugs were found and their root causes
 - `operations/task-board.md` — planned vs actual tasks, blocked/re-assigned tasks
@@ -573,6 +709,31 @@ User reports bug -> operations/bugs.md (tagged [USER])
   -> Route to Forensic
 ```
 
+### Governor Audits
+The Governor is a behavioral auditor — it does NOT build, test, or review code. It audits whether agents followed the rules.
+
+**When to trigger:**
+- After every 3 agent dispatches (automatic cadence)
+- After any task that touches `operations/governor-rules.md` or agent prompts
+- When an agent's output looks suspicious (unexpected file edits, missing dispatch briefs)
+- Manually: user says "run governor" or similar
+
+**How to dispatch:**
+1. Read `.hool/prompts/agents/governor.md`
+2. Read `memory/governor/hot.md`, `memory/governor/best-practices.md`
+3. Dispatch Governor subagent with context:
+   - `operations/governor-rules.md` — the rules to audit against
+   - `operations/governor-log.md` — previous audit trail
+   - `memory/*/cold.md` (last 20 entries each) — what agents actually did
+   - Any dispatch briefs from `operations/context/` for audited tasks
+4. Governor writes:
+   - `memory/<agent>/governor-feedback.md` — corrective feedback for violating agents
+   - `operations/governor-log.md` — audit trail entry
+   - `operations/governor-rules.md` — new rules (append only, never modify/remove)
+   - `operations/needs-human-review.md` — structural issues (missing rules, prompt gaps)
+
+**After governor returns:** Read `operations/governor-log.md` for the latest audit. If any agent received feedback in their `governor-feedback.md`, factor it into the next dispatch to that agent.
+
 ### Escalation
 - Subjective or ambiguous items -> `operations/needs-human-review.md`
 - Never guess on product decisions — escalate