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.