@wazir-dev/cli 1.1.0 → 1.3.0

package/expertise/antipatterns/process/ai-coding-antipatterns.md

@@ -3,7 +3,7 @@
 > AI coding agents produce code that compiles, passes superficial review, and reads authoritatively -- yet harbors systematic defects that human-written code rarely exhibits. These anti-patterns arise from the fundamental mechanics of next-token prediction operating without ground truth, persistent memory, or genuine understanding. A 2026 CodeRabbit analysis of 470 open-source repositories found AI-generated code contains 1.7x more bugs than human code, with 75% more logic errors and 57% more security findings per pull request. A USENIX Security 2025 study of 576,000 code samples found 20% of AI-recommended packages do not exist. This module catalogs the 20 most damaging patterns, grounded in documented incidents and empirical research.
 
 > **Domain:** Process -- AI-Assisted Development
-> **Anti-patterns covered:** 20
+> **Anti-patterns covered:** 22
 > **Highest severity:** Critical
 > **Primary audience:** AI agents performing self-evaluation; human reviewers auditing AI output
 
@@ -823,6 +823,215 @@ An AI coding agent should ask itself these questions before submitting generated
 
 15. **Continuity check:** After a session break, have I reviewed existing code for conventions before generating new code?
 
+### AP-21: Pipeline Phase Skipping
+
+**Also known as:** Rationalized Bypass, "The Spec Is Clear Enough", Shortcut Execution
+**Frequency:** Common
+**Severity:** Critical
+**Detection difficulty:** Low
+
+**What it looks like:**
+
+The agent receives a detailed briefing or spec and jumps directly to implementation, skipping the pipeline's clarification, specification, design, and planning phases. Typical rationalization: "The input is already detailed enough — I don't need to clarify further."
+
+```
+User: /wazir Build a caching layer for the API
+Agent: [reads detailed input] This is clear. Let me start implementing...
+       [spawns parallel agents for implementation]
+       [skips clarify → specify → design → plan entirely]
+```
+
+**Why AI agents do it:**
+
+When the input appears complete, the agent's next-token prediction favors the most "productive" action: writing code. The pipeline phases (clarify, specify, design, plan) feel redundant when the input already describes what to build. The agent lacks the meta-awareness that the pipeline exists precisely to catch what the input does NOT say — unstated assumptions, missing edge cases, architectural trade-offs, and scope boundaries. Skipping phases is the single most damaging process failure because it invalidates every downstream quality gate.
+
+**Detection signals:**
+
+- Implementation starts without `clarification.md`, `spec-hardened.md`, `design.md`, or `execution-plan.md` artifacts in the run directory
+- Agent jumps from input scanning to code writing without user checkpoints
+- Rationalization language in conversation: "this is already clear", "the spec is detailed enough", "we can skip clarification"
+- `wazir capture event --phase executor` returns exit 44 (phase prerequisite gate failed)
+- No `phase_exit` events for clarifier phase in `events.ndjson`
+
+**Root cause:**
+
+No enforcement mechanism between pipeline phases. The agent can read the pipeline skill and choose to interpret it loosely. Without hard gates (file-existence checks, CLI validation), the pipeline is advisory, not mandatory.
+
+**Remediation:**
+
+1. **Skill-level hard gates** — each phase skill contains a prerequisite check section that lists required artifacts and instructs the agent to STOP if any are missing
+2. **CLI-level validation** — `wazir capture event --phase executor` validates that prior phases completed before allowing `phase_enter`
+3. **Anti-rationalization instruction** — skill text explicitly names and blocks the rationalization pattern: "Do NOT skip phases because the input looks clear enough"
+
+**Related:** Wazir pipeline enforcement (item #18), `skills/executor/SKILL.md` Phase Prerequisites section, `tooling/src/guards/phase-prerequisite-guard.js`
+
+---
+
+### AP-22: Autonomous Scope Reduction
+
+**Also known as:** Silent Tiering, Unilateral Deferral, Scope Halving
+**Frequency:** Common (observed in real pipeline runs)
+**Severity:** Critical
+**Detection difficulty:** Moderate
+
+**What it looks like:**
+
+The AI agent autonomously reduces the user's requested scope by tiering, deferring, or deprioritizing items without explicit user approval. The user asks for 10 items; the agent delivers 5 and calls the rest "future work."
+
+**Why AI agents do it:**
+
+Agent optimizes for completion over coverage. Large input overwhelms the context, and the agent triages by perceived difficulty. The agent confuses "prioritization suggestion" with "scope decision." No hard gate prevents the reduction.
+
+**What goes wrong:**
+
+User loses trust — they asked for X, got X/2. Repeated runs required to cover what should have been one run. Agent appears to make product decisions above its authority.
+
+**Detection signals:**
+
+- Input has N items, execution plan has fewer than N tasks
+- Words like "deferred", "future tier", "out of scope for this run" appear without user approval
+- Post-run review reveals missing deliverables
+
+**The fix:**
+
+1. **Hard gate:** `items_in_plan >= items_in_input` enforced by scope coverage guard
+2. **Clarifier check:** Count input items vs plan items before presenting plan
+3. **Explicit approval required:** Agent can SUGGEST prioritization but CANNOT decide it
+4. **Anti-rationalization language:** "The input looks detailed enough to skip some items" is NOT valid reasoning
+
+**Example:**
+
+Bad:
+```
+Input: "Implement items 1-10"
+Plan: "Tier 1 (this run): items 1-5. Tier 2 (future): items 6-10."
+```
+
+Good:
+```
+Input: "Implement items 1-10"
+Plan: "10 tasks covering all 10 items. Suggested order: [...]"
+```
+
+**Related:** CrewAI Task Guardrails (mandatory task completion enforcement), AP-21 (Pipeline Phase Skipping — related pattern of skipping required steps), `tooling/src/guards/phase-prerequisite-guard.js` (`evaluateScopeCoverageGuard`)
+
+---
+
+### AP-23: Stale Documentation Counts
+
+**Also known as:** Count Drift, Number Rot, Metric Desync
+**Frequency:** Very Common
+**Severity:** Medium
+**Detection difficulty:** Low (mechanical)
+
+**What it looks like:**
+
+Documentation claims "268 expertise modules" when the actual count is 315. README says "7 hooks" when 8 exist. Counts in multiple files diverge from each other and from reality. The numbers were correct when written but drifted as the project grew.
+
+**Why AI agents do it:**
+
+Agents update the source of truth (add a new hook, write new expertise modules) but do not grep for every downstream reference. Each file is edited in isolation. No automated check enforces that prose counts match filesystem reality.
+
+**What goes wrong:**
+
+Users see contradictory numbers across docs and lose trust. Reviewers waste time verifying which number is correct. Launch materials ship with wrong counts, creating a first impression of sloppiness.
+
+**Detection signals:**
+
+- `find expertise -name '*.md' | wc -l` disagrees with counts in README, architecture docs, and readmes
+- `ls hooks/definitions/ | wc -l` disagrees with hook count claims
+- Different files claim different counts for the same metric
+
+**The fix:**
+
+1. **Self-audit loop** — run `wazir validate docs` which cross-references prose claims against filesystem counts
+2. **Single source of truth** — reference manifest counts programmatically where possible; avoid hardcoding counts in prose
+3. **Grep sweep on every addition** — when adding a new module, hook, or skill, grep for the old count and update all references
+4. **CI enforcement** — `wazir validate docs` in CI catches drift before merge
+
+**Example:**
+
+Bad:
+```
+README.md: "268 expertise modules"
+architecture.md: "268 curated knowledge modules"
+expertise/README.md: "268 knowledge modules"
+Actual count: 315
+```
+
+Good:
+```
+README.md: "315 expertise modules"
+architecture.md: "315 curated knowledge modules"
+expertise/README.md: "315 knowledge modules"
+Actual count: 315
+All references match.
+```
+
+**Related:** AP-06 (Partial Updates — same root cause applied to code), `wazir validate docs`, self-audit skill
+
+---
+
+### AP-24: Silent Checkpoint Bypass
+
+**Also known as:** Gate Ghosting, Approval Amnesia, Review Skipping
+**Frequency:** Common
+**Severity:** Critical
+**Detection difficulty:** Moderate
+
+**What it looks like:**
+
+The agent reaches an approval gate (spec-challenge, plan-review, or final review) and proceeds without obtaining explicit reviewer approval. The gate exists in the workflow definition but the agent treats it as advisory, not blocking. Review artifacts are either missing or contain self-generated approvals.
+
+**Why AI agents do it:**
+
+The agent conflates "review" with "self-review." Without a hard external gate (different model, different session, or user confirmation), the agent reviews its own work and approves it. Optimism bias means self-review almost never rejects. The agent also optimizes for speed, and gates are the slowest part of the pipeline.
+
+**What goes wrong:**
+
+Spec errors propagate to implementation. Design flaws survive to production. The entire adversarial review structure becomes theater — gates exist on paper but provide no actual quality assurance. Bugs caught in final review could have been caught in spec-challenge at 10x lower cost.
+
+**Detection signals:**
+
+- Review pass files authored by the same agent that authored the reviewed artifact
+- Approval granted on the first pass with zero findings
+- Missing review artifacts in the run state directory
+- `wazir capture loop-check` shows 0 review iterations for a gate phase
+
+**The fix:**
+
+1. **External reviewer enforcement** — gate phases must invoke a different model or require user confirmation via `AskUserQuestion`
+2. **Minimum findings threshold** — first-pass reviews that report zero findings trigger a warning; real adversarial review almost always finds something
+3. **Artifact validation** — `wazir validate runtime` checks that review artifacts exist and were not authored by the same role as the reviewed artifact
+4. **Loop cap guard** — `hooks/loop-cap-guard` tracks review iterations; zero iterations at a gate phase is a validation failure
+
+**Example:**
+
+Bad:
+```
+# spec-challenge pass 1
+Reviewer: executor (same agent)
+Findings: 0
+Decision: APPROVED
+```
+
+Good:
+```
+# spec-challenge pass 1
+Reviewer: codex-cli (external model)
+Findings: 3 (ambiguous acceptance criteria, missing edge case, unclear priority)
+Decision: REVISE
+
+# spec-challenge pass 2
+Reviewer: codex-cli (external model)
+Findings: 0 (all 3 resolved)
+Decision: APPROVED
+```
+
+**Related:** AP-21 (Pipeline Phase Skipping — bypassing the gate entirely vs. rubber-stamping it), AP-08 (Test Theater — similar pattern of going through motions without rigor), `docs/reference/review-loop-pattern.md`, `hooks/loop-cap-guard`
+
+---
+
 ## Code Smell Quick Reference
 
 | Anti-Pattern | Severity | Frequency | Key Signal | First Action |
@@ -847,6 +1056,10 @@ An AI coding agent should ask itself these questions before submitting generated
 | AP-18 Fake Progress | High | Common | Hardcoded return values | Ban pass/TODO in production |
 | AP-19 Over-Mocking | High | Common | More mocks than assertions | Require integration tests |
 | AP-20 Resumption Errors | High | Common | Mixed ID types across files | Architecture file in every session |
+| AP-21 Pipeline Phase Skipping | Critical | Common | Missing clarified/* artifacts | Enforce hard gates in skills + CLI |
+| AP-22 Autonomous Scope Reduction | Critical | Common | Plan has fewer tasks than input items | Scope coverage guard + user approval |
+| AP-23 Stale Documentation Counts | Medium | Very Common | Doc counts disagree with filesystem | Grep sweep + `wazir validate docs` |
+| AP-24 Silent Checkpoint Bypass | Critical | Common | Self-approved gate with 0 findings | External reviewer + minimum findings |
 
 ---
 

package/exports/hosts/claude/.claude/commands/plan-review.md

@@ -39,7 +39,9 @@ On completing this phase, run:
 
 ## Loop Structure
 
-Follows the review loop pattern in `docs/reference/review-loop-pattern.md` with plan dimensions. The planner role resolves findings. Pass count determined by depth. No extension.
+Follows the review loop pattern in `docs/reference/review-loop-pattern.md` with 8 plan dimensions (including Input Coverage). The planner role resolves findings. Pass count determined by depth. No extension.
+
+**Input Coverage dimension:** The reviewer reads the original input/briefing, counts distinct items, and compares against tasks in the plan. If `tasks_in_plan < items_in_input`, this is a HIGH finding listing the missing items. This prevents silent scope reduction where 21 input items become 5 tasks.
 
 ## Failure Conditions
 

package/exports/hosts/claude/.claude/commands/verify.md

@@ -14,6 +14,16 @@ On entering this phase, run:
 - changed files
 - claimed outcomes
 - acceptance criteria
+- project type (detected via `detectRunnableType(projectRoot)` → web | api | cli | library, from `tooling/src/verify/proof-collector.js`)
+
+## Process
+
+1. **Detect project type:** Run `detectRunnableType(projectRoot)` to determine verification strategy
+2. **Collect evidence:** Run `collectProof(taskSpec, runConfig)` with the detected type
+3. **For runnable output (web/api/cli):** Run the application and capture runtime evidence (build output, screenshots, curl responses, CLI output)
+4. **For non-runnable output (library/config/skills):** Run lint, format check, type check, and tests — all must pass
+5. **Save evidence:** Write to `.wazir/runs/<id>/artifacts/proof-<task>.json`
+6. **Validate:** Ensure every acceptance criterion has at least one evidence item mapped to it
 
 ## Primary Role
 
@@ -21,7 +31,11 @@ On entering this phase, run:
 
 ## Outputs
 
-- verification proof artifact
+- verification proof artifact (produced by `collectProof` from `tooling/src/verify/proof-collector.js`)
+
+## Proof Collection
+
+Use `detectRunnableType` to classify the project, then `collectProof` to gather evidence. The proof-collector runs type-appropriate commands (build, test, lint, type-check) using `execFileSync` and returns structured `{ type, evidence }`.
 
 ## Approval Gate
 
@@ -32,6 +46,19 @@ On entering this phase, run:
 On completing this phase, run:
 `wazir capture event --run <run-id> --event phase_exit --phase <phase-name> --status completed`
 
+## Proof of Implementation
+
+The verifier detects whether the project output is runnable and collects appropriate evidence:
+
+| Project Type | Detection | Evidence Collected |
+|-------------|-----------|-------------------|
+| `web` | next/vite/react-scripts in deps | Build output, Playwright screenshot (if available), curl response |
+| `api` | express/fastify/hono in deps | curl endpoint responses with status codes |
+| `cli` | `bin` field in package.json | `--help` output, test run with sample args |
+| `library` | default (no runnable markers) | npm test, tsc, eslint, prettier — all must pass |
+
+Evidence is saved to `.wazir/runs/<id>/artifacts/proof-<task>.json` using `collectProof()` from `tooling/src/verify/proof-collector.js`.
+
 ## Relationship to Review Loops
 
 Verification is invoked per-task during execution, not as a review loop. It produces deterministic proof, not adversarial findings.
@@ -39,3 +66,5 @@ Verification is invoked per-task during execution, not as a review loop. It prod
 ## Failure Conditions
 
 - stale or partial verification
+- proof-collector reports `status: "fail"` for any evidence item
+- runnable type detected but no evidence collected

package/exports/hosts/claude/.claude/settings.json

@@ -9,6 +9,15 @@
             "command": "./hooks/protected-path-write-guard"
           }
         ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "./hooks/context-mode-router"
+          }
+        ]
       }
     ],
     "SessionStart": [

package/exports/hosts/claude/CLAUDE.md

@@ -6,7 +6,7 @@ This host package is generated from the canonical Wazir sources.
 
 - project: Wazir
 - hosts: claude, codex, gemini, cursor
-- phases: clarify, discover, specify, spec_challenge, author, design, design_review, plan, plan_review, execute, verify, review, learn, prepare_next
+- phases: init, clarifier, executor, final_review
 - roles: clarifier, researcher, specifier, content-author, designer, planner, executor, verifier, reviewer, learner
 - protected paths: input, roles, workflows, schemas, exports/hosts
 - state root default: ~/.wazir/projects/{project_slug}

package/exports/hosts/claude/export.manifest.json

@@ -1,7 +1,7 @@
 {
   "host": "claude",
   "source_hashes": {
-    "wazir.manifest.yaml": "ae49e943639828932d5289f34f2994f1efb67df4f552f5bfabbb1c823b662e43",
+    "wazir.manifest.yaml": "f00776eb08ed3332b8f855001a2fd0b866cd0b81d009c6fbb316149c398c51ca",
     "roles/clarifier.md": "1e1b8a2c05f1070fdcef485963cfcbffff62c4b2703a8d73fe51ac52d056e573",
     "roles/content-author.md": "cc20b80bd70ab68b3239a9cf56bf1ffc2c06843d38afc6b190844b35a1d73c3e",
     "roles/designer.md": "76cff5bda82975cfb4074de71681e7c8ba284e2e49d0cc98f90208642fef74fc",
@@ -19,20 +19,22 @@
     "workflows/discover.md": "0696add486f739a46ed4c2b71b67bdda3ab9fea2d1395e662191282529ed21d2",
     "workflows/execute.md": "33428704476877b2c8cf34c6eda3a56d1fd71e8bbea0f05c122bb3da2c6475a6",
     "workflows/learn.md": "9b1955a00eb0ea47af08a3639c3cbc2f15b8eab6cc02127e829bc8c83b0a52b5",
-    "workflows/plan-review.md": "8696c472cb4605a171fd4ac8a9c51b7cf337807c4881ed163515dc56e61fd818",
+    "workflows/plan-review.md": "1dfe76dfe4fd9c32409d508e47654ad3b985b5429bd4616adde719b19fd606ac",
     "workflows/plan.md": "fd52737159ab13688af8cbcb1c3fa224b1a9dda441b9ab337ab98cbfb5c68fa5",
     "workflows/prepare-next.md": "8769b692be6d9fddf3b3f36fee6888159fb9fb2a5c31360cdbc9402e0f43fc27",
     "workflows/review.md": "aaeaf7ab4515e325084a77e75e18b325295f8d16799f71f8b7cd0ec67c52c0d6",
     "workflows/run-audit.md": "e582f767967dc3fb6aaeb938ad1672e7bed18bf044055ce8c45c2114251b787a",
     "workflows/spec-challenge.md": "dc99137c28c49a6f8312924709afb6077754d128e90466dc911150ce15737897",
     "workflows/specify.md": "53b84e74871f6dbd93cae22a881cc5907e398b29501d0a1fa08c7ed69df705cb",
-    "workflows/verify.md": "45f9c189520dfe9d24c0bc340a15e6a80c988fca1b84dc187627032a6dbaee16",
+    "workflows/verify.md": "4eff7b9b1c94b9a2c4a6f65cae076a3cd5a278a86430109b6033cd958e1e8ab8",
+    "hooks/definitions/context_mode_router.yaml": "a10dc927418bc130b447eb33faf0f45669ecd9c7917f56947ddd74850a4e0e37",
     "hooks/definitions/loop_cap_guard.yaml": "f0fd220e028ab6fad3d8fd650602884fe500ca4899eff6e428cf217af058618d",
     "hooks/definitions/post_tool_capture.yaml": "a773cd6e18972dee8eef3b7cb06fd1d319a71de4588897cebfbe643f6781a3b2",
     "hooks/definitions/pre_compact_summary.yaml": "daa0175d79f3e0127c5ce86a7a2f8df0be3f58b5c94fe749da715a17c7b2d04e",
     "hooks/definitions/pre_tool_capture_route.yaml": "3c2663380ff3cd09f09de5b96bcf6123266fa74d8a03dfb2d6fbe40a43fb13cf",
     "hooks/definitions/protected_path_write_guard.yaml": "6683d41778b823e2a4e606065597569aa04363f091e135e165de9732f1fc2171",
     "hooks/definitions/session_start.yaml": "9383fcf1f8304c87e57726478a461706c0fc73dc62bcc4d8661f2eeffa43a82d",
-    "hooks/definitions/stop_handoff_harvest.yaml": "67a3c0a8bb7cb66b88e77dc79e748082e964d278c47935662c453922a846482b"
+    "hooks/definitions/stop_handoff_harvest.yaml": "67a3c0a8bb7cb66b88e77dc79e748082e964d278c47935662c453922a846482b",
+    "hooks/hooks.json": "f255345793951b5cf6f6d8c9a8b6a6ad2d3140023453410127a6f70d8e110c26"
   }
 }

package/exports/hosts/claude/host-package.json

@@ -27,13 +27,15 @@
     "workflows/spec-challenge.md",
     "workflows/specify.md",
     "workflows/verify.md",
+    "hooks/definitions/context_mode_router.yaml",
     "hooks/definitions/loop_cap_guard.yaml",
     "hooks/definitions/post_tool_capture.yaml",
     "hooks/definitions/pre_compact_summary.yaml",
     "hooks/definitions/pre_tool_capture_route.yaml",
     "hooks/definitions/protected_path_write_guard.yaml",
     "hooks/definitions/session_start.yaml",
-    "hooks/definitions/stop_handoff_harvest.yaml"
+    "hooks/definitions/stop_handoff_harvest.yaml",
+    "hooks/hooks.json"
   ],
   "files": [
     ".claude/agents/clarifier.md",

package/exports/hosts/codex/AGENTS.md

@@ -6,7 +6,7 @@ This host package is generated from the canonical Wazir sources.
 
 - project: Wazir
 - hosts: claude, codex, gemini, cursor
-- phases: clarify, discover, specify, spec_challenge, author, design, design_review, plan, plan_review, execute, verify, review, learn, prepare_next
+- phases: init, clarifier, executor, final_review
 - roles: clarifier, researcher, specifier, content-author, designer, planner, executor, verifier, reviewer, learner
 - protected paths: input, roles, workflows, schemas, exports/hosts
 - state root default: ~/.wazir/projects/{project_slug}

package/exports/hosts/codex/export.manifest.json

@@ -1,7 +1,7 @@
 {
   "host": "codex",
   "source_hashes": {
-    "wazir.manifest.yaml": "ae49e943639828932d5289f34f2994f1efb67df4f552f5bfabbb1c823b662e43",
+    "wazir.manifest.yaml": "f00776eb08ed3332b8f855001a2fd0b866cd0b81d009c6fbb316149c398c51ca",
     "roles/clarifier.md": "1e1b8a2c05f1070fdcef485963cfcbffff62c4b2703a8d73fe51ac52d056e573",
     "roles/content-author.md": "cc20b80bd70ab68b3239a9cf56bf1ffc2c06843d38afc6b190844b35a1d73c3e",
     "roles/designer.md": "76cff5bda82975cfb4074de71681e7c8ba284e2e49d0cc98f90208642fef74fc",
@@ -19,20 +19,22 @@
     "workflows/discover.md": "0696add486f739a46ed4c2b71b67bdda3ab9fea2d1395e662191282529ed21d2",
     "workflows/execute.md": "33428704476877b2c8cf34c6eda3a56d1fd71e8bbea0f05c122bb3da2c6475a6",
     "workflows/learn.md": "9b1955a00eb0ea47af08a3639c3cbc2f15b8eab6cc02127e829bc8c83b0a52b5",
-    "workflows/plan-review.md": "8696c472cb4605a171fd4ac8a9c51b7cf337807c4881ed163515dc56e61fd818",
+    "workflows/plan-review.md": "1dfe76dfe4fd9c32409d508e47654ad3b985b5429bd4616adde719b19fd606ac",
     "workflows/plan.md": "fd52737159ab13688af8cbcb1c3fa224b1a9dda441b9ab337ab98cbfb5c68fa5",
     "workflows/prepare-next.md": "8769b692be6d9fddf3b3f36fee6888159fb9fb2a5c31360cdbc9402e0f43fc27",
     "workflows/review.md": "aaeaf7ab4515e325084a77e75e18b325295f8d16799f71f8b7cd0ec67c52c0d6",
     "workflows/run-audit.md": "e582f767967dc3fb6aaeb938ad1672e7bed18bf044055ce8c45c2114251b787a",
     "workflows/spec-challenge.md": "dc99137c28c49a6f8312924709afb6077754d128e90466dc911150ce15737897",
     "workflows/specify.md": "53b84e74871f6dbd93cae22a881cc5907e398b29501d0a1fa08c7ed69df705cb",
-    "workflows/verify.md": "45f9c189520dfe9d24c0bc340a15e6a80c988fca1b84dc187627032a6dbaee16",
+    "workflows/verify.md": "4eff7b9b1c94b9a2c4a6f65cae076a3cd5a278a86430109b6033cd958e1e8ab8",
+    "hooks/definitions/context_mode_router.yaml": "a10dc927418bc130b447eb33faf0f45669ecd9c7917f56947ddd74850a4e0e37",
     "hooks/definitions/loop_cap_guard.yaml": "f0fd220e028ab6fad3d8fd650602884fe500ca4899eff6e428cf217af058618d",
     "hooks/definitions/post_tool_capture.yaml": "a773cd6e18972dee8eef3b7cb06fd1d319a71de4588897cebfbe643f6781a3b2",
     "hooks/definitions/pre_compact_summary.yaml": "daa0175d79f3e0127c5ce86a7a2f8df0be3f58b5c94fe749da715a17c7b2d04e",
     "hooks/definitions/pre_tool_capture_route.yaml": "3c2663380ff3cd09f09de5b96bcf6123266fa74d8a03dfb2d6fbe40a43fb13cf",
     "hooks/definitions/protected_path_write_guard.yaml": "6683d41778b823e2a4e606065597569aa04363f091e135e165de9732f1fc2171",
     "hooks/definitions/session_start.yaml": "9383fcf1f8304c87e57726478a461706c0fc73dc62bcc4d8661f2eeffa43a82d",
-    "hooks/definitions/stop_handoff_harvest.yaml": "67a3c0a8bb7cb66b88e77dc79e748082e964d278c47935662c453922a846482b"
+    "hooks/definitions/stop_handoff_harvest.yaml": "67a3c0a8bb7cb66b88e77dc79e748082e964d278c47935662c453922a846482b",
+    "hooks/hooks.json": "f255345793951b5cf6f6d8c9a8b6a6ad2d3140023453410127a6f70d8e110c26"
   }
 }

package/exports/hosts/codex/host-package.json

@@ -27,13 +27,15 @@
     "workflows/spec-challenge.md",
     "workflows/specify.md",
     "workflows/verify.md",
+    "hooks/definitions/context_mode_router.yaml",
     "hooks/definitions/loop_cap_guard.yaml",
     "hooks/definitions/post_tool_capture.yaml",
     "hooks/definitions/pre_compact_summary.yaml",
     "hooks/definitions/pre_tool_capture_route.yaml",
     "hooks/definitions/protected_path_write_guard.yaml",
     "hooks/definitions/session_start.yaml",
-    "hooks/definitions/stop_handoff_harvest.yaml"
+    "hooks/definitions/stop_handoff_harvest.yaml",
+    "hooks/hooks.json"
   ],
   "files": [
     "AGENTS.md"

package/exports/hosts/cursor/.cursor/hooks.json

@@ -8,6 +8,10 @@
       "name": "loop-cap-guard",
       "command": "./hooks/loop-cap-guard"
     },
+    {
+      "name": "context-mode-router",
+      "command": "./hooks/context-mode-router"
+    },
     {
       "name": "session-start",
       "command": "./hooks/session-start"

package/exports/hosts/cursor/.cursor/rules/wazir-core.mdc

@@ -6,7 +6,7 @@ This host package is generated from the canonical Wazir sources.
 
 - project: Wazir
 - hosts: claude, codex, gemini, cursor
-- phases: clarify, discover, specify, spec_challenge, author, design, design_review, plan, plan_review, execute, verify, review, learn, prepare_next
+- phases: init, clarifier, executor, final_review
 - roles: clarifier, researcher, specifier, content-author, designer, planner, executor, verifier, reviewer, learner
 - protected paths: input, roles, workflows, schemas, exports/hosts
 - state root default: ~/.wazir/projects/{project_slug}

package/exports/hosts/cursor/export.manifest.json

@@ -1,7 +1,7 @@
 {
   "host": "cursor",
   "source_hashes": {
-    "wazir.manifest.yaml": "ae49e943639828932d5289f34f2994f1efb67df4f552f5bfabbb1c823b662e43",
+    "wazir.manifest.yaml": "f00776eb08ed3332b8f855001a2fd0b866cd0b81d009c6fbb316149c398c51ca",
     "roles/clarifier.md": "1e1b8a2c05f1070fdcef485963cfcbffff62c4b2703a8d73fe51ac52d056e573",
     "roles/content-author.md": "cc20b80bd70ab68b3239a9cf56bf1ffc2c06843d38afc6b190844b35a1d73c3e",
     "roles/designer.md": "76cff5bda82975cfb4074de71681e7c8ba284e2e49d0cc98f90208642fef74fc",
@@ -19,20 +19,22 @@
     "workflows/discover.md": "0696add486f739a46ed4c2b71b67bdda3ab9fea2d1395e662191282529ed21d2",
     "workflows/execute.md": "33428704476877b2c8cf34c6eda3a56d1fd71e8bbea0f05c122bb3da2c6475a6",
     "workflows/learn.md": "9b1955a00eb0ea47af08a3639c3cbc2f15b8eab6cc02127e829bc8c83b0a52b5",
-    "workflows/plan-review.md": "8696c472cb4605a171fd4ac8a9c51b7cf337807c4881ed163515dc56e61fd818",
+    "workflows/plan-review.md": "1dfe76dfe4fd9c32409d508e47654ad3b985b5429bd4616adde719b19fd606ac",
     "workflows/plan.md": "fd52737159ab13688af8cbcb1c3fa224b1a9dda441b9ab337ab98cbfb5c68fa5",
     "workflows/prepare-next.md": "8769b692be6d9fddf3b3f36fee6888159fb9fb2a5c31360cdbc9402e0f43fc27",
     "workflows/review.md": "aaeaf7ab4515e325084a77e75e18b325295f8d16799f71f8b7cd0ec67c52c0d6",
     "workflows/run-audit.md": "e582f767967dc3fb6aaeb938ad1672e7bed18bf044055ce8c45c2114251b787a",
     "workflows/spec-challenge.md": "dc99137c28c49a6f8312924709afb6077754d128e90466dc911150ce15737897",
     "workflows/specify.md": "53b84e74871f6dbd93cae22a881cc5907e398b29501d0a1fa08c7ed69df705cb",
-    "workflows/verify.md": "45f9c189520dfe9d24c0bc340a15e6a80c988fca1b84dc187627032a6dbaee16",
+    "workflows/verify.md": "4eff7b9b1c94b9a2c4a6f65cae076a3cd5a278a86430109b6033cd958e1e8ab8",
+    "hooks/definitions/context_mode_router.yaml": "a10dc927418bc130b447eb33faf0f45669ecd9c7917f56947ddd74850a4e0e37",
     "hooks/definitions/loop_cap_guard.yaml": "f0fd220e028ab6fad3d8fd650602884fe500ca4899eff6e428cf217af058618d",
     "hooks/definitions/post_tool_capture.yaml": "a773cd6e18972dee8eef3b7cb06fd1d319a71de4588897cebfbe643f6781a3b2",
     "hooks/definitions/pre_compact_summary.yaml": "daa0175d79f3e0127c5ce86a7a2f8df0be3f58b5c94fe749da715a17c7b2d04e",
     "hooks/definitions/pre_tool_capture_route.yaml": "3c2663380ff3cd09f09de5b96bcf6123266fa74d8a03dfb2d6fbe40a43fb13cf",
     "hooks/definitions/protected_path_write_guard.yaml": "6683d41778b823e2a4e606065597569aa04363f091e135e165de9732f1fc2171",
     "hooks/definitions/session_start.yaml": "9383fcf1f8304c87e57726478a461706c0fc73dc62bcc4d8661f2eeffa43a82d",
-    "hooks/definitions/stop_handoff_harvest.yaml": "67a3c0a8bb7cb66b88e77dc79e748082e964d278c47935662c453922a846482b"
+    "hooks/definitions/stop_handoff_harvest.yaml": "67a3c0a8bb7cb66b88e77dc79e748082e964d278c47935662c453922a846482b",
+    "hooks/hooks.json": "f255345793951b5cf6f6d8c9a8b6a6ad2d3140023453410127a6f70d8e110c26"
   }
 }

package/exports/hosts/cursor/host-package.json

@@ -27,13 +27,15 @@
     "workflows/spec-challenge.md",
     "workflows/specify.md",
     "workflows/verify.md",
+    "hooks/definitions/context_mode_router.yaml",
     "hooks/definitions/loop_cap_guard.yaml",
     "hooks/definitions/post_tool_capture.yaml",
     "hooks/definitions/pre_compact_summary.yaml",
     "hooks/definitions/pre_tool_capture_route.yaml",
     "hooks/definitions/protected_path_write_guard.yaml",
     "hooks/definitions/session_start.yaml",
-    "hooks/definitions/stop_handoff_harvest.yaml"
+    "hooks/definitions/stop_handoff_harvest.yaml",
+    "hooks/hooks.json"
   ],
   "files": [
     ".cursor/hooks.json",

package/exports/hosts/gemini/GEMINI.md

@@ -6,7 +6,7 @@ This host package is generated from the canonical Wazir sources.
 
 - project: Wazir
 - hosts: claude, codex, gemini, cursor
-- phases: clarify, discover, specify, spec_challenge, author, design, design_review, plan, plan_review, execute, verify, review, learn, prepare_next
+- phases: init, clarifier, executor, final_review
 - roles: clarifier, researcher, specifier, content-author, designer, planner, executor, verifier, reviewer, learner
 - protected paths: input, roles, workflows, schemas, exports/hosts
 - state root default: ~/.wazir/projects/{project_slug}

package/exports/hosts/gemini/export.manifest.json

@@ -1,7 +1,7 @@
 {
   "host": "gemini",
   "source_hashes": {
-    "wazir.manifest.yaml": "ae49e943639828932d5289f34f2994f1efb67df4f552f5bfabbb1c823b662e43",
+    "wazir.manifest.yaml": "f00776eb08ed3332b8f855001a2fd0b866cd0b81d009c6fbb316149c398c51ca",
     "roles/clarifier.md": "1e1b8a2c05f1070fdcef485963cfcbffff62c4b2703a8d73fe51ac52d056e573",
     "roles/content-author.md": "cc20b80bd70ab68b3239a9cf56bf1ffc2c06843d38afc6b190844b35a1d73c3e",
     "roles/designer.md": "76cff5bda82975cfb4074de71681e7c8ba284e2e49d0cc98f90208642fef74fc",
@@ -19,20 +19,22 @@
     "workflows/discover.md": "0696add486f739a46ed4c2b71b67bdda3ab9fea2d1395e662191282529ed21d2",
     "workflows/execute.md": "33428704476877b2c8cf34c6eda3a56d1fd71e8bbea0f05c122bb3da2c6475a6",
     "workflows/learn.md": "9b1955a00eb0ea47af08a3639c3cbc2f15b8eab6cc02127e829bc8c83b0a52b5",
-    "workflows/plan-review.md": "8696c472cb4605a171fd4ac8a9c51b7cf337807c4881ed163515dc56e61fd818",
+    "workflows/plan-review.md": "1dfe76dfe4fd9c32409d508e47654ad3b985b5429bd4616adde719b19fd606ac",
     "workflows/plan.md": "fd52737159ab13688af8cbcb1c3fa224b1a9dda441b9ab337ab98cbfb5c68fa5",
     "workflows/prepare-next.md": "8769b692be6d9fddf3b3f36fee6888159fb9fb2a5c31360cdbc9402e0f43fc27",
     "workflows/review.md": "aaeaf7ab4515e325084a77e75e18b325295f8d16799f71f8b7cd0ec67c52c0d6",
     "workflows/run-audit.md": "e582f767967dc3fb6aaeb938ad1672e7bed18bf044055ce8c45c2114251b787a",
     "workflows/spec-challenge.md": "dc99137c28c49a6f8312924709afb6077754d128e90466dc911150ce15737897",
     "workflows/specify.md": "53b84e74871f6dbd93cae22a881cc5907e398b29501d0a1fa08c7ed69df705cb",
-    "workflows/verify.md": "45f9c189520dfe9d24c0bc340a15e6a80c988fca1b84dc187627032a6dbaee16",
+    "workflows/verify.md": "4eff7b9b1c94b9a2c4a6f65cae076a3cd5a278a86430109b6033cd958e1e8ab8",
+    "hooks/definitions/context_mode_router.yaml": "a10dc927418bc130b447eb33faf0f45669ecd9c7917f56947ddd74850a4e0e37",
     "hooks/definitions/loop_cap_guard.yaml": "f0fd220e028ab6fad3d8fd650602884fe500ca4899eff6e428cf217af058618d",
     "hooks/definitions/post_tool_capture.yaml": "a773cd6e18972dee8eef3b7cb06fd1d319a71de4588897cebfbe643f6781a3b2",
     "hooks/definitions/pre_compact_summary.yaml": "daa0175d79f3e0127c5ce86a7a2f8df0be3f58b5c94fe749da715a17c7b2d04e",
     "hooks/definitions/pre_tool_capture_route.yaml": "3c2663380ff3cd09f09de5b96bcf6123266fa74d8a03dfb2d6fbe40a43fb13cf",
     "hooks/definitions/protected_path_write_guard.yaml": "6683d41778b823e2a4e606065597569aa04363f091e135e165de9732f1fc2171",
     "hooks/definitions/session_start.yaml": "9383fcf1f8304c87e57726478a461706c0fc73dc62bcc4d8661f2eeffa43a82d",
-    "hooks/definitions/stop_handoff_harvest.yaml": "67a3c0a8bb7cb66b88e77dc79e748082e964d278c47935662c453922a846482b"
+    "hooks/definitions/stop_handoff_harvest.yaml": "67a3c0a8bb7cb66b88e77dc79e748082e964d278c47935662c453922a846482b",
+    "hooks/hooks.json": "f255345793951b5cf6f6d8c9a8b6a6ad2d3140023453410127a6f70d8e110c26"
   }
 }

package/exports/hosts/gemini/host-package.json

@@ -27,13 +27,15 @@
     "workflows/spec-challenge.md",
     "workflows/specify.md",
     "workflows/verify.md",
+    "hooks/definitions/context_mode_router.yaml",
     "hooks/definitions/loop_cap_guard.yaml",
     "hooks/definitions/post_tool_capture.yaml",
     "hooks/definitions/pre_compact_summary.yaml",
     "hooks/definitions/pre_tool_capture_route.yaml",
     "hooks/definitions/protected_path_write_guard.yaml",
     "hooks/definitions/session_start.yaml",
-    "hooks/definitions/stop_handoff_harvest.yaml"
+    "hooks/definitions/stop_handoff_harvest.yaml",
+    "hooks/hooks.json"
   ],
   "files": [
     "GEMINI.md"