planreview

Review implementation and migration plans for fragile assumptions and residual risks.

55|10|Updated May 15, 2026
One-click install
npx skills add https://github.com/noho/code-is-cheap --skill planreview
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: planreview
Source: https://github.com/noho/code-is-cheap/tree/main/skills/planreview
Command: npx skills add https://github.com/noho/code-is-cheap --skill planreview

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It reduces the risk of sending a weak or unsafe plan to an implementation agent by actively hunting for evidence gaps, hidden assumptions, invalid scope/sequence, and residual failure modes.

Core Features & Use Cases

  • Adversarial plan challenge: Stress-tests implementation plans, migration phase plans, feature slice plans, and Gateflow handoff plans with a “don’t assume it’s safe” posture.
  • Evidence-first findings: Produces actionable, evidence-based findings that focus on what can go wrong and how to fix or verify it.
  • Structured review artifacts: Writes a timestamped review report into docs/reviews/ following the required naming and content rules, with a final conclusion of pass / pass-with-risks / fail.

Quick Start

Provide your plan text or a plan file path and ask the agent to review it adversarially.

Frequently Asked Questions about planreview

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

FAQPage Schema
How do I review an implementation plan for hidden risks before coding starts?▼

You can conduct an adversarial plan review to stress-test implementation plans, hunting for evidence gaps, hidden assumptions, and residual failure modes before coding starts. This process generates a structured review artifact with a final pass, pass-with-risks, or fail conclusion.

What is adversarial analysis for migration planning?▼

Adversarial analysis for migration planning applies a 'don't assume it's safe' posture to challenge fragile assumptions, incorrect sequencing, and scope gaps. It produces evidence-based findings that separate true blockers from deferred risks in migration phase plans.

How do I validate architecture boundaries and state-machine designs in a feature slice plan?▼

To validate architecture boundaries and state-machine designs in a feature slice plan, you perform an evidence-based assessment. This actively checks for incorrect sequencing, concurrency and recovery issues, and schema or storage risks, generating actionable findings for what can go wrong.

Can I use an adversarial review for Gateflow handoff plans and public contract designs?▼

Yes, adversarial reviews are designed to validate Gateflow handoff plans and public contract designs. The review process identifies residual risks and scope gaps, outputting a timestamped report into docs/reviews to ensure the handoff is safe for implementation.

What is the best way to document residual risks and evidence gaps in plan reviews?▼

The best way to document residual risks and evidence gaps is by generating a structured plan review artifact in docs/reviews. This artifact records evidence-based findings and concludes with a final pass, pass-with-risks, or fail status to clearly communicate implementation readiness.

When should I not use an adversarial plan review?▼

You should not use an adversarial plan review if your plan lacks sufficient detail for evidence-based assessment, or if you need a simple syntax check rather than a deep analysis of state-machine, concurrency, schema, and architecture boundary risks.