plan: migrate /deepgrade:plan to a skill (F12)

CHANGELOG.md

@@ -2,6 +2,15 @@
 
 ## Unreleased
 
+### Changed
+- **`/deepgrade:plan` is a skill.** The 1,710-line command is now
+  `skills/plan/SKILL.md` (a 319-line router) plus one file per phase under
+  `skills/plan/phases/`, read on entry to that phase. Invocation, arguments,
+  and `status.json` are unchanged. Closes F12 (deferred since 5.0.0): a
+  single long command loses its later phases after context compaction in
+  exactly the long sessions a nine-phase workflow produces. Tests that read
+  Phase 5 content now point at `phases/phase-5-audit.md`.
+
 ### Internal
 - CR-7 (owner-ratified): the U7 compatibility-floor requirement is descoped.
   Verification is on the current Claude Code version at each release (hosted

interop.md

@@ -27,9 +27,9 @@ Format rules (the sweep depends on them):
 | docs/audit/readability/readability-report.md | plugins/deepgrade-readiness/agents/readiness-report-generator.md | plugins/deepgrade-audit/commands/codebase-audit.md, plugins/deepgrade-audit/agents/delta-scanner.md, plugins/deepgrade/skills/documentation/resources/spec-template.md |
 | docs/audit/deepgrade-report.md | plugins/deepgrade-audit/agents/deepgrade-report-generator.md | plugins/deepgrade/scripts/dg-session-start.js |
 | docs/audit/risk-assessment.md | plugins/deepgrade-audit/agents/risk-assessor.md | plugins/deepgrade/agents/plan-scaffolder.md, plugins/deepgrade/agents/plan-auditor.md, plugins/deepgrade/commands/quick-plan.md, plugins/deepgrade/skills/documentation/SKILL.md, plugins/deepgrade/skills/documentation/resources/spec-template.md |
-| docs/audit/dependency-map.md | plugins/deepgrade-audit/agents/dependency-mapper.md | plugins/deepgrade/agents/plan-scaffolder.md, plugins/deepgrade/agents/plan-auditor.md, plugins/deepgrade/commands/quick-plan.md, plugins/deepgrade/commands/plan.md, plugins/deepgrade/skills/documentation/resources/spec-template.md |
+| docs/audit/dependency-map.md | plugins/deepgrade-audit/agents/dependency-mapper.md | plugins/deepgrade/agents/plan-scaffolder.md, plugins/deepgrade/agents/plan-auditor.md, plugins/deepgrade/commands/quick-plan.md, plugins/deepgrade/skills/plan/phases/phase-7-impact-review.md, plugins/deepgrade/skills/documentation/resources/spec-template.md |
 | docs/audit/feature-inventory.md | plugins/deepgrade-audit/agents/feature-scanner.md | plugins/deepgrade/commands/quick-plan.md, plugins/deepgrade/skills/documentation/SKILL.md, plugins/deepgrade/skills/documentation/resources/spec-template.md |
-| docs/audit/integration-scan.md | plugins/deepgrade-audit/agents/integration-scanner.md | plugins/deepgrade/agents/plan-auditor.md, plugins/deepgrade/commands/quick-plan.md, plugins/deepgrade/commands/plan.md, plugins/deepgrade/skills/documentation/resources/spec-template.md |
+| docs/audit/integration-scan.md | plugins/deepgrade-audit/agents/integration-scanner.md | plugins/deepgrade/agents/plan-auditor.md, plugins/deepgrade/commands/quick-plan.md, plugins/deepgrade/skills/plan/phases/phase-7-impact-review.md, plugins/deepgrade/skills/documentation/resources/spec-template.md |
 | docs/audit/audit-progress.md | plugins/deepgrade-audit/commands/codebase-audit.md | plugins/deepgrade-readiness/agents/baseline-scanner.md |
 
 ## The readability-score.json schema

plugins/deepgrade/GUIDE.md

@@ -2,7 +2,7 @@
 
 # DeepGrade Knowledge Guide v7.1.0
 
-**9 Commands**  •  **2 Agents**  •  **3 Skills**  •  **3 Safety Hooks**  •  **Requires Node.js 18+**
+**8 Commands**  •  **2 Agents**  •  **4 Skills**  •  **3 Safety Hooks**  •  **Requires Node.js 18+**
 
 [![Plugin](https://img.shields.io/badge/Claude_Code-Plugin-5A45FF?style=for-the-badge)](https://github.com/krwhynot/deepgrade)
 [![Version](https://img.shields.io/badge/v7.1.0-stable-2ECC71?style=for-the-badge)](#)
@@ -161,10 +161,12 @@ methodology reference lives in the monorepo's
 | ![p](https://img.shields.io/badge/-%E2%80%8B-9B59B6) | plan-scaffolder | Creates structured technical plans from vague objectives using 3 parallel analysts | quick-plan, plan |
 | ![p](https://img.shields.io/badge/-%E2%80%8B-9B59B6) | plan-auditor | Scores plans across 8 dimensions using parallel specialist subagents | quick-audit, plan |
 
-## The 3 Skills
+## The 4 Skills
 
 Skills are persistent knowledge that loads automatically when relevant — reference books the plugin carries in its back pocket.
 
+**plan** -- The `/deepgrade:plan` workflow itself. `SKILL.md` is a router (identity, lifecycle, workspace layout, Step 0 intent detection) and each of the nine phases lives in its own file under `phases/`, read when the phase is entered. Split this way so the later phases survive context compaction in long planning sessions instead of being silently dropped with the rest of a 1,700-line command.
+
 **documentation** -- The dispatch hub for document generation. Contains routing logic (first word = subcommand), 6 template references, smart suggestions when audit data exists, and document chain enforcement (a PRD triggers a check for a related BRD, etc.). Loads when you ask for a document, or invoke `/deepgrade:documentation` directly.
 
 

plugins/deepgrade/README.md

@@ -24,7 +24,7 @@ Verify inside a Claude Code session:
 /deepgrade:help
 ```
 
-## Commands (9)
+## Commands (8)
 
 ### Planning
 
@@ -51,7 +51,7 @@ Verify inside a Claude Code session:
 | `/deepgrade:troubleshoot` | 4-phase debugging framework with incident triage and containment |
 | `/deepgrade:help` | Show all commands and usage |
 
-`/deepgrade:documentation` is a skill surface; the other entries are command files.
+`/deepgrade:plan` and `/deepgrade:documentation` are skill surfaces; the other entries are command files.
 
 ## Safety Hooks (3)
 
@@ -92,7 +92,7 @@ present and wrong.
 ## Architecture
 
 - **2 agents** - plan-auditor (the isolated judge) and plan-scaffolder
-- **3 skills** - documentation, MCP research, self-audit knowledge
+- **4 skills** - plan (router plus one file per phase), documentation, MCP research, self-audit knowledge
 - **6 doc templates** - ADR, BRD, PRD, README, release notes, spec
 - **3 hook handlers** - `scripts/dg-*.js` plan-context layer, plus the
   `dg-canary.js` / `dg-evidence-validate.js` audit tooling invoked by `/deepgrade:plan`