@wazir-dev/cli 1.2.0 → 1.4.0

package/CHANGELOG.md

@@ -1,48 +1,9 @@
-# [1.2.0](https://github.com/MohamedAbdallah-14/Wazir/compare/v1.1.0...v1.2.0) (2026-03-19)
-
-
-### Bug Fixes
-
-* address 4 Codex review findings — nested payload, fallback, hashing, freshness key ([2276cae](https://github.com/MohamedAbdallah-14/Wazir/commit/2276caefc3fb22ab2ed1cd1b78152f64f3e5685c))
-* address 5 Codex review findings — routing state root, stats accuracy, Cursor hooks ([2cb21ba](https://github.com/MohamedAbdallah-14/Wazir/commit/2cb21ba258f63a663b8eddc0cc25322900022125))
-* address final review findings — context-mode CLI detection, AC heading overlap, CHANGELOG ([c33947f](https://github.com/MohamedAbdallah-14/Wazir/commit/c33947f8481647017506b0929ff87511d5dc6cad))
-* **hooks:** canonicalize hook registry and fix Claude Code payload mapping (I9) ([3e8810a](https://github.com/MohamedAbdallah-14/Wazir/commit/3e8810af7625de206979ebb356eeae6b7a1b5e67))
-* **self-audit:** loop 1 — add missing run-audit workflow to reference docs ([f830d84](https://github.com/MohamedAbdallah-14/Wazir/commit/f830d842cad4756db3311ff5cedb98fdbb5b0f72))
-* **self-audit:** loop 2 — add run-audit to reference docs, register 2 unlisted test files ([3e65c89](https://github.com/MohamedAbdallah-14/Wazir/commit/3e65c89b0532eed28313a17898abdf3627a5dadf))
-* **self-audit:** loop 3 — fix expertise count drift (261/308→268), schema count (16/18→19), regenerate exports ([500df05](https://github.com/MohamedAbdallah-14/Wazir/commit/500df057c59bcf82d691e52d0d9e09e8cec33edc))
-* **self-audit:** loop 4 — remove unused gray-matter dep, complete skill roster (11→28), add 17 skill readme stubs ([87047d1](https://github.com/MohamedAbdallah-14/Wazir/commit/87047d1f009b2f6cb1c73cd8db69c97d740c6385))
-* **self-audit:** loop 5 — fix INDEX.md counts (60→76 readmes, 11→28 skills), add 3 missing schemas to catalog, fix export diagram counts, remove gray-matter ref, regenerate exports ([92d187c](https://github.com/MohamedAbdallah-14/Wazir/commit/92d187c12786a6d19ec3c65c2d4b09499d853582))
+# [1.4.0](https://github.com/MohamedAbdallah-14/Wazir/compare/v1.3.0...v1.4.0) (2026-03-20)
 
 
 ### Features
 
-* **clarifier:** auto-detect content needs and enable author workflow ([c0f9523](https://github.com/MohamedAbdallah-14/Wazir/commit/c0f95230e0ef104bcbfb0b9bad16a0ab09ba9fb4)), closes [#17](https://github.com/MohamedAbdallah-14/Wazir/issues/17)
-* **clarifier:** context-mode fallbacks (item-6) ([4694143](https://github.com/MohamedAbdallah-14/Wazir/commit/4694143028066e373728feb1e5100cdc5fb6aec2))
-* **clarifier:** gap analysis exit gate (item-3) ([83df703](https://github.com/MohamedAbdallah-14/Wazir/commit/83df703f251a541c2155a2f360aa2e7ec5206f02))
-* **clarifier:** online research phase (item-9) ([0ac5ac8](https://github.com/MohamedAbdallah-14/Wazir/commit/0ac5ac849edeed975fc5051c04a3a234e9ca7994))
-* **clarifier:** preserve input quality (item-1) ([ba46424](https://github.com/MohamedAbdallah-14/Wazir/commit/ba46424d4900a1b13f1456156cb22f54e9b5ba1d))
-* **clarifier:** reviewer skill invocation policy (item-13) ([4b3f59d](https://github.com/MohamedAbdallah-14/Wazir/commit/4b3f59dd7ae3f7f93b4d1f7d7da070dc98c3a369))
-* **clarifier:** run-scoped user feedback routing (item-11) ([5436746](https://github.com/MohamedAbdallah-14/Wazir/commit/5436746d4da453c23c213db7c11e4497870352da))
-* **clarifier:** spec-kit plan format (item-2) ([0266247](https://github.com/MohamedAbdallah-14/Wazir/commit/02662474db97d87c2ce6f82b2e2a7b960d386d00))
-* **executor:** changelog and gitflow enforcement (item-5) ([5a5986a](https://github.com/MohamedAbdallah-14/Wazir/commit/5a5986a0131bbefe7d601e799411ae48cf68fe10))
-* **hooks:** add index refresh to session-start hook (D2) ([ff4647f](https://github.com/MohamedAbdallah-14/Wazir/commit/ff4647f2fc18e963a8180ec3b93937ce70d33be4))
-* **hooks:** extract routing logic and add context-mode router tests (D1/D3) ([1e7650a](https://github.com/MohamedAbdallah-14/Wazir/commit/1e7650a7cf5af944807897f5a3200a69b691cd5f)), closes [passthrou#vs-large](https://github.com/passthrou/issues/vs-large)
-* implement all 8 remaining enhancement items ([00acff5](https://github.com/MohamedAbdallah-14/Wazir/commit/00acff57e7f0bc9515ef8cce8acf9596577fca83))
-* **init-pipeline:** context-mode detection (item-6-init) ([839a5b3](https://github.com/MohamedAbdallah-14/Wazir/commit/839a5b3b41b0246468d4e9b0da61c4f17e7c3c41))
-* **input:** extract input scanner utility and verify scanning (I3) ([8a232a2](https://github.com/MohamedAbdallah-14/Wazir/commit/8a232a2312e4a42b1aefc5c9c6283d738c58f0c4))
-* **review-loop:** fix-and-loop with convergence cap (item-12) ([d2fcb9c](https://github.com/MohamedAbdallah-14/Wazir/commit/d2fcb9c7bd93407a88dda2c8c96ffd397834f268))
-* **review-loop:** phase scoring with dimension deltas (item-15) ([1fe9f6d](https://github.com/MohamedAbdallah-14/Wazir/commit/1fe9f6d85d36d610fb6c48e2e1035d2f71134832))
-* **reviewer:** codex output context protection (item-17) ([abb8a77](https://github.com/MohamedAbdallah-14/Wazir/commit/abb8a77e922268adbfaee721facbdcbaa1e30646))
-* **skills:** interactive numbered options at all checkpoints (item-10) ([45bc6fd](https://github.com/MohamedAbdallah-14/Wazir/commit/45bc6fdf5f8feb558a89823befa72b0ca78cdce3))
-* **templates:** create spec-kit task template (item-8) ([cd55d73](https://github.com/MohamedAbdallah-14/Wazir/commit/cd55d73316a59437c76ddeb22643020a60d76b55))
-* **tooling:** AC verification scaffold — 111 checks (T000) ([ea61684](https://github.com/MohamedAbdallah-14/Wazir/commit/ea616843b5deca97ead38b8db06c1a1eef15458f))
-* **wazir:** enforce pipeline phases — agent must never skip phases ([3e21bd2](https://github.com/MohamedAbdallah-14/Wazir/commit/3e21bd2d36af57d0db4b8dc68458cc63bbb8676a))
-* **wazir:** full end-of-phase reports (item-16) ([6c84455](https://github.com/MohamedAbdallah-14/Wazir/commit/6c84455e867eb19d49b69cfcb130b147a80917f9))
-* **wazir:** implement 9 enhancement decisions from brainstorming session ([885a2c1](https://github.com/MohamedAbdallah-14/Wazir/commit/885a2c1f04fc9ac02c65ed06461114e4c3251393))
-* **wazir:** implement learning system — extraction, injection, and handoff ([06eb107](https://github.com/MohamedAbdallah-14/Wazir/commit/06eb107e8641b50e075ca1744f899da0fe9d09e6)), closes [#1](https://github.com/MohamedAbdallah-14/Wazir/issues/1) [#2](https://github.com/MohamedAbdallah-14/Wazir/issues/2) [#13](https://github.com/MohamedAbdallah-14/Wazir/issues/13)
-* **wazir:** restructure pipeline from 14 phases to 4 (Init, Clarifier, Executor, Final Review) ([d6e2372](https://github.com/MohamedAbdallah-14/Wazir/commit/d6e2372d5a0c6824905569de26ddb2434eb74dca)), closes [#4](https://github.com/MohamedAbdallah-14/Wazir/issues/4) [#5](https://github.com/MohamedAbdallah-14/Wazir/issues/5)
-* **wazir:** resume copies artifacts (item-4) ([14633d4](https://github.com/MohamedAbdallah-14/Wazir/commit/14633d4cd66d04846b3297c3d50d99046a89fb7c))
-* **wazir:** usage reports at phase exits (item-7) ([8f055be](https://github.com/MohamedAbdallah-14/Wazir/commit/8f055be12992c56e01619e2a9547dc3e9045dc7c))
+* Wazir v2 — three-layer enforcement, psychology-driven skill rewriting, 33-agent research ([#6](https://github.com/MohamedAbdallah-14/Wazir/issues/6)) ([893ca14](https://github.com/MohamedAbdallah-14/Wazir/commit/893ca143fc29365f92aa923c87f50d3c66c8f485))
 
 # Changelog
 
@@ -52,16 +13,61 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [Unreleased]
 
+### Added
+- Three-layer enforcement architecture: Stop hook blocks completion, PreToolUse hooks enforce phase gates, subagent-per-phase controller isolates workflows
+- Pipeline state machine (`tooling/src/state/pipeline-state.js`) with session isolation, atomic writes, and crash recovery
+- Per-phase guardrail validators with concrete pass/fail criteria per workflow boundary
+- Consolidated PreToolUse dispatcher replacing 3 separate hooks (reduces false "hook error" labels)
+- Psychology-driven 3-zone skill architecture across all 29 SKILL.md files (primacy Iron Laws → structured process → recency re-anchoring)
+- Rationalization tables, red flags, IF-THEN implementation intentions in every discipline skill
+- CSO description fixes — triggers only, never process summaries
+- Priority stack P0-P5 with conflict examples in every skill
+- Identity framing: "pipeline compliance IS helpfulness"
+- Mode-specific reviewer composition with 8 digest modules (3-5K tokens each)
+- Findings-to-antipattern learning pipeline with LLM-assisted clustering and threshold-based promotion
+- Depth parameter table (`tooling/src/config/depth-table.js`) with 40+ parameters across all phases
+- Artifact dependency graph with digest verification and selective regeneration
+- Decision logging module (`tooling/src/capture/decision.js`) with NDJSON audit trail
+- 33-agent architecture research + 8-agent psychology research (docs/research/)
+- Workflow completion enforcement — `validateRunCompletion()` ensures all enabled workflows complete before run finalizes (`wazir capture summary --complete`)
+- Mandatory security gate — pattern-based diff scanner (`tooling/src/checks/security-sensitivity.js`) auto-adds 6 security review dimensions when auth/token/SQL/etc. patterns detected
+- Three interaction modes: `auto` (overnight, Codex-required), `guided` (default), `interactive` (co-design) via `/wazir auto|interactive ...`
+- User input capture — NDJSON logging of all user messages during a run (`tooling/src/capture/user-input.js`) with retention pruning
+- Two-layer reasoning chain output — concise conversation triggers + detailed file output at `reasoning/phase-<name>-reasoning.md`
+- Input Coverage dimension in self-audit (compares original input vs plan vs commits)
+- Input Coverage dimension in plan-review (8th dimension, catches scope reduction)
+- Two-level phase model — `parent_phase` and `workflow` fields in phase report schema, hierarchy display in `wazir status`
+- CLI/context-mode enforcement — reviewer flags >5 direct reads without index query and large commands without context-mode
+- Per-phase context savings display at phase boundaries via `wazir stats`
+- Overnight skill research skill (`skills/skill-research/SKILL.md`) for competitive analysis against superpowers and other frameworks
+- Anti-pattern docs: AP-23 (skipping enabled workflows), AP-24 (clarifier deciding scope without asking)
+
+### Changed
+- Clarifier Phase 1A rewritten — research runs first, then informed question batches (3-7 per batch), every scope exclusion requires user confirmation
+- Executor enforces one commit per task (hard rule, reviewer rejects multi-task batching)
+- Per-phase savings display added to clarifier and executor phase boundaries
+
+### Fixed
+- SQLite ExperimentalWarning suppressed via lazy dynamic imports in CLI entrypoint
+- `--complete` flag properly parsed in `wazir capture summary`
+- `validateRunCompletion` filters by `workflow_policy` (enabled workflows only), not full manifest list
+
 ### Changed
 - Restructured pipeline from 14 micro-phases to 4 main phases: Init, Clarifier, Executor, Final Review
 - Removed depth and intent questions from pipeline init — depth defaults to standard (override via inline modifiers), intent inferred from request keywords
 - Enabled learn + prepare-next workflows by default (part of Final Review phase)
 - Renamed `phase_policy` to `workflow_policy` in run-config (legacy name still supported)
-- Pipeline init no longer asks about Agent Teams — always sequential
 - Input directory (`input/`) now scanned automatically at startup
 - Learning extraction with concrete proposal format in reviewer final mode
 - Accepted learnings injected into clarifier context (top 10 by confidence, scope-matched)
 - Prepare-next skill produces structured handoff document
+- All pipeline checkpoints now use AskUserQuestion pattern instead of numbered lists
+- Every pipeline phase outputs value-reporting text (before/after) explaining why the phase matters and what it found
+- Review dimensions annotated with "catches:" descriptions explaining what class of bugs each dimension prevents
+
+### Removed
+- `@inquirer/prompts` dependency and `--interactive` init path (always fails in non-TTY)
+- All Agent Teams references (team_mode, parallel_backend, TeamCreate/SendMessage/TeamDelete, Free Thinker/Grounder/Synthesizer)
 
 ### Fixed
 - Router logs now write to manifest-derived state root instead of `_default` (Codex P1)
@@ -69,15 +75,19 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 - Index-query savings now computed from avoided bytes, not raw bytes (Codex P2)
 - Index-query savings included in savings-ratio denominator (Codex P2)
 - Cursor export now includes context-mode-router hook (Codex P2)
+- SessionStart hook uses correct `database_path` key for index freshness check
+- TabManager stop hook error documented as Claude Code internal (cannot fix from Wazir side)
 
 ### Added
 - Core review loop pattern across all pipeline phases with Codex CLI integration
 - `wazir capture loop-check` CLI subcommand with task-scoped cap tracking and run-config loader
-- `wazir init` interactive CLI command with arrow-key selection (depth, intent, teams, codex model)
+- `wazir init` zero-config auto-init (no prompts, infer everything)
 - `docs/reference/review-loop-pattern.md` canonical reference for the review loop pattern
 - Standalone skills: `/wazir:clarifier`, `/wazir:executor`, `/wazir:reviewer`
-- Agent Teams real implementation in brainstorming (TeamCreate, SendMessage, TeamDelete)
 - Codex prompt templates (artifact + code) with "Do NOT load skills" instruction
+- `tooling/src/verify/proof-collector.js` — detects project type (web/api/cli/library) and collects mechanical proof of implementation
+- Phase reports wired into pipeline — `wazir report phase` called after each phase exit and displayed to user
+- Proof-of-implementation in verify workflow — runnable vs non-runnable detection with evidence collection
 - Git branch enforcement in `/wazir` runner (validates branch, offers to create feature branch)
 - CLI wiring across pipeline phases (doctor gate, index build/refresh, capture events, validate gates)
 - CHANGELOG enforcement in executor and reviewer skills

package/README.md

@@ -32,7 +32,7 @@
 I'm Mohamed Abdallah. I kept watching AI agents write confident code that broke in production, skip tests, and forget what we agreed on yesterday. So I stopped asking them to be better and built them an engineering department instead.
 
 **Wazir puts engineering discipline inside AI coding agents.**
-No wrapper. No server. Just structure -- inside Claude, Codex, Gemini, and Cursor. Built on 300+ research sources distilled into 268 curated expertise modules across 12 domains.
+No wrapper. No server. Just structure -- inside Claude, Codex, Gemini, and Cursor. Built on 300+ research sources distilled into 315 curated expertise modules across 12 domains.
 
 ---
 
@@ -77,7 +77,7 @@ AI agents love to announce they're finished. Wazir doesn't care. Every phase loo
 
 ## The Pipeline
 
-Every task flows through 14 phases. Three are adversarial review gates that block progress until the reviewer explicitly approves. Rejection loops back to the authoring phase.
+Every task flows through 15 workflows grouped into 4 phases. Three are adversarial review gates that block progress until the reviewer explicitly approves. Rejection loops back to the authoring phase.
 
 ```mermaid
 graph LR
@@ -124,7 +124,7 @@ Three concepts.
 
 **2 -- Phases are artifact checkpoints, not conversation stages.** Every phase consumes a named artifact from the previous phase and produces a named artifact for the next. Nothing flows through conversation history. A session can end, a new agent can pick up the artifacts, and delivery continues. The handoff is explicit, structured, and schema-validated against 19 JSON schemas. See [Architecture](docs/concepts/architecture.md).
 
-**3 -- The composition engine loads the right expert automatically.** One agent pretending to be an expert in everything is an expert in nothing. A 4-layer system (always, auto, stacks, concerns) decides which of 268 expertise modules load into each role's context. The executor gets modules on how to build. The verifier gets modules on what to detect. The reviewer gets modules on what to flag. All resolved automatically from the task's declared stack and concerns. Max 15 modules per dispatch, token budget enforced.
+**3 -- The composition engine loads the right expert automatically.** One agent pretending to be an expert in everything is an expert in nothing. A 4-layer system (always, auto, stacks, concerns) decides which of 315 expertise modules load into each role's context. The executor gets modules on how to build. The verifier gets modules on what to detect. The reviewer gets modules on what to flag. All resolved automatically from the task's declared stack and concerns. Max 15 modules per dispatch, token budget enforced.
 
 ---
 
@@ -169,17 +169,17 @@ Run `wazir capture usage` at the end of a session to see the savings:
 
 **10 canonical role contracts.** Clarifier, researcher, specifier, content-author, designer, planner, executor, verifier, reviewer, learner. Each has enforceable inputs, outputs, and escalation rules. [Roles reference](docs/reference/roles-reference.md)
 
-**Adversarial review at three chokepoints.** Spec-challenge, plan-review, and final review run by the reviewer role, never the phase author. Nine hard approval gates span the 14-phase pipeline. Nothing advances without explicit clearance. [Architecture](docs/concepts/architecture.md)
+**Adversarial review at three chokepoints.** Spec-challenge, plan-review, and final review run by the reviewer role, never the phase author. Nine hard approval gates span the 15-workflow pipeline. Nothing advances without explicit clearance. [Architecture](docs/concepts/architecture.md)
 
-**268 curated expertise modules across 12 domains.** Loaded selectively per role per phase via a 4-layer composition engine. Max 15 modules per dispatch, token budget enforced. Wazir ships with 268. Yours could be next. [Expertise index](docs/reference/expertise-index.md)
+**315 curated expertise modules across 12 domains.** Loaded selectively per role per phase via a 4-layer composition engine. Max 15 modules per dispatch, token budget enforced. Wazir ships with 315. Yours could be next. [Expertise index](docs/reference/expertise-index.md)
 
 **Three-tier recall for token savings.** L0 (~~100 tokens), L1 (~~500-2k tokens), direct read for full source. Symbol-first exploration searches the index before reading source. Capture routing redirects large tool output to files. Result: 60-80% token reduction on exploration-heavy phases, measured per-session by `wazir capture usage`. [Indexing and Recall](docs/concepts/indexing-and-recall.md)
 
 **Structured learning.** Proposed learnings require explicit review and scope tagging before promotion. Only learnings whose file patterns overlap the current task get injected into context. The system improves per-project without drifting.
 
-**7 hook contracts for structural guardrails.** These enforce protected path writes (exit 42), loop caps (exit 43), and session observability. [Hooks](docs/reference/hooks.md)
+**8 hook contracts for structural guardrails.** These enforce protected path writes (exit 42), loop caps (exit 43), and session observability. [Hooks](docs/reference/hooks.md)
 
-**20+ callable skills.** `/wazir` runs the full pipeline. `/wazir audit security` runs a codebase audit. `/wazir prd` generates a product requirements document from completed runs. Plus TDD, verification, debugging, and more -- each enforcing an exact procedure with evidence at every step. [Skills](docs/reference/skills.md)
+**28 callable skills.** `/wazir` runs the full pipeline. `/wazir audit security` runs a codebase audit. `/wazir prd` generates a product requirements document from completed runs. Plus TDD, verification, debugging, and more -- each enforcing an exact procedure with evidence at every step. [Skills](docs/reference/skills.md)
 
 **Built-in text humanization.** The composition engine loads domain-specific language rules per role: code rules for the executor (commit messages, comments), content rules for the content-author (microcopy, glossary), and technical-docs rules for the specifier, planner, reviewer, and learner. A 61-item vocabulary blacklist, 24-pattern sentence taxonomy, and two-pass self-audit checklist keep all output sounding like it was written by a person.
 
@@ -189,19 +189,19 @@ Run `wazir capture usage` at the end of a session to see the savings:
 
 ## Compared to Other Tools
 
-The AI coding tool space is fragmenting. Developers bolt together separate plugins for workflow management, specification, memory, output compression, and orchestration. Not every project needs 14 phases. For a weekend hack, prompting is fine. For production, you want structure.
+The AI coding tool space is fragmenting. Developers bolt together separate plugins for workflow management, specification, memory, output compression, and orchestration. Not every project needs 15 workflows. For a weekend hack, prompting is fine. For production, you want structure.
 
 
 | Dimension              | Wazir                         | [Superpowers](https://github.com/obra/superpowers) | [Spec-Kit](https://github.com/github/spec-kit) | [Micro-Agent](https://github.com/BuilderIO/micro-agent) | [Distill](https://github.com/samuelfaj/distill) | [Claude-Mem](https://github.com/thedotmack/claude-mem) | [OMC](https://github.com/yeachan-heo/oh-my-claudecode) |
 | ---------------------- | ----------------------------- | -------------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------- | ----------------------------------------------- | ------------------------------------------------------ | ------------------------------------------------------ |
 | **Category**           | Engineering OS                | Skills framework                                   | Spec toolkit                                   | Code gen agent                                          | Output compressor                               | Memory plugin                                          | Orchestration layer                                    |
-| **Scope**              | Full lifecycle (14 phases)    | Dev workflow (~20 skills)                          | Specify / Plan / Implement                     | Single-file TDD loop                                    | CLI output compression                          | Session memory                                         | Multi-agent orchestration                              |
+| **Scope**              | Full lifecycle (15 workflows) | Dev workflow (~20 skills)                          | Specify / Plan / Implement                     | Single-file TDD loop                                    | CLI output compression                          | Session memory                                         | Multi-agent orchestration                              |
 | **Enforced roles**     | 10 canonical, contractual     | None (skills only)                                 | None                                           | None                                                    | None                                            | None                                                   | 32 agents (behavioral)                                 |
-| **Phase model**        | 14 explicit, artifact-gated   | 7-step (advisory)                                  | 3-step                                         | 1 (generate/test)                                       | N/A                                             | N/A                                                    | 5-step pipeline                                        |
+| **Phase model**        | 15 explicit, artifact-gated   | 7-step (advisory)                                  | 3-step                                         | 1 (generate/test)                                       | N/A                                             | N/A                                                    | 5-step pipeline                                        |
 | **Adversarial review** | 3 gate phases                 | Code review skill                                  | No                                             | No                                                      | No                                              | No                                                     | team-verify step                                       |
 | **Context management** | L0/L1 tiered recall           | None                                               | None                                           | None                                                    | LLM compression                                 | Vector DB (ChromaDB)                                   | Token routing                                          |
 | **Schema validation**  | 19 JSON schemas               | No                                                 | No                                             | No                                                      | No                                              | No                                                     | No                                                     |
-| **Guardrails**         | 7 hook contracts              | None                                               | None                                           | None                                                    | None                                            | 5 hooks (memory)                                       | Agent tracking                                         |
+| **Guardrails**         | 8 hook contracts              | None                                               | None                                           | None                                                    | None                                            | 5 hooks (memory)                                       | Agent tracking                                         |
 | **External deps**      | None (host-native)            | None (prompt-only)                                 | Python CLI                                     | Node.js CLI                                             | Node.js + LLM                                   | ChromaDB, SQLite, Bun                                  | tmux, exp. teams API                                   |
 | **Host support**       | Claude, Codex, Gemini, Cursor | Claude, Codex, Gemini, Cursor, OpenCode            | Claude, Copilot, Gemini                        | Any LLM provider                                        | Any LLM                                         | Claude Code only                                       | Claude Code (+ workers)                                |
 
@@ -264,8 +264,8 @@ The pipeline, roles, and expertise modules are stable and used in production by
 
 What's solid:
 
-- The 14-phase pipeline and 10 role contracts
-- 268 expertise modules across 12 domains
+- The 15-workflow pipeline and 10 role contracts
+- 315 expertise modules across 12 domains
 - Host exports for Claude, Codex, Gemini, and Cursor
 - The composition engine and tiered recall system
 

package/assets/demo.cast

@@ -0,0 +1,47 @@
+{"version":3,"term":{"cols":387,"rows":85,"type":"xterm-256color","version":"Warp(v0.2026.03.04.08.20.stable_03)"},"timestamp":1773955554,"command":"bash assets/demo-script.sh","env":{"SHELL":"/bin/zsh"}}
+[0.008, "o", "$ wazir doctor\r\n"]
+[0.315, "o", "\u001b[1G"]
+[0.000, "o", "\u001b[0K⠙"]
+[0.081, "o", "\u001b[1G\u001b[0K⠹"]
+[0.080, "o", "\u001b[1G\u001b[0K⠸"]
+[0.082, "o", "\u001b[1G\u001b[0K⠼"]
+[0.081, "o", "\u001b[1G\u001b[0K⠴"]
+[0.080, "o", "\u001b[1G\u001b[0K⠦"]
+[0.082, "o", "\u001b[1G\u001b[0K⠧"]
+[0.082, "o", "\u001b[1G\u001b[0K⠇"]
+[0.081, "o", "\u001b[1G\u001b[0K⠏"]
+[0.080, "o", "\u001b[1G\u001b[0K⠋"]
+[0.080, "o", "\u001b[1G\u001b[0K⠙"]
+[0.025, "o", "\u001b[1G\u001b[0K"]
+[0.187, "o", "(node:20008) ExperimentalWarning: SQLite is an experimental feature and might change at any time\r\n(Use `node --trace-warnings ...` to show where the warning was created)\r\n"]
+[0.074, "o", "PASS manifest: Manifest is valid.\r\nPASS hooks: Hook definitions are valid.\r\nPASS state-root: /Users/mohamedabdallah/.wazir/projects/wazir stays outside the project root\r\nPASS host-exports: All required host export directories exist.\r\n"]
+[0.004, "o", "\u001b[1G\u001b[0K⠙"]
+[0.001, "o", "\u001b[1G\u001b[0K"]
+[2.010, "o", "\r\n$ wazir export build\r\n"]
+[0.287, "o", "\u001b[1G"]
+[0.000, "o", "\u001b[0K⠙"]
+[0.081, "o", "\u001b[1G\u001b[0K⠹"]
+[0.081, "o", "\u001b[1G\u001b[0K⠸"]
+[0.080, "o", "\u001b[1G\u001b[0K⠼"]
+[0.081, "o", "\u001b[1G\u001b[0K⠴"]
+[0.082, "o", "\u001b[1G\u001b[0K⠦"]
+[0.012, "o", "\u001b[1G\u001b[0K"]
+[0.164, "o", "(node:20085) ExperimentalWarning: SQLite is an experimental feature and might change at any time\r\n(Use `node --trace-warnings ...` to show where the warning was created)\r\n"]
+[0.070, "o", "Generated host exports for claude, codex, gemini, cursor.\r\n"]
+[0.004, "o", "\u001b[1G\u001b[0K⠙"]
+[0.000, "o", "\u001b[1G\u001b[0K"]
+[2.013, "o", "\r\n$ wazir index build\r\n"]
+[0.304, "o", "\u001b[1G"]
+[0.000, "o", "\u001b[0K⠙"]
+[0.081, "o", "\u001b[1G\u001b[0K⠹"]
+[0.080, "o", "\u001b[1G\u001b[0K⠸"]
+[0.081, "o", "\u001b[1G\u001b[0K⠼"]
+[0.081, "o", "\u001b[1G\u001b[0K⠴"]
+[0.081, "o", "\u001b[1G\u001b[0K⠦"]
+[0.081, "o", "\u001b[1G\u001b[0K⠧"]
+[0.018, "o", "\u001b[1G\u001b[0K"]
+[0.189, "o", "(node:20186) ExperimentalWarning: SQLite is an experimental feature and might change at any time\r\n(Use `node --trace-warnings ...` to show where the warning was created)\r\n"]
+[1.042, "o", "Indexed 889 files, 7493 symbols, and 26395 outlines.\r\n"]
+[0.005, "o", "\u001b[1G\u001b[0K⠙"]
+[0.001, "o", "\u001b[1G\u001b[0K"]
+[1.014, "x", "0"]

package/docs/anti-patterns/AP-23-skipping-enabled-workflows.md

@@ -0,0 +1,28 @@
+# AP-23: Selectively Skipping Enabled Workflows Within a Phase
+
+## Pattern
+
+An agent completes a phase but skips one or more enabled workflows. The run proceeds to completion without the skipped workflow's output. No error is raised because the phase gate only checks artifacts from explicitly required predecessors, not workflow-level completeness.
+
+## Example
+
+The final review phase has three workflows: `review`, `learn`, `prepare_next`. The agent completes `review` and presents the verdict, but skips `learn` and `prepare_next`. The run is marked complete. No learnings are captured, no handoff document is produced.
+
+## Harm
+
+- Learnings from the run are lost — the same mistakes repeat in future runs
+- Handoff documents are missing — the next session starts without context
+- Verification evidence is incomplete — claims cannot be audited
+- The user believes the pipeline ran fully when it did not
+
+## Detection
+
+`validateRunCompletion(runDir, manifestPath)` in `tooling/src/guards/phase-prerequisite-guard.js` checks that every workflow declared in `wazir.manifest.yaml` has a `phase_exit` event with `status: completed` in the run's `events.ndjson`.
+
+`wazir capture summary --complete` calls this check and refuses to finalize the run if any enabled workflow was skipped.
+
+## Fix
+
+1. Always emit `phase_exit` events for every workflow: `wazir capture event --run <id> --event phase_exit --phase <workflow> --status completed`
+2. Use `wazir capture summary --complete` instead of bare `wazir capture summary` at run end
+3. The wazir pipeline skill checks completion before presenting final results

package/docs/anti-patterns/AP-24-clarifier-deciding-scope.md

@@ -0,0 +1,34 @@
+# AP-24: Clarifier Making Scope Decisions Without Asking
+
+## Pattern
+
+The clarifier autonomously decides that certain items are "out of scope" without asking the user. This typically happens when the input doesn't explicitly mention something (e.g., documentation, i18n, testing strategy), and the clarifier assumes silence means exclusion.
+
+## Example
+
+User input: "Build a user authentication system with OAuth2."
+
+Clarifier produces: "Out of scope: documentation, i18n, rate limiting, password recovery."
+
+The user never agreed to exclude any of these. The clarifier decided unilaterally.
+
+## Harm
+
+- Items the user wanted are silently dropped
+- The user sees the final output and assumes the pipeline covered everything
+- 21 input items become 5 tasks because the clarifier excluded 16 without asking
+- Trust in the pipeline erodes when users discover missing features after delivery
+
+## Detection
+
+- Clarification document contains "out of scope" items that were never discussed with the user
+- Plan has fewer tasks than distinct items in the original input
+- Scope coverage guard (`evaluateScopeCoverageGuard`) flags plan < input items
+
+## Fix
+
+1. Research runs FIRST — the clarifier must have context before asking questions
+2. After research, ask INFORMED questions in batches of 3-7
+3. Every scope exclusion must reference an explicit user confirmation
+4. If the input is clear, zero questions is fine — but the clarifier must state "no ambiguities detected" rather than silently proceeding
+5. The clarification document must cite user responses for every scope boundary decision

package/docs/concepts/architecture.md

@@ -10,7 +10,7 @@ Wazir is a host-native engineering OS kit. The host environment (Claude, Codex,
 | Workflows | Phase entrypoints that sequence roles through delivery |
 | Skills | Reusable procedures (wz:tdd, wz:debugging, wz:verification, wz:brainstorming) |
 | Hooks | Guardrails enforcing protected paths, loop caps, and capture routing |
-| Expertise | 268 curated knowledge modules composed into agent prompts |
+| Expertise | 315 curated knowledge modules composed into agent prompts |
 | Templates | Artifact templates for phase outputs and handoff |
 | Schemas | Validation schemas for manifest, hooks, artifacts, and exports |
 | Exports | Generated host packages tailored per supported host |

package/docs/concepts/why-wazir.md

@@ -24,7 +24,7 @@ The agent audits its own work in an isolated git worktree. Validates, finds stru
 
 ## 6. Composer
 
-~300 curated expertise modules across 12 domains. The composition engine assembles task-specific agents by loading the right expertise for each role, stack, and concern. The executor building a Flutter RTL app gets Flutter patterns, RTL layout rules, and mobile antipatterns composed into its context. The reviewer gets the corresponding antipattern catalog. Every dispatched agent is a specialist, not a generalist pretending.
+315 curated expertise modules across 12 domains. The composition engine assembles task-specific agents by loading the right expertise for each role, stack, and concern. The executor building a Flutter RTL app gets Flutter patterns, RTL layout rules, and mobile antipatterns composed into its context. The reviewer gets the corresponding antipattern catalog. Every dispatched agent is a specialist, not a generalist pretending.
 
 ## 7. Review Loops
 

package/docs/readmes/INDEX.md

@@ -94,7 +94,7 @@
 ### Other Features
 | File | Description |
 |------|-------------|
-| [expertise/README.md](features/expertise/README.md) | Expertise system — 268 modules across 12 domains |
+| [expertise/README.md](features/expertise/README.md) | Expertise system — 315 modules across 12 domains |
 | [schemas/README.md](features/schemas/README.md) | Schema system — 19 JSON schemas for artifact validation |
 | [tooling/README.md](features/tooling/README.md) | CLI tooling — all commands with options and examples |
 | [exports/README.md](features/exports/README.md) | Host exports — Claude, Codex, Gemini, Cursor packages |

package/docs/readmes/features/expertise/README.md

@@ -1,6 +1,6 @@
 # Expertise System
 
-Wazir's expertise system is a curated library of **268 knowledge modules** spanning
+Wazir's expertise system is a curated library of **315 knowledge modules** spanning
 architecture, security, performance, design, and more. Modules are loaded selectively into
 agent prompts — giving the right knowledge to the right role at the right phase — without
 flooding context with irrelevant content.

package/docs/readmes/features/hooks/pre-compact-summary.md

@@ -64,7 +64,7 @@ This hook does not block. On failure:
 
 ## Key Findings
 - All 127 tests passing after rate-limit middleware implementation
-- Hook validation: all 7 hooks validated
+- Hook validation: all 8 hooks validated
 
 ## Captures
 - captures/npm-test-001.txt — full test run output (47KB)

package/docs/reference/hooks.md

@@ -15,6 +15,7 @@ These hook definitions are product contracts first. Host-specific native hooks o
 | `stop_handoff_harvest` | Persist final handoff and stop-time observability data | capture |
 | `protected_path_write_guard` | Block writes to protected canonical paths outside approved flows | block |
 | `loop_cap_guard` | Block extra iterations after the configured loop cap | block |
+| `context_mode_router` | Route large command output through context-mode tools to avoid flooding model context | warn |
 
 ## Source of truth
 

package/docs/reference/launch-checklist.md

@@ -26,7 +26,7 @@ Submit pull requests to these curated lists (one PR per list, follow each repo's
 ### awesome-claude-code
 - **Repo:** `github.com/anthropics/awesome-claude-code` (or the most-starred community fork)
 - **Section:** Tools / Plugins / Extensions
-- **Entry format:** `[Wazir](https://github.com/MohamedAbdallah-14/Wazir) - Host-native engineering OS kit with 10 roles, 4 phases (15 workflows), and 268 expertise modules.`
+- **Entry format:** `[Wazir](https://github.com/MohamedAbdallah-14/Wazir) - Host-native engineering OS kit with 10 roles, 4 phases (15 workflows), and 315 expertise modules.`
 - **Tips:** Keep the description under 120 characters. Link directly to the repo.
 
 ### awesome-ai-agents
@@ -56,7 +56,7 @@ Show HN: Wazir – Engineering OS kit for AI coding agents (Claude, Codex, Gemin
 ### First comment
 Post a comment immediately after submission explaining:
 1. What problem Wazir solves (AI agents lack structured engineering workflows)
-2. How it works (10 canonical roles, 14-phase pipeline, 268 expertise modules)
+2. How it works (10 canonical roles, 15-workflow pipeline, 315 expertise modules)
 3. What makes it different (host-native, works across Claude/Codex/Gemini/Cursor)
 4. Quick install: `npx @wazir-dev/cli init`
 5. Invite feedback -- HN readers appreciate genuine requests for input
@@ -100,7 +100,7 @@ Structure as a 5-7 tweet thread:
 
 1. **Hook tweet:** One-liner about the problem + link to repo.
 2. **What it is:** Brief description of Wazir.
-3. **Architecture:** 10 roles, 4 phases (15 workflows), 308 modules (include a diagram image).
+3. **Architecture:** 10 roles, 4 phases (15 workflows), 315 modules (include a diagram image).
 4. **Demo:** Short GIF or screenshot of a workflow in action.
 5. **Multi-host:** Works with Claude, Codex, Gemini, and Cursor.
 6. **Install:** `npx @wazir-dev/cli init`

package/docs/reference/review-loop-pattern.md

@@ -293,7 +293,7 @@ Matches canonical `workflows/design-review.md`:
 4. **Visual consistency** -- design tokens form a coherent system, dark/light mode alignment
 5. **Exported-code fidelity** -- do exported scaffolds match the designs? Mismatches are failures here, not implementation concerns.
 
-### Plan Dimensions (7)
+### Plan Dimensions (8)
 
 1. **Completeness** -- all design decisions mapped to tasks
 2. **Ordering** -- dependencies correct, parallelizable identified
@@ -302,6 +302,7 @@ Matches canonical `workflows/design-review.md`:
 5. **Edge cases** -- error paths covered
 6. **Security** -- auth, injection, data exposure
 7. **Integration** -- tasks connect end-to-end
+8. **Input Coverage** -- every distinct item in the original input maps to at least one task. If `tasks < input items`, HIGH finding listing missing items
 
 ### Task Execution Dimensions (5)
 
@@ -499,7 +500,7 @@ These are the fixed rubrics — no ad-hoc dimension selection:
 | research-review | Coverage, Source quality, Relevance, Gaps identified, Actionability |
 | clarification-review / spec-challenge | Completeness, Testability, Ambiguity, Assumptions, Scope creep |
 | design-review | Spec coverage, Design-spec consistency, Accessibility, Visual consistency, Exported-code fidelity |
-| plan-review | Completeness, Testability, Task granularity, Dependency correctness, Phase structure, File coverage, Estimation accuracy |
+| plan-review | Completeness, Testability, Task granularity, Dependency correctness, Phase structure, File coverage, Estimation accuracy, Input coverage |
 | task-review | Correctness, Tests, Wiring, Drift, Quality |
 | final | Correctness, Completeness, Wiring, Verification, Drift, Quality, Documentation |
 

package/docs/reference/skill-tiers.md

@@ -13,7 +13,7 @@ Each skill is classified into one of three tiers:
 
 | Wazir Skill | Superpowers Equivalent | Tier | Rationale | Risk Notes |
 |---|---|---|---|---|
-| brainstorming | brainstorming | **Own** | Structurally rewritten. Superpowers version is a linear checklist (explore context, ask questions, propose approaches, present design, write doc, invoke writing-plans). Wazir replaces the entire process: adds Command Routing and Codebase Exploration preambles, replaces the design-doc step with a design-review loop (`--mode design-review` with canonical dimensions), outputs to `.wazir/runs/latest/clarified/design.md` instead of `docs/plans/`, and adds a complete Agent Teams multi-agent brainstorming mode (Free Thinker / Grounder / Synthesizer / Arbiter pattern using TeamCreate/SendMessage). None of the superpowers process steps survive intact. | Dropping the Agent Teams mode would lose Wazir's most differentiated brainstorming capability. |
+| brainstorming | brainstorming | **Own** | Structurally rewritten. Superpowers version is a linear checklist (explore context, ask questions, propose approaches, present design, write doc, invoke writing-plans). Wazir replaces the entire process: adds Command Routing and Codebase Exploration preambles, replaces the design-doc step with a design-review loop (`--mode design-review` with canonical dimensions), and outputs to `.wazir/runs/latest/clarified/design.md` instead of `docs/plans/`. None of the superpowers process steps survive intact. | -- |
 | clarifier | _(none)_ | **Own** | Wazir-original. No superpowers counterpart exists. | -- |
 | debugging | systematic-debugging | **Own** | Structurally rewritten. Superpowers has a 4-phase process (Root Cause Investigation with 5 substeps, Pattern Analysis, Hypothesis and Testing, Implementation) totaling ~300 lines with detailed examples, rationalization tables, and supporting technique references. Wazir condenses this to a 4-step observe-hypothesize-test-fix loop (~75 lines), replaces all codebase exploration with Wazir CLI symbol-first exploration (`wazir index search-symbols`, `wazir recall symbol` and `wazir recall file`), adds loop cap awareness (pipeline mode with `wazir capture loop-check` vs. standalone mode), and removes all superpowers examples, rationalization tables, and red-flag lists. The methodology is fundamentally different in structure despite sharing the spirit of "root cause first." | Delegating would lose Wazir CLI integration and loop cap awareness. Superpowers version is far more detailed on anti-patterns and may be worth referencing separately. |
 | design | _(none)_ | **Own** | Wazir-original. No superpowers counterpart exists. | -- |
@@ -140,7 +140,7 @@ If superpowers or Claude Code introduces a composition/layering mechanism in the
 
 2. **Augment tier is not implementable.** R2 validation (2026-03-19) found that skill shadowing in both superpowers `skills-core.js` and Claude Code's native Skill tool is full-override: placing a SKILL.md in `~/.claude/skills/<name>/` completely replaces the superpowers skill with the same name. There is no merge or append mechanism. The three former Augment candidates (dispatching-parallel-agents, finishing-a-development-branch, using-git-worktrees) have been reclassified to Own. See [Augment Mechanism](#augment-mechanism) for full analysis.
 
-3. **All 14 forked skills are Own** because either (a) they introduce structural process changes (review loops, pipeline mode, Codex integration, Agent Teams, content restructuring) or (b) the Augment composition mechanism does not exist in the platform.
+3. **All 14 forked skills are Own** because either (a) they introduce structural process changes (review loops, pipeline mode, Codex integration, content restructuring) or (b) the Augment composition mechanism does not exist in the platform.
 
 4. **Token cost tradeoff is significant.** Several Wazir Own skills (tdd, verification, debugging, writing-skills) are dramatically shorter than their superpowers counterparts. The superpowers versions contain valuable rationalization prevention tables, detailed examples, and anti-pattern catalogs that enforce discipline. The Wazir versions trade this for token efficiency. This tradeoff should be revisited -- some of the removed discipline content may be worth recovering as separate reference files.