plan-review

Reviews plan files using three parallel subagent reviewers with technical, strategic, and risk lenses.

Updated Apr 9, 2014
One-click install
npx skills add https://github.com/thoroc/thoroc.github.io --skill plan-review-thoroc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan-review
Source: https://github.com/thoroc/thoroc.github.io/tree/main/.agents/skills/plan-review
Command: npx skills add https://github.com/thoroc/thoroc.github.io --skill plan-review-thoroc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Single-reviewer plan audits normalize blind spots and miss critical issues. This Skill runs three independent subagent reviewers over .context/plans/*.md files, each with a distinct lens, and consolidates their divergent findings into one actionable report. ## Core Features & Use Cases - Multi-Perspective Review: Spawns Technical (feasibility, gaps), Strategic (scope, alignment, priority), and Risk (blind spots, failure modes) subagents in parallel against one shared self-contained plan brief. - Structural Validation: Checks plan frontmatter against a JSON schema and infers body-section conventions from existing plans, plus analyzes phases, tasks, and parallelization waves. - Model Routing Guidance: Detects the environment (OpenCode Zen, OpenCode Go, native Anthropic CLI, or BYOK) and asks the user which models to assign per reviewer for perspective diversity. - Finding Resolution: Classifies every finding as Editorial (applied directly) or Decision (resolved via a one-question interview recorded in a ## Decisions section, triggering adr-capture). - Use Case: Before marking a draft implementation plan ACTIVE, run the audit to catch missing rollback paths, sequencing errors, and unstated assumptions across three independent viewpoints. ## Quick Start Ask the agent to review the plan at .context/plans/<name>.md and answer the model-selection question when prompted.

Frequently Asked Questions about plan-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review an implementation plan with multiple AI reviewers?▼

Point the skill at a plan file in .context/plans/ and it composes a self-contained brief, then spawns Technical, Strategic, and Risk subagents in parallel. Each reviewer answers role-specific questions and the main agent consolidates their findings into one report.

How do I assign different models to subagent reviewers in OpenCode?▼

Configure subAgents in opencode.json, mapping the general type to a strong reasoning model and the explore type to a different model family. The skill checks this config first and asks you to choose models only if none are configured.

When should I not use a multi-agent plan review?▼

Skip it for trivially small plans such as a one-paragraph note with no steps, since three subagents add unjustified overhead. Also avoid it for files outside .context/plans/ or when you only want a quick informal opinion.

What happens if one reviewer subagent fails or times out?▼

The failed reviewer is re-spawned once with the identical brief. If it fails again, the review proceeds with the remaining two perspectives and the final report explicitly discloses the missing viewpoint rather than fabricating findings.

Does the plan review modify the plan file after reporting findings?▼

Yes. Editorial findings with one clearly correct fix are applied directly to the plan, while genuine tradeoffs trigger a one-question interview and are recorded in a ## Decisions section, which then requires running adr-capture.