smith-horn 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.mdfrom this skill's directory:- User install:
~/.claude/skills/plan-review-skill/agent-prompt.md - Project install:
.claude/skills/plan-review-skill/agent-prompt.md
- User install:
- 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.