plan-review

Validate markdown implementation plans with multi-agent reviews and categorized reports.

1|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/ahrav/Gossip-rs --skill plan-review-ahrav
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-review
Source: https://github.com/ahrav/Gossip-rs/tree/main/.claude/skills/plan-review
Command: npx skills add https://github.com/ahrav/Gossip-rs --skill plan-review-ahrav

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill rigorously validates markdown-based implementation plans, proactively identifying design flaws, logic gaps, complexity, and potential performance issues before development begins.

Core Features & Use Cases

  • Multi-Agent Review: Employs specialist agents (correctness, footguns, simplification, performance) to review plans from different perspectives.
  • Synthesized Report: Merges findings into a consolidated, actionable report categorized as RETHINK, REVISE, or WATCH.
  • Use Case: After a /design-tournament selects an approach, use /plan-review on the resulting markdown plan to ensure it's robust and efficient before writing any code.

Quick Start

Use the plan-review skill to validate the plan located at path/to/plan.md.

Frequently Asked Questions about plan-review

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

FAQPage Schema
How do I validate a software implementation plan before writing code?

To validate an implementation plan before coding, use a multi-agent review process to analyze markdown plan text and codebase context. This identifies design flaws, logic errors, and performance concerns, synthesizing findings into an actionable report categorized by RETHINK, REVISE, or WATCH.

What is the best way to review a markdown design document for logic gaps?

Reviewing a markdown design document for logic gaps is best handled by specialist AI agents that assess correctness, footguns, and simplification opportunities. They merge findings into a consolidated report to ensure plan robustness and efficiency before development begins.

How do I assess performance risks in a software development plan?

Assess performance risks in a development plan by employing specialist agents to evaluate the plan text alongside codebase context and scope charters. This proactive risk assessment identifies potential performance issues and complexity before implementation starts.

Can I use automated plan validation for any markdown implementation plan?

Automated plan validation can be used on any markdown implementation plan. It analyzes the plan text, codebase context, and scope charters to proactively identify design flaws, logic gaps, and potential performance issues before development begins.

When do I need to perform a plan review in the software development lifecycle?

You need to perform a plan review after selecting an implementation approach but before writing any code. This ensures the resulting markdown plan is robust and efficient, preventing design flaws and logic errors from reaching the development phase.