flow-plan-review

gmickel's avatarfrom gmickel

Carmack-level plan review via rp-cli context builder + chat. Use when reviewing implementation plans, architecture docs, or design specs. Triggers on mentions of plan review, design review, or architecture review.

⭐25stars🔀2forks📁View on GitHub🕐Updated Jan 3, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill facilitates high-rigor, 'Carmack-level' reviews of implementation plans, architecture documents, and design specifications. By leveraging the rp-cli context builder and RepoPrompt, it ensures that technical strategies are analyzed with deep repository awareness, helping engineering teams identify structural flaws and optimize system design before implementation begins.

Use Cases

  • Pre-implementation Strategy: Evaluate detailed technical plans to ensure they align with existing codebase patterns and architectural standards.
  • Architecture Auditing: Conduct deep-dive assessments of system design documents to identify potential scalability, security, or performance bottlenecks.
  • Context-Aware Design Critique: Use RepoPrompt to automatically gather relevant code context and dependencies for a comprehensive review of proposed software changes.
  • Technical Debt Prevention: Review refactoring plans to ensure they effectively address underlying issues without introducing new regressions.
nameflow-plan-review
descriptionCarmack-level plan review via rp-cli context builder + chat. Use when reviewing implementation plans, architecture docs, or design specs. Triggers on mentions of plan review, design review, or architecture review.

Plan Review Mode (CLI)

Conduct a John Carmack-level review of implementation plans using RepoPrompt's context builder and chat.

Role: Code Review Coordinator (NOT the reviewer) Tool: rp-cli for context building and chat delegation

Input

Arguments: #$ARGUMENTS Format: <plan-file-or-beads-id> [additional context or focus areas]

Accepts:

  • Plan file path: plans/<slug>.md
  • Beads ID(s) or title(s) directly

Example: /flow:plan-review docs/plan/auth-refactor.md focus on security and error handling

FIRST: Determine Review Mode

Check: which rp-cli >/dev/null 2>&1 If NOT available: inform user rp-cli is required for this skill.

If review mode was already chosen earlier in this conversation (e.g., user answered "2a" or "2b" during /flow:plan or /flow:work setup): → Use that mode, don't ask again.

If invoked directly without prior context, ask:

Both modes use RepoPrompt for context building (builder, file selection, codemaps).
The difference is where the review happens:

Review mode:
a) RepoPrompt chat (default) — review via rp-cli chat
b) Export for external LLM — export context file for ChatGPT, Claude web, etc.

(Reply: "a", "b", "export", or just tell me)

Wait for response. Parse naturally.

Critical Requirement

DO NOT REVIEW THE PLAN YOURSELF – you are a coordinator, not the reviewer.

Your job is to:

  1. Use rp-cli -e 'windows' to find the RepoPrompt window
  2. Use rp-cli -w <id> -e 'builder ...' to build context around the plan
  3. Use rp-cli -w <id> -e 'chat ...' to execute the review

The RepoPrompt chat conducts the actual review with full file context.

Workflow

Read workflow.md and follow each phase in order. Phases include window selection, context building, and review execution.

rp-cli Reference

Read rp-cli-reference.md for command syntax and examples.