Agent skill

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

Stars 567
Forks 40

Install this agent skill to your Project

npx add-skill https://github.com/gmickel/flow-next/tree/main/plugins/flow/skills/flow-work

SKILL.md

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

Expand your agent's capabilities with these related and highly-rated skills.

gmickel/flow-next

flow-next-impl-review

John Carmack-level implementation review via RepoPrompt or Codex. Use when reviewing code changes, PRs, or implementations. Triggers on /flow-next:impl-review.

567 40
Explore
gmickel/flow-next

flow-next

Manage .flow/ tasks and epics. Triggers: 'show me my tasks', 'list epics', 'what tasks are there', 'add a task', 'create task', 'what's ready', 'task status', 'show fn-1-add-oauth'. NOT for /flow-next:plan or /flow-next:work.

567 40
Explore
gmickel/flow-next

flow-next-plan

Create structured build plans from feature requests or Flow IDs. Use when planning features or designing implementation. Triggers on /flow-next:plan with text descriptions or Flow IDs (fn-1-add-oauth, fn-1-add-oauth.2, or legacy fn-1, fn-1.2, fn-1-xxx, fn-1-xxx.2).

567 40
Explore
gmickel/flow-next

flow-next-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.

567 40
Explore
gmickel/flow-next

flow-next-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.

567 40
Explore
gmickel/flow-next

flow-next-deps

Show epic dependency graph and execution order. Use when asking 'what's blocking what', 'execution order', 'dependency graph', 'what order should epics run', 'critical path', 'which epics can run in parallel'.

567 40
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results