flow-plan-review

Coordinate RepoPrompt and rp-cli to review implementation plans and architecture docs.

674|52|Updated Dec 26, 2025
One-click install
npx skills add https://github.com/gmickel/gmickel-claude-marketplace --skill flow-plan-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flow-plan-review
Source: https://github.com/gmickel/gmickel-claude-marketplace/tree/main/plugins/flow/skills/flow-plan-review
Command: npx skills add https://github.com/gmickel/gmickel-claude-marketplace --skill flow-plan-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a disciplined, Carmack-level plan review workflow that coordinates a RepoPrompt context builder and rp-cli chat to audit implementation plans, architecture documentation, and design specifications.

Core Features & Use Cases

  • Structured discovery: Automatically surface relevant files, docs, and code patterns around a plan so reviewers can focus on critique rather than scavenging context.
  • Carmack-level critique: Applies rigorous criteria (simplicity, architecture, edge cases, security) to plans and designs.
  • Operational workflow: Guides through window selection, context discovery, review via RP-CLI chat, and iterative fixes, with an explicit follow-up loop.
  • Collaboration support: Enables sharing a comprehensive review prompt and selected context with stakeholders.

Quick Start

To start a review, load your plan file and initiate a review session, e.g.: /flow:plan-review plans/auth-refactor.md focus on security and error handling The skill will verify prerequisites, assemble context, and begin the Carmack-level evaluation.

Frequently Asked Questions about flow-plan-review

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

FAQPage Schema
What is a Carmack-level plan review for software architecture docs?

A Carmack-level plan review applies rigorous criteria like simplicity, architecture, edge cases, and security to evaluate implementation plans and design specifications. It audits documentation to ensure technical decisions are robust before development begins.

How do I automate code and design doc reviews using rp-cli and RepoPrompt?

You can automate design doc reviews by coordinating RepoPrompt for context building and rp-cli for chat. The workflow guides through file selection, context discovery, and iterative evaluation to produce actionable feedback on your plans.

Does plan review automation require specific dependencies to work?

Yes, automated plan review requires rp-cli and RepoPrompt access. The workflow verifies prerequisites, proper window selection, and access to supporting docs and artifacts to assemble comprehensive context for evaluation.

Can I focus an architecture review on specific concerns like security and error handling?

Yes, you can focus an architecture review on specific concerns by providing focus parameters during session initiation. The evaluation applies structured discovery to surface relevant patterns and docs around your specified focus areas.

What is the best way to share a comprehensive plan review with stakeholders?

The best way to share a plan review is by exporting the comprehensive review prompt alongside the selected context. This enables stakeholders to view the exact artifacts and critique criteria used during the evaluation session.

How does structured discovery improve implementation plan evaluation?

Structured discovery improves implementation plan evaluation by automatically surfacing relevant files, docs, and code patterns. This lets reviewers focus on critique rather than manually scavenging context, resulting in a more thorough review.