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).
Content & Writing
537 Stars
36 Forks
Updated Jan 1, 2026, 08:13 PM
Why Use This
This skill provides specialized capabilities for gmickel's codebase.
Use Cases
Developing new features in the gmickel repository
Refactoring existing code to follow gmickel standards
Understanding and working with gmickel's codebase structure
---
name: flow-work
description: 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 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](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
