| name | Plan Review |
| version | 2.0.0 |
| description | Multi-perspective plan review with VP Product, VP Engineering, and VP Design. Use when reviewing implementation plans, design docs, architecture proposals, or wave plans for blockers, anti-patterns, conflicts, and regressions. |
| category | orchestration |
| tags | ["plan-review-skill","multi-perspective","risk-assessment","stakeholder-review","approval-workflow"] |
| author | smith-horn |
| triggers | {"keywords":["review this plan","check the plan","plan review","review my plan","assess this plan","evaluate the plan","stakeholder review","VP review","executive review"],"explicit":["/plan-review-skill"]} |
| tools | ["Read","Task"] |
Plan Review
Multi-perspective plan review with VP Product, VP Engineering, and VP Design to identify blockers, anti-patterns, conflicts, and regressions.
Execution
When triggered, immediately:
- Read
agent-prompt.md from this skill's directory:
- User install:
~/.claude/skills/plan-review-skill/agent-prompt.md
- Project install:
.claude/skills/plan-review-skill/agent-prompt.md
- Spawn a single Task with
subagent_type: "general-purpose" passing the agent-prompt content as the prompt
- Include in the prompt: the user's request, the plan file path or content, and current working directory
- Wait for the agent to complete
- Present the agent's summary to the user
Do NOT execute the review workflow in this session. The subagent handles VP agent spawning, issue consolidation, and user interaction (AskUserQuestion). Plan edits are returned as recommendations for the coordinator to apply — the subagent should not edit files directly, as background execution auto-denies Write/Edit tools.
Execution Context Requirements
This skill spawns a general-purpose subagent that coordinates VP review agents and consolidates findings.
Foreground execution required: Yes for interactive AskUserQuestion prompts. Background execution auto-denies clarifying questions.
Dispatcher tools (frontmatter): Read, Task
Subagent tools: Read, Grep, Glob, AskUserQuestion
Write/Edit delegation: The subagent returns approved plan modifications as text. The coordinator (main conversation) applies edits via its own Edit tool. This makes the skill resilient to all permission modes.
Reference: See Claude Code documentation on subagent tool permissions.
Changelog
v2.0.0
- Refactor: Thin dispatcher pattern — full logic extracted to agent-prompt.md
- Skill runs in isolated subagent context, significantly reducing post-compaction restoration overhead
See agent-prompt.md for prior changelog entries.
