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 2
Forks 0

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:

  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.

Gitmaxd/flowfactory

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).

2 0
Explore
Gitmaxd/flowfactory

flow-resume

Resume interrupted flow:work session from last checkpoint. Reads flow-progress.txt to restore context and continue work.

2 0
Explore
Gitmaxd/flowfactory

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.

2 0
Explore
Gitmaxd/flowfactory

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.

2 0
Explore
Gitmaxd/flowfactory

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.

2 0
Explore
Gitmaxd/flowfactory

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).

2 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results