flow-work

gmickel's avatarfrom gmickel

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

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

When & Why to Use This Skill

The flow-work skill is a systematic execution engine for Claude agents, designed to transform structured plans or issue IDs into completed codebases. It automates the entire development lifecycle, including Git branch management, task tracking, quality assurance through testing, and a disciplined commit workflow, ensuring high-fidelity implementation of technical specifications and project epics.

Use Cases

  • Systematically implementing technical specifications from markdown plan files to ensure all architectural requirements are met without skipping steps.
  • Automating the resolution of specific project issues (e.g., Beads IDs) with integrated Git setup, branch isolation, or worktree management.
  • Enforcing code quality and project standards by integrating mandatory testing phases and 'Carmack-level' implementation reviews into the development cycle.
  • Streamlining complex software engineering tasks by following a structured, phase-based execution model that tracks progress and handles commits automatically.
nameflow-work
descriptionExecute 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 work

Execute a plan systematically. Focus on finishing.

Role: execution lead, plan fidelity first. Goal: complete every plan step in order with tests.

Input

Full request: #$ARGUMENTS

Accepts:

  • Plan file: plans/<slug>.md
  • Beads ID(s) or title(s) directly
  • Chained instructions like "then review with /flow:impl-review"

Examples:

  • /flow:work plans/oauth.md
  • /flow:work gno-40i
  • /flow:work gno-40i then review via /flow:impl-review and fix issues

If no plan/ID provided, ask for it.

FIRST: Setup Questions (REQUIRED)

Before doing anything else, output these questions as text (do NOT use AskUserQuestion tool):

Check if rp-cli available: which rp-cli >/dev/null 2>&1

If rp-cli available, ask both:

Quick setup before starting:

1. **Branch** — Where to work?
   a) Current branch
   b) New branch
   c) Isolated worktree

2. **Review** — Run Carmack-level review after?
   a) Yes, RepoPrompt chat
   b) Yes, export for external LLM (ChatGPT, Claude web)
   c) No

(Reply: "1a 2a", "current branch, export review", or just tell me naturally)

If rp-cli NOT available, ask only branch:

Quick setup: Where to work?
a) Current branch  b) New branch  c) Isolated worktree

(Reply: "a", "current", or just tell me)

Wait for response. Parse naturally — user may reply terse or ramble via voice. Do NOT read files or write code until user responds.

Workflow

After setup questions answered, read phases.md and execute each phase in order. If user chose review:

  • Option 2a: run /flow:impl-review after Phase 6, fix issues until it passes
  • Option 2b: run /flow:impl-review with export mode after Phase 6

Guardrails

  • Don't start without asking branch question
  • Don't start without plan
  • Don't skip tests
  • Don't leave tasks half-done