pan-wizard 3.35.0 → 3.37.0

package/docs/SKILLS-REFERENCE.md

@@ -0,0 +1,1037 @@
+# PAN Wizard — Skills Reference
+
+Complete catalog of every skill (slash command) available in PAN Wizard, organized by purpose.
+Each entry shows the command, what it does, what tools it uses, and when to reach for it.
+
+> Auto-generated by `scripts/generate-skills-docs.py` — do not edit manually.
+> For canonical counts (commands / agents / modules / etc.), see `CLAUDE.md`.
+
+---
+
+## Table of Contents
+
+- [Shipped Skills](#shipped-skills) — installed into host projects
+  - [Getting Started](#getting-started)
+  - [Phase Lifecycle](#phase-lifecycle)
+  - [Phase Management](#phase-management)
+  - [Focus](#focus)
+  - [Milestone](#milestone)
+  - [Milestone Lifecycle](#milestone-lifecycle)
+  - [Session & Progress](#session--progress)
+  - [System](#system)
+  - [Army](#army)
+  - [Observability](#observability)
+  - [Self-Improvement](#self-improvement)
+  - [Git Workflow](#git-workflow)
+  - [Knowledge](#knowledge)
+  - [Validation](#validation)
+  - [Foresight](#foresight)
+  - [Review](#review)
+- [Dev Skills](#dev-skills) — PAN source repo only
+  - [Development Workflow](#development-workflow)
+  - [Testing & Verification](#testing--verification)
+  - [Documentation & Audit](#documentation--audit)
+  - [Build & Deploy](#build--deploy)
+  - [Session Management](#session-management)
+
+---
+
+## Shipped Skills
+
+These are installed into host projects via the PAN installer and available to end users.
+
+### Getting Started
+
+| Skill | Tools | Description |
+|-------|-------|-------------|
+| `/pan:map-codebase` | Read, Bash, Glob, Grep, Write, Task | Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents |
+| `/pan:new-project` | Read, Bash, Write, Task, AskUserQuestion | Initialize a new project with deep context gathering and project.md |
+
+#### /pan:map-codebase
+
+Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
+
+```text
+/pan:map-codebase [optional: specific area to map, e.g., 'api' or 'auth']
+```
+
+**Tools:** Read, Bash, Glob, Grep, Write, Task  
+**Group:** Getting Started  
+**Lines:** 113
+
+#### /pan:new-project
+
+Initialize a new project with deep context gathering and project.md
+
+```text
+/pan:new-project [--auto] [--research [market]]
+```
+
+**Tools:** Read, Bash, Write, Task, AskUserQuestion  
+**Group:** Getting Started  
+**Lines:** 110
+
+---
+
+### Phase Lifecycle
+
+| Skill | Tools | Description |
+|-------|-------|-------------|
+| `/pan:autodev` | Read, Bash | Run the roadmap unattended — a deterministic loop that plans, executes, verifies and completes phase after phase, each step in a fresh host session, and stops in code |
+| `/pan:design-phase` | Read, Write, Bash, Glob, Grep, Task, WebFetch, mcp__context7__* | Design a roadmap phase before planning — architecture, ADR, threat-lite, machine-checkable criteria — verified by an independent checker |
+| `/pan:discuss-phase` | Read, Write, Bash, Glob, Grep, AskUserQuestion, Task | Gather phase context through adaptive questioning before planning |
+| `/pan:exec-phase` | Read, Write, Edit, Glob, Grep, Bash, Task, TodoWrite, AskUserQuestion | Execute all plans in a phase with wave-based parallelization |
+| `/pan:plan-phase` | Read, Write, Bash, Glob, Grep, Task, WebFetch, mcp__context7__* | Create detailed phase plan (plan.md) with verification loop |
+| `/pan:verify-phase` | Read, Bash, Glob, Grep, Edit, Write, Task | Re-run goal-backward verification of a phase with a test-suite gate and list its gaps, or walk its UAT with --uat |
+
+#### /pan:autodev
+
+Run the roadmap unattended — a deterministic loop that plans, executes, verifies and completes phase after phase, each step in a fresh host session, and stops in code
+
+```text
+/pan:autodev [run | resume | status | report | replay] [--host claude|codex|gemini|opencode] [--max-usd N] [--max-usd-day N] [--max-turns N] [--worktrees] [--quality] [--ci [local] [--ci-rounds N] [--ci-push] [--ci-base B]] [--run <id>]
+```
+
+**Tools:** Read, Bash  
+**Group:** Phase Lifecycle  
+**Lines:** 76
+
+#### /pan:design-phase
+
+Design a roadmap phase before planning — architecture, ADR, threat-lite, machine-checkable criteria — verified by an independent checker
+
+```text
+/pan:design-phase <phase> [--spike] [--skip-design] [--redesign]
+```
+
+**Tools:** Read, Write, Bash, Glob, Grep, Task, WebFetch, mcp__context7__*  
+**Group:** Phase Lifecycle  
+**Lines:** 85
+
+#### /pan:discuss-phase
+
+Gather phase context through adaptive questioning before planning
+
+```text
+/pan:discuss-phase <phase> [--auto]
+```
+
+**Tools:** Read, Write, Bash, Glob, Grep, AskUserQuestion, Task  
+**Group:** Phase Lifecycle  
+**Lines:** 86
+
+#### /pan:exec-phase
+
+Execute all plans in a phase with wave-based parallelization
+
+```text
+/pan:exec-phase <phase-number> [--plan <id>] [--gaps-only] [--skip-tests] [--skip-review] [--fast] [--deep-review] [--hierarchical] [--auto] [--quality]
+```
+
+**Tools:** Read, Write, Edit, Glob, Grep, Bash, Task, TodoWrite, AskUserQuestion  
+**Group:** Phase Lifecycle  
+**Lines:** 135
+
+#### /pan:plan-phase
+
+Create detailed phase plan (plan.md) with verification loop
+
+```text
+/pan:plan-phase [phase] [--auto] [--research] [--skip-research] [--gaps] [--skip-verify] [--prd <file>] [--research-only] [--quality]
+```
+
+**Tools:** Read, Write, Bash, Glob, Grep, Task, WebFetch, mcp__context7__*  
+**Group:** Phase Lifecycle  
+**Lines:** 139
+
+#### /pan:verify-phase
+
+Re-run goal-backward verification of a phase with a test-suite gate and list its gaps, or walk its UAT with --uat
+
+```text
+/pan:verify-phase [phase number, e.g., '4'] [--uat]
+```
+
+**Tools:** Read, Bash, Glob, Grep, Edit, Write, Task  
+**Group:** Phase Lifecycle  
+**Lines:** 84
+
+---
+
+### Phase Management
+
+| Skill | Tools | Description |
+|-------|-------|-------------|
+| `/pan:add-phase` | Read, Write, Bash | Add phase to end of current milestone in roadmap |
+| `/pan:assumptions` | Read, Bash, Grep, Glob | Surface Claude's assumptions about a phase approach before planning |
+| `/pan:insert-phase` | Read, Write, Bash | Insert urgent work as decimal phase (e.g., 72.1) between existing phases |
+| `/pan:phase-budget` | Bash, Read | Estimate context utilization and quality for the current phase |
+| `/pan:phase-tests` | Read, Write, Edit, Bash, Glob, Grep, Task, AskUserQuestion | Generate tests for a completed phase from its summaries, context decisions, verification report and implementation |
+| `/pan:remove-phase` | Read, Write, Bash, Glob | Remove a future phase from roadmap and renumber subsequent phases |
+
+#### /pan:add-phase
+
+Add phase to end of current milestone in roadmap
+
+```text
+/pan:add-phase <description>
+```
+
+**Tools:** Read, Write, Bash  
+**Group:** Phase Management  
+**Lines:** 44
+
+#### /pan:assumptions
+
+Surface Claude's assumptions about a phase approach before planning
+
+```text
+/pan:assumptions <phase>
+```
+
+**Tools:** Read, Bash, Grep, Glob  
+**Group:** Phase Management  
+**Lines:** 82
+
+#### /pan:insert-phase
+
+Insert urgent work as decimal phase (e.g., 72.1) between existing phases
+
+```text
+/pan:insert-phase <after> <description>
+```
+
+**Tools:** Read, Write, Bash  
+**Group:** Phase Management  
+**Lines:** 33
+
+#### /pan:phase-budget
+
+Estimate context utilization and quality for the current phase
+
+```text
+/pan:phase-budget
+```
+
+**Tools:** Bash, Read  
+**Group:** Phase Management  
+**Lines:** 23
+
+#### /pan:phase-tests
+
+Generate tests for a completed phase from its summaries, context decisions, verification report and implementation
+
+```text
+/pan:phase-tests <phase> [additional instructions]
+```
+
+**Tools:** Read, Write, Edit, Bash, Glob, Grep, Task, AskUserQuestion  
+**Group:** Phase Management  
+**Lines:** 40
+
+#### /pan:remove-phase
+
+Remove a future phase from roadmap and renumber subsequent phases
+
+```text
+/pan:remove-phase <phase-number>
+```
+
+**Tools:** Read, Write, Bash, Glob  
+**Group:** Phase Management  
+**Lines:** 32
+
+---
+
+### Focus
+
+| Skill | Tools | Description |
+|-------|-------|-------------|
+| `/pan:focus-auto` | Read, Write, Edit, Bash, Grep, Glob, Agent | Continuous scan-plan-exec loop with purpose-driven categories and a layered safety harness |
+| `/pan:focus-design` | Read, Write, Edit, Bash, Grep, Glob, Agent, WebSearch, WebFetch, mcp__context7__resolve-library-id, mcp__context7__get-library-docs | Strategic 10-phase feature investigation, design, and specification pipeline |
+| `/pan:focus-docs` | Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch | Documentation audit and sync — accuracy, freshness, links, cross-consistency and structure; --sync updates stale docs after changes |
+
+#### /pan:focus-auto
+
+Continuous scan-plan-exec loop with purpose-driven categories and a layered safety harness
+
+```text
+/pan:focus-auto [--source scan|backlog] [--category CAT] [--mode MODE] [--budget N] [--max-cycles N] [--total-budget N] [--enforce-budget] [--verify-reserve F] [--continue] [--stop] [--status] [--dry-run] [--deep-review] [--parallel-research] [--parallel-verify] [--clean-seal] [--step scan|plan|exec|drift]
+```
+
+**Tools:** Read, Write, Edit, Bash, Grep, Glob, Agent  
+**Group:** Focus  
+**Lines:** 701
+
+#### /pan:focus-design
+
+Strategic 10-phase feature investigation, design, and specification pipeline
+
+```text
+/pan:focus-design <feature description> [--full | --internal | --outward | --spike] [--gate] [--audit] [--mvp]
+```
+
+**Tools:** Read, Write, Edit, Bash, Grep, Glob, Agent, WebSearch, WebFetch, mcp__context7__resolve-library-id, mcp__context7__get-library-docs  
+**Group:** Focus  
+**Lines:** 1118
+
+#### /pan:focus-docs
+
+Documentation audit and sync — accuracy, freshness, links, cross-consistency and structure; --sync updates stale docs after changes
+
+```text
+/pan:focus-docs [file|directory] [--deep] [--links] [--fix] [--all] [--score-only] [--min-score N] [--format markdown|json|checklist] | --sync [--readme | --docs | --arch | --all]
+```
+
+**Tools:** Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch  
+**Group:** Focus  
+**Lines:** 24
+
+---
+
+### Milestone
+
+| Skill | Tools | Description |
+|-------|-------|-------------|
+| `/pan:milestone-audit` | Read, Glob, Grep, Bash, Task, Write, AskUserQuestion | Audit milestone completion against original intent before archiving |
+| `/pan:milestone-done` | Read, Write, Bash | Archive completed milestone and prepare for next version |
+| `/pan:milestone-new` | Read, Write, Bash, Task, AskUserQuestion | Start a new milestone cycle — update project.md and route to requirements |
+
+#### /pan:milestone-audit
+
+Audit milestone completion against original intent before archiving
+
+```text
+/pan:milestone-audit [version] [--track <name>] [--all-tracks] [--gaps]
+```
+
+**Tools:** Read, Glob, Grep, Bash, Task, Write, AskUserQuestion  
+**Group:** Milestone  
+**Lines:** 73
+
+#### /pan:milestone-done
+
+Archive completed milestone and prepare for next version
+
+```text
+/pan:milestone-done <version> [--cleanup]
+```
+
+**Tools:** Read, Write, Bash  
+**Group:** Milestone  
+**Lines:** 154
+
+#### /pan:milestone-new
+
+Start a new milestone cycle — update project.md and route to requirements
+
+```text
+/pan:milestone-new [milestone name, e.g., 'v1.1 Notifications']
+```
+
+**Tools:** Read, Write, Bash, Task, AskUserQuestion  
+**Group:** Milestone  
+**Lines:** 47
+
+---
+
+### Milestone Lifecycle
+
+| Skill | Tools | Description |
+|-------|-------|-------------|
+| `/pan:retro` | Read, Bash, Glob, Grep | Milestone retrospective — analyze estimation accuracy, verification patterns, and common gaps |
+
+#### /pan:retro
+
+Milestone retrospective — analyze estimation accuracy, verification patterns, and common gaps
+
+```text
+/pan:retro [--write-memory] [--max N]
+```
+
+**Tools:** Read, Bash, Glob, Grep  
+**Group:** Milestone Lifecycle  
+**Lines:** 38
+
+---
+
+### Session & Progress
+
+| Skill | Tools | Description |
+|-------|-------|-------------|
+| `/pan:pause` | Read, Write, Bash | Create context handoff when pausing work mid-phase |
+| `/pan:progress` | Read, Bash, Grep, Glob, SlashCommand | Check project progress, show context, and route to next action (execute or plan) |
+| `/pan:quick` | Read, Write, Edit, Glob, Grep, Bash, Task, AskUserQuestion | Execute a quick task with PAN guarantees (atomic commits, state tracking) but skip optional agents |
+| `/pan:resume` | Read, Bash, Write, AskUserQuestion, SlashCommand | Resume work from previous session with full context restoration |
+
+#### /pan:pause
+
+Create context handoff when pausing work mid-phase
+
+```text
+/pan:pause
+```
+
+**Tools:** Read, Write, Bash  
+**Group:** Session & Progress  
+**Lines:** 80
+
+#### /pan:progress
+
+Check project progress, show context, and route to next action (execute or plan)
+
+```text
+/pan:progress
+```
+
+**Tools:** Read, Bash, Grep, Glob, SlashCommand  
+**Group:** Session & Progress  
+**Lines:** 25
+
+#### /pan:quick
+
+Execute a quick task with PAN guarantees (atomic commits, state tracking) but skip optional agents
+
+```text
+/pan:quick [--full] [--quality] [description]
+```
+
+**Tools:** Read, Write, Edit, Glob, Grep, Bash, Task, AskUserQuestion  
+**Group:** Session & Progress  
+**Lines:** 57
+
+#### /pan:resume
+
+Resume work from previous session with full context restoration
+
+```text
+/pan:resume
+```
+
+**Tools:** Read, Bash, Write, AskUserQuestion, SlashCommand  
+**Group:** Session & Progress  
+**Lines:** 99
+
+---
+
+### System
+
+| Skill | Tools | Description |
+|-------|-------|-------------|
+| `/pan:debug` | Read, Bash, Task, AskUserQuestion | Systematic debugging with persistent state across context resets |
+| `/pan:health` | Read, Bash, Write, AskUserQuestion | Diagnose planning directory health and optionally repair issues |
+| `/pan:help` | *(none)* | Show available PAN commands and usage guide |
+| `/pan:hygiene` | Read, Bash, AskUserQuestion | Scan the project for PAN version drift and stale artifacts (legacy filenames, memory bloat and stale entries, poisoned ledgers, trace debris, oversized planning files) and apply safe cleanups |
+| `/pan:patches` | Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion | Reapply local modifications after a PAN update |
+| `/pan:settings` | Read, Write, Bash, AskUserQuestion | Configure PAN workflow toggles and model profile |
+| `/pan:todo-add` | Read, Write, Bash, AskUserQuestion | Capture idea or task as todo from current conversation context |
+| `/pan:todo-check` | Read, Write, Bash, AskUserQuestion | List pending todos and select one to work on |
+| `/pan:update` | Bash, AskUserQuestion | Update PAN to latest version with changelog display |
+
+#### /pan:debug
+
+Systematic debugging with persistent state across context resets
+
+```text
+/pan:debug [issue description]
+```
+
+**Tools:** Read, Bash, Task, AskUserQuestion  
+**Group:** System  
+**Lines:** 240
+
+#### /pan:health
+
+Diagnose planning directory health and optionally repair issues
+
+```text
+/pan:health [--repair] [--standards] [--full] [--drift] [--links]
+```
+
+**Tools:** Read, Bash, Write, AskUserQuestion  
+**Group:** System  
+**Lines:** 23
+
+#### /pan:help
+
+Show available PAN commands and usage guide
+
+```text
+/pan:help
+```
+
+**Tools:** *(none)*  
+**Group:** System  
+**Lines:** 23
+
+#### /pan:hygiene
+
+Scan the project for PAN version drift and stale artifacts (legacy filenames, memory bloat and stale entries, poisoned ledgers, trace debris, oversized planning files) and apply safe cleanups
+
+```text
+/pan:hygiene [--apply] [--trace-age-days N] [--all-tracks] [--track <name>]
+```
+
+**Tools:** Read, Bash, AskUserQuestion  
+**Group:** System  
+**Lines:** 82
+
+#### /pan:patches
+
+Reapply local modifications after a PAN update
+
+```text
+/pan:patches
+```
+
+**Tools:** Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion  
+**Group:** System  
+**Lines:** 115
+
+#### /pan:settings
+
+Configure PAN workflow toggles and model profile
+
+```text
+/pan:settings [--profile <quality|balanced|budget>]
+```
+
+**Tools:** Read, Write, Bash, AskUserQuestion  
+**Group:** System  
+**Lines:** 43
+
+#### /pan:todo-add
+
+Capture idea or task as todo from current conversation context
+
+```text
+/pan:todo-add [optional description]
+```
+
+**Tools:** Read, Write, Bash, AskUserQuestion  
+**Group:** System  
+**Lines:** 48
+
+#### /pan:todo-check
+
+List pending todos and select one to work on
+
+```text
+/pan:todo-check [area filter]
+```
+
+**Tools:** Read, Write, Bash, AskUserQuestion  
+**Group:** System  
+**Lines:** 46
+
+#### /pan:update
+
+Update PAN to latest version with changelog display
+
+```text
+/pan:update
+```
+
+**Tools:** Bash, AskUserQuestion  
+**Group:** System  
+**Lines:** 38
+
+---
+
+### Army
+
+| Skill | Tools | Description |
+|-------|-------|-------------|
+| `/pan:army` | Read, Write, Edit, Bash, Grep, Glob, Agent, Task | Bot-army campaign — Mission Control (the reasoning-tier conductor) delegates a whole-project goal to squads (architecture / build / quality / release), each squad working branch-per-agent worktrees under a hard safety harness, gated by CI + a human merge, looping plan→delegate→execute→review→integrate→learn until the goal ships or a stop condition fires. |
+
+#### /pan:army
+
+Bot-army campaign — Mission Control (the reasoning-tier conductor) delegates a whole-project goal to squads (architecture / build / quality / release), each squad working branch-per-agent worktrees under a hard safety harness, gated by CI + a human merge, looping plan→delegate→execute→review→integrate→learn until the goal ships or a stop condition fires.
+
+```text
+/pan:army <goal> [--source scan|backlog] [--max-cycles N] [--total-budget N] [--enforce-budget] [--verify-reserve F] [--squads a,b,c] [--no-build-worktrees] [--push] [--clean-seal] [--schedule <cadence>] [--daily-budget N] [--dry-run] [--continue] [--stop] [--status]
+```
+
+**Tools:** Read, Write, Edit, Bash, Grep, Glob, Agent, Task  
+**Group:** Army  
+**Lines:** 200
+
+---
+
+### Observability
+
+| Skill | Tools | Description |
+|-------|-------|-------------|
+| `/pan:cost` | Read, Bash | Show token usage and estimated cost across PAN commands and agents |
+| `/pan:hud` | Read, Bash | Generate a single-page, self-contained HTML dashboard of the bot army and the project's current state |
+| `/pan:report` | Read, Bash | Generate a self-contained HTML report for one phase, or a project-level timeline index linking every phase report |
+
+#### /pan:cost
+
+Show token usage and estimated cost across PAN commands and agents
+
+```text
+/pan:cost [report|append|clear|rebuild|limits|budget] [--format json|table|chart] [--since YYYY-MM-DD] [--until YYYY-MM-DD] [--apply] [--no-main-thread]
+```
+
+**Tools:** Read, Bash  
+**Group:** Observability  
+**Lines:** 164
+
+#### /pan:hud
+
+Generate a single-page, self-contained HTML dashboard of the bot army and the project's current state
+
+```text
+/pan:hud [--out <file>] [--open] [--stdout]
+```
+
+**Tools:** Read, Bash  
+**Group:** Observability  
+**Lines:** 89
+
+#### /pan:report
+
+Generate a self-contained HTML report for one phase, or a project-level timeline index linking every phase report
+
+```text
+/pan:report phase <N> [--out <file>] [--open] [--stdout] | index [--out <file>] [--open] [--stdout] [--bundle] | all [--open]
+```
+
+**Tools:** Read, Bash  
+**Group:** Observability  
+**Lines:** 67
+
+---
+
+### Self-Improvement
+
+| Skill | Tools | Description |
+|-------|-------|-------------|
+| `/pan:experiment` | Read, Write, Edit, Bash, Grep, Glob, Agent | Manage external experiments — scaffold, run, harvest, promote findings back to PAN |
+| `/pan:learn` | Read, Bash, Glob, Grep, Task, Write, Edit | Analyze trace sessions or harvested experiments via pan-optimizer; generate ranked optimization reports |
+
+#### /pan:experiment
+
+Manage external experiments — scaffold, run, harvest, promote findings back to PAN
+
+```text
+/pan:experiment new <slug> --idea <path> [--runtime r] [--root path] [--budget n] | list [--root path] | manifest <slug> | run <slug> [--timeout sec] [--prompt text] | status <slug> | stop <slug> | harvest <slug> [--source-root path] [--force] | prune <slug> [--hard]
+```
+
+**Tools:** Read, Write, Edit, Bash, Grep, Glob, Agent  
+**Group:** Self-Improvement  
+**Lines:** 226
+
+#### /pan:learn
+
+Analyze trace sessions or harvested experiments via pan-optimizer; generate ranked optimization reports
+
+```text
+/pan:learn [--session <id> | --sessions <n> | --experiment <slug>] [--apply] | --optimize <subcommand>
+```
+
+**Tools:** Read, Bash, Glob, Grep, Task, Write, Edit  
+**Group:** Self-Improvement  
+**Lines:** 87
+
+---
+
+### Git Workflow
+
+| Skill | Tools | Description |
+|-------|-------|-------------|
+| `/pan:git` | Read, Write, Edit, Glob, Grep, Bash | Safe, phase-aware git workflow commands — commit, branch, push, status, log, stash, diff, rollback, tag, sync |
+
+#### /pan:git
+
+Safe, phase-aware git workflow commands — commit, branch, push, status, log, stash, diff, rollback, tag, sync
+
+```text
+/pan:git <subcommand> [options]
+```
+
+**Tools:** Read, Write, Edit, Glob, Grep, Bash  
+**Group:** Git Workflow  
+**Lines:** 223
+
+---
+
+### Knowledge
+
+| Skill | Tools | Description |
+|-------|-------|-------------|
+| `/pan:knowledge` | Read, Write, Bash, Grep, Glob, Task | Grounded Q&A, multi-turn design discussion, and playbook generation. Three modes in one command. |
+
+#### /pan:knowledge
+
+Grounded Q&A, multi-turn design discussion, and playbook generation. Three modes in one command.
+
+```text
+/pan:knowledge ask <question> | discuss <phase> <topic> | playbook
+```
+
+**Tools:** Read, Write, Bash, Grep, Glob, Task  
+**Group:** Knowledge  
+**Lines:** 128
+
+---
+
+### Validation
+
+| Skill | Tools | Description |
+|-------|-------|-------------|
+| `/pan:links` | Bash, Read, Grep | Validate the doc-code link graph — inline wiki-style refs, source-comment anchors, and require-code-mention contracts (ADR-0027, v3.8.0+) |
+
+#### /pan:links
+
+Validate the doc-code link graph — inline wiki-style refs, source-comment anchors, and require-code-mention contracts (ADR-0027, v3.8.0+)
+
+```text
+/pan:links [--strict] [--doc-root <path>]... [--source-root <path>]... [--raw]
+```
+
+**Tools:** Bash, Read, Grep  
+**Group:** Validation  
+**Lines:** 107
+
+---
+
+### Foresight
+
+| Skill | Tools | Description |
+|-------|-------|-------------|
+| `/pan:preview` | Read, Bash, Glob, Grep, Write, Task | Preview what will happen — phase blast radius, phase dependency graph, or milestone ETA |
+| `/pan:what-if` | Read, Write, Edit, Bash, Grep, Glob, Task | Explore a phase's alternative approach in an isolated git worktree. Replays the scenario, compares to the original plan, writes a report. |
+
+#### /pan:preview
+
+Preview what will happen — phase blast radius, phase dependency graph, or milestone ETA
+
+```text
+/pan:preview phase <N> | phases | milestone
+```
+
+**Tools:** Read, Bash, Glob, Grep, Write, Task  
+**Group:** Foresight  
+**Lines:** 113
+
+#### /pan:what-if
+
+Explore a phase's alternative approach in an isolated git worktree. Replays the scenario, compares to the original plan, writes a report.
+
+```text
+/pan:what-if <phase-number> <scenario-text>
+```
+
+**Tools:** Read, Write, Edit, Bash, Grep, Glob, Task  
+**Group:** Foresight  
+**Lines:** 145
+
+---
+
+### Review
+
+| Skill | Tools | Description |
+|-------|-------|-------------|
+| `/pan:review-deep` | Read, Write, Bash, Glob, Grep, Task | Security audit + cross-reviewer check. OWASP/STRIDE pass by pan-hardener, then pan-meta-reviewer catches what the first pass missed. Writes consolidated deep-review.md. |
+
+#### /pan:review-deep
+
+Security audit + cross-reviewer check. OWASP/STRIDE pass by pan-hardener, then pan-meta-reviewer catches what the first pass missed. Writes consolidated deep-review.md.
+
+```text
+/pan:review-deep <phase-number>
+```
+
+**Tools:** Read, Write, Bash, Glob, Grep, Task  
+**Group:** Review  
+**Lines:** 132
+
+---
+
+## Dev Skills
+
+These exist only in the PAN source repository (`.claude/commands/`) and are NOT shipped to end users.
+
+### Development Workflow
+
+| Skill | Description |
+|-------|-------------|
+| `/execplan` | /execplan — Execute Work Plan Items |
+| `/featureAI` | /featureAI - Feature Investigation, Design & Specification |
+| `/pandev` | /pandev - Structured PAN Wizard Development Workflow |
+| `/reality-check` | Full reality check of PAN Wizard — claims vs code vs deployed installs, market and runtime delta, peer comparison, optimisation review, and a sized what's-next queue |
+| `/review` | /review - Review Current Code Changes |
+| `/superplan` | /superplan — Strategic Work Plan Generator |
+
+#### /execplan
+
+/execplan — Execute Work Plan Items
+
+**Lines:** 128
+
+#### /featureAI
+
+/featureAI - Feature Investigation, Design & Specification
+
+**Lines:** 149
+
+#### /pandev
+
+/pandev - Structured PAN Wizard Development Workflow
+
+**Lines:** 128
+
+#### /reality-check
+
+Full reality check of PAN Wizard — claims vs code vs deployed installs, market and runtime delta, peer comparison, optimisation review, and a sized what's-next queue
+
+**Lines:** 446
+
+#### /review
+
+/review - Review Current Code Changes
+
+**Lines:** 38
+
+#### /superplan
+
+/superplan — Strategic Work Plan Generator
+
+**Lines:** 132
+
+---
+
+### Testing & Verification
+
+| Skill | Description |
+|-------|-------------|
+| `/auditai` | /auditai - Deep Feature Audit |
+| `/check-platform` | /check-platform - Cross-Platform Verification |
+| `/check` | /check - Verify PAN Wizard Implementations |
+| `/pantest` | /pantest - Structured Testing Workflow for PAN Wizard |
+| `/quick` | /quick - Quick Test Run |
+| `/test` | /test - Run PAN Wizard Tests |
+
+#### /auditai
+
+/auditai - Deep Feature Audit
+
+**Lines:** 92
+
+#### /check-platform
+
+/check-platform - Cross-Platform Verification
+
+**Lines:** 59
+
+#### /check
+
+/check - Verify PAN Wizard Implementations
+
+**Lines:** 97
+
+#### /pantest
+
+/pantest - Structured Testing Workflow for PAN Wizard
+
+**Lines:** 145
+
+#### /quick
+
+/quick - Quick Test Run
+
+**Lines:** 41
+
+#### /test
+
+/test - Run PAN Wizard Tests
+
+**Lines:** 96
+
+---
+
+### Documentation & Audit
+
+| Skill | Description |
+|-------|-------------|
+| `/doc-audit` | /doc-audit - Deep Document Audit |
+| `/docs` | /docs - PAN Wizard Documentation Management |
+| `/sync` | /sync - Synchronize PAN Wizard Documentation and Tracking |
+
+#### /doc-audit
+
+/doc-audit - Deep Document Audit
+
+**Lines:** 256
+
+#### /docs
+
+/docs - PAN Wizard Documentation Management
+
+**Lines:** 82
+
+#### /sync
+
+/sync - Synchronize PAN Wizard Documentation and Tracking
+
+**Lines:** 83
+
+---
+
+### Build & Deploy
+
+| Skill | Description |
+|-------|-------------|
+| `/build` | /build - Build PAN Wizard Hooks |
+| `/commit` | /commit - Create Git Commit with Safety Checks |
+| `/run` | /run - Test PAN Wizard Installer |
+
+#### /build
+
+/build - Build PAN Wizard Hooks
+
+**Lines:** 48
+
+#### /commit
+
+/commit - Create Git Commit with Safety Checks
+
+**Lines:** 100
+
+#### /run
+
+/run - Test PAN Wizard Installer
+
+**Lines:** 63
+
+---
+
+### Session Management
+
+| Skill | Description |
+|-------|-------------|
+| `/session-end` | End a PAN Wizard development session by verifying state and preserving context |
+| `/session-start` | Start a PAN Wizard development session by loading project context and checking status |
+
+#### /session-end
+
+End a PAN Wizard development session by verifying state and preserving context
+
+**Lines:** 113
+
+#### /session-start
+
+Start a PAN Wizard development session by loading project context and checking status
+
+**Lines:** 91
+
+---
+
+### Other
+
+| Skill | Description |
+|-------|-------------|
+| `/audit-deployment` | Audit a PAN Wizard deployment — verify installation integrity, project health, and draft enhancement specs |
+| `/evolve-prompt` | Guarded prompt evolution (program S4) — evolve one section of one PAN judge prompt against training scenarios, accept it only on held-out data, with a deletion arm always run. Development only; paid. |
+| `/investigate` | Analyse something you bring (a news dump, article, paper, changelog, release notes — file path or pasted text) against PAN Wizard's existing features and write ADD / ENHANCE feature write-ups into docs/specs/investigations/ |
+| `/market-ideas` | Market idea scan for PAN Wizard — what shipped in the agent-tooling market (host tools, direct peers, new entrants, standards) since the last scan, triaged against the code and the ideas ledger into adopt / adapt / watch / skip, with a sized queue |
+
+#### /audit-deployment
+
+Audit a PAN Wizard deployment — verify installation integrity, project health, and draft enhancement specs
+
+**Lines:** 385
+
+#### /evolve-prompt
+
+Guarded prompt evolution (program S4) — evolve one section of one PAN judge prompt against training scenarios, accept it only on held-out data, with a deletion arm always run. Development only; paid.
+
+**Lines:** 38
+
+#### /investigate
+
+Analyse something you bring (a news dump, article, paper, changelog, release notes — file path or pasted text) against PAN Wizard's existing features and write ADD / ENHANCE feature write-ups into docs/specs/investigations/
+
+**Lines:** 236
+
+#### /market-ideas
+
+Market idea scan for PAN Wizard — what shipped in the agent-tooling market (host tools, direct peers, new entrants, standards) since the last scan, triaged against the code and the ideas ledger into adopt / adapt / watch / skip, with a sized queue
+
+**Lines:** 224
+
+---
+
+## Tool Access Matrix
+
+Which tools each shipped skill can use:
+
+| Skill | Read | Write | Edit | Bash | Grep | Glob | Agent | Task | TodoWrite | AskUser | SlashCmd | WebSearch | WebFetch | mcp |
+|-------|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
+| add-phase | x | x |  | x |  |  |  |  |  |  |  |  |  |  |
+| army | x | x | x | x | x | x | x | x |  |  |  |  |  |  |
+| assumptions | x |  |  | x | x | x |  |  |  |  |  |  |  |  |
+| autodev | x |  |  | x |  |  |  |  |  |  |  |  |  |  |
+| cost | x |  |  | x |  |  |  |  |  |  |  |  |  |  |
+| debug | x |  |  | x |  |  |  | x |  | x |  |  |  |  |
+| design-phase | x | x |  | x | x | x |  | x |  |  |  |  | x | x |
+| discuss-phase | x | x |  | x | x | x |  | x |  | x |  |  |  |  |
+| exec-phase | x | x | x | x | x | x |  | x | x | x |  |  |  |  |
+| experiment | x | x | x | x | x | x | x |  |  |  |  |  |  |  |
+| focus-auto | x | x | x | x | x | x | x |  |  |  |  |  |  |  |
+| focus-design | x | x | x | x | x | x | x |  |  |  |  | x | x | x |
+| focus-docs | x | x | x | x | x | x | x |  |  |  |  |  | x |  |
+| git | x | x | x | x | x | x |  |  |  |  |  |  |  |  |
+| health | x | x |  | x |  |  |  |  |  | x |  |  |  |  |
+| help |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| hud | x |  |  | x |  |  |  |  |  |  |  |  |  |  |
+| hygiene | x |  |  | x |  |  |  |  |  | x |  |  |  |  |
+| insert-phase | x | x |  | x |  |  |  |  |  |  |  |  |  |  |
+| knowledge | x | x |  | x | x | x |  | x |  |  |  |  |  |  |
+| learn | x | x | x | x | x | x |  | x |  |  |  |  |  |  |
+| links | x |  |  | x | x |  |  |  |  |  |  |  |  |  |
+| map-codebase | x | x |  | x | x | x |  | x |  |  |  |  |  |  |
+| milestone-audit | x | x |  | x | x | x |  | x |  | x |  |  |  |  |
+| milestone-done | x | x |  | x |  |  |  |  |  |  |  |  |  |  |
+| milestone-new | x | x |  | x |  |  |  | x |  | x |  |  |  |  |
+| new-project | x | x |  | x |  |  |  | x |  | x |  |  |  |  |
+| patches | x | x | x | x | x | x |  |  |  | x |  |  |  |  |
+| pause | x | x |  | x |  |  |  |  |  |  |  |  |  |  |
+| phase-budget | x |  |  | x |  |  |  |  |  |  |  |  |  |  |
+| phase-tests | x | x | x | x | x | x |  | x |  | x |  |  |  |  |
+| plan-phase | x | x |  | x | x | x |  | x |  |  |  |  | x | x |
+| preview | x | x |  | x | x | x |  | x |  |  |  |  |  |  |
+| progress | x |  |  | x | x | x |  |  |  |  | x |  |  |  |
+| quick | x | x | x | x | x | x |  | x |  | x |  |  |  |  |
+| remove-phase | x | x |  | x |  | x |  |  |  |  |  |  |  |  |
+| report | x |  |  | x |  |  |  |  |  |  |  |  |  |  |
+| resume | x | x |  | x |  |  |  |  |  | x | x |  |  |  |
+| retro | x |  |  | x | x | x |  |  |  |  |  |  |  |  |
+| review-deep | x | x |  | x | x | x |  | x |  |  |  |  |  |  |
+| settings | x | x |  | x |  |  |  |  |  | x |  |  |  |  |
+| todo-add | x | x |  | x |  |  |  |  |  | x |  |  |  |  |
+| todo-check | x | x |  | x |  |  |  |  |  | x |  |  |  |  |
+| update |  |  |  | x |  |  |  |  |  | x |  |  |  |  |
+| verify-phase | x | x | x | x | x | x |  | x |  |  |  |  |  |  |
+| what-if | x | x | x | x | x | x |  | x |  |  |  |  |  |  |
+
+---
+
+## Quick Reference — Common Workflows
+
+| Scenario | Skill sequence |
+|----------|---------------|
+| Greenfield project | `new-project` > `discuss-phase` > `plan-phase` > `exec-phase` > `verify-phase` |
+| Brownfield project | `map-codebase` > `new-project` > `discuss-phase` > `plan-phase` > `exec-phase` > `verify-phase` |
+| Quick bug fix | `quick` |
+| Substantial ad-hoc work | `quick --full` |
+| Start of day | `progress` > `resume` |
+| End of day | `pause` |
+| New version cycle | `milestone-done` > `milestone-new` |
+| Automated from PRD | `new-project --auto @prd.md` > `plan-phase --auto` > `exec-phase` > `verify-phase` |
+| Continuous improvement | `focus-auto --category <cat>` |
+| Execute micro-prompts | `focus-auto --category prompts` |
+| Feature investigation | `focus-design "description"` |
+| Doc hygiene | `focus-auto --step drift` or `focus-docs` |