review-plan

Review code plans with multiple critic agents for architectural and risk flaws.

1|Updated Dec 8, 2025

Search Tags:#planning #architecture #quality assurance #code review #swift #adversarial

Ready to run

npx skills add https://github.com/adamayoung/popcorn --skill review-plan-adamayoung

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: review-plan
Source: https://github.com/adamayoung/popcorn/tree/main/.claude/skills/review-plan
Command: npx skills add https://github.com/adamayoung/popcorn --skill review-plan-adamayoung

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill prevents the implementation of flawed, over-engineered, or risky development plans by subjecting them to rigorous, multi-perspective adversarial critique before any code is written.

Core Features & Use Cases

Adversarial Review: Employs three independent critic agents to hunt for architectural gaps, security risks, and scope creep.
Consensus Reconciliation: Automatically merges findings into a single, actionable feedback report.
Use Case: Before starting a complex feature implementation, use this Skill to identify potential Swift 6.2 concurrency issues, missing test coverage, or architectural violations in your proposed plan.

Quick Start

Invoke the review-plan skill to critique the current implementation plan for the new search feature.

Frequently Asked Questions about review-plan

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

FAQPage Schema

How do I perform an adversarial code review on a software architecture plan?▼

Adversarial code review is performed using multiple specialized critic agents to hunt for architectural gaps, security risks, and scope creep before any code is written. The agents run in parallel and merge findings into an actionable feedback report.

What is the best way to identify architectural flaws and scope creep before coding?▼

The best way to identify architectural flaws and scope creep is through adversarial plan review, which subjects development plans to rigorous multi-perspective critique. This process validates high-assurance planning by automatically reconciling feedback into a single report.

Can I use adversarial plan review to check for Swift concurrency issues in my implementation plan?▼

Yes, you can use adversarial plan review to check for Swift concurrency issues. The critique process specifically targets potential Swift 6.2 concurrency issues, missing test coverage, and architectural violations in your proposed development plan.

How do I stress-test a development plan for a complex feature implementation?▼

You stress-test a development plan by applying adversarial review techniques that simulate multiple independent critics. This orchestration requires the Workflow tool to execute agents in parallel and validate findings against schemas before reconciling them.

Do I need the Workflow tool to orchestrate multi-agent code plan reviews?▼

Yes, you need the Workflow tool to orchestrate multi-agent code plan reviews. The adversarial review process relies on the Workflow tool to execute parallel agent runs and perform schema-validated feedback reconciliation.

When should I not use adversarial plan critique for my software development workflow?▼

You should not use adversarial plan critique for simple tasks, as it is designed for complex software development workflows requiring high-assurance planning and validation. It prevents over-engineering by rigorously validating plans before implementation begins.