Agent skill

flow-plan-review

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.

Stars 567
Forks 40

Install this agent skill to your Project

npx add-skill https://github.com/gmickel/flow-next/tree/main/plugins/flow/skills/flow-plan-review

SKILL.md

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.

Expand your agent's capabilities with these related and highly-rated skills.

gmickel/flow-next

flow-next-impl-review

John Carmack-level implementation review via RepoPrompt or Codex. Use when reviewing code changes, PRs, or implementations. Triggers on /flow-next:impl-review.

567 40
Explore
gmickel/flow-next

flow-next

Manage .flow/ tasks and epics. Triggers: 'show me my tasks', 'list epics', 'what tasks are there', 'add a task', 'create task', 'what's ready', 'task status', 'show fn-1-add-oauth'. NOT for /flow-next:plan or /flow-next:work.

567 40
Explore
gmickel/flow-next

flow-next-plan

Create structured build plans from feature requests or Flow IDs. Use when planning features or designing implementation. Triggers on /flow-next:plan with text descriptions or Flow IDs (fn-1-add-oauth, fn-1-add-oauth.2, or legacy fn-1, fn-1.2, fn-1-xxx, fn-1-xxx.2).

567 40
Explore
gmickel/flow-next

flow-next-worktree-kit

Manage git worktrees (create/list/switch/cleanup) and copy .env files. Use for parallel feature work, isolated review, clean workspace, or when user mentions worktrees.

567 40
Explore
gmickel/flow-next

flow-next-rp-explorer

Token-efficient codebase exploration using RepoPrompt CLI. Use when user says "use rp to..." or "use repoprompt to..." followed by explore, find, understand, search, or similar actions.

567 40
Explore
gmickel/flow-next

flow-next-deps

Show epic dependency graph and execution order. Use when asking 'what's blocking what', 'execution order', 'dependency graph', 'what order should epics run', 'critical path', 'which epics can run in parallel'.

567 40
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results