flow-next-plan-review

Orchestrate Flow epic spec plan reviews with RepoPrompt or Codex.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill coordinates John Carmack-level plan reviews of Flow epic specs or design docs using RepoPrompt or Codex. It orchestrates the entire review lifecycle via a bundled flowctl shim, ensuring consistent prompts, checkpoints, and artifact generation.

Core Features & Use Cases

  • Backend-agnostic reviews: Works with RepoPrompt (rp) or Codex backends to review epic specs and task specs.
  • Atomic setup and augmentation: Performs a single, safe setup (setup-review) and augments the selection with epic and task specs for full context.
  • Structured review prompts: Builds and sends a comprehensive review prompt, including code-context where available.
  • Verdict handling and fixes loop: Applies NEEDS_WORK fixes automatically, syncing epic and task specs and re-reviewing until SHIP.
  • Traceability: Supports receipts and status updates to track review progress across backends.

Quick Start

  • Trigger a plan review: /flow-next:plan-review <EPIC_ID>
  • Follow the interactive prompts to select a backend and complete the review.
  • If NEEDS_WORK is returned, the skill will automatically apply fixes and re-submit the review; repeat until SHIP.

Frequently Asked Questions about flow-next-plan-review

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

FAQPage Schema
How do I automate plan reviews for epic specs using Codex or RepoPrompt?

To review Flow epic specs with RepoPrompt or Codex, trigger a setup-review that augments your selection with full task context, sends structured prompts, and handles verdicts automatically. It coordinates the entire lifecycle via a bundled flowctl shim.

What is a Carmack-level plan review workflow for epic specs?

A Carmack-level plan review workflow for epic specs is an orchestrated process that sends comprehensive review prompts with code context to a backend, handles NEEDS_WORK verdicts, and automatically applies fixes. It re-reviews until SHIP, ensuring traceability via receipts.

How do I fix NEEDS_WORK verdicts automatically during a spec review?

To fix NEEDS_WORK verdicts automatically during a spec review, the workflow applies the requested fixes, syncs your epic and task specs, and re-submits the review to the backend. This loop continues automatically until the review returns a SHIP verdict.

Does the plan review workflow support both RepoPrompt and Codex backends?

Yes, the plan review workflow supports both RepoPrompt and Codex backends. It features backend-agnostic reviews, performs automatic backend detection, and enforces single-backend usage to ensure consistent prompts and artifact generation throughout the review lifecycle.

How do I recover from context changes when reviewing task specs?

To recover from context changes when reviewing task specs, the workflow automatically detects the disruption and restores the review state. It uses a bundled flowctl shim to maintain traceability via receipts and ensures the review resumes without losing progress.