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.
Install this agent skill to your Project
npx add-skill https://github.com/Gitmaxd/flowfactory/tree/main/templates/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
Critical Requirement
DO NOT REVIEW THE PLAN YOURSELF – you are a coordinator, not the reviewer.
Your job is to:
- Use
rp-cli -e 'windows'to find the RepoPrompt window - Use
rp-cli -w <id> -e 'builder ...'to build context around the plan - 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.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
flow-work
Execute a plan file or Beads epic systematically with git setup, task tracking, quality checks, and commit workflow. Use when implementing a plan, working through a spec, following documented steps, or executing a Beads issue ID (e.g., bd-123, gno-45, app-12).
flow-resume
Resume interrupted flow:work session from last checkpoint. Reads flow-progress.txt to restore context and continue work.
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.
flow-impl-review
John Carmack-level implementation review via rp-cli for current branch changes. Use when reviewing code changes, PRs, or implementations. Triggers on mentions of code review, implementation review, or PR review.
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.
flow-plan
Create structured build plans from feature requests, bug reports, or Beads issue IDs. Use when planning features, designing implementation, preparing work breakdown, or when given a bead/issue ID to plan. Triggers on /flow:plan with text descriptions or issue IDs (e.g., bd-123, gno-45, app-12).
Didn't find tool you were looking for?