Skip to content

The AFK Flow ​

afk's four-step flow takes you from unclear intent to a verified, shipped change. Each skill works standalone: run them in sequence for a feature, grab one on its own, or use /afk:ship to drive the planning-through-verdict loop automatically.

The AFK flow — grill → implement → simplify → qa, with batch as the parallel fan-out.

The whole loop, hands-free

/afk:ship drives every box above to a verdict: planning when needed, simplifying when useful, and calling reflect at the end to persist learnings back to the brain.

grill ​

grill interviews you about the plan one decision at a time. It reads the codebase, your domain glossary (brain/context.md), ADRs (brain/decisions/), and the brain's principles before asking anything, so it only asks questions the repo cannot answer. If map-codebase has already mapped the area into brain/codebase/, grill reads that map as observed ground and scopes its own reading to the gaps. It stress-tests decisions with concrete scenarios, edge cases, and failure modes, then writes the agreed plan to brain/plans/<slug>.md. That plan is the input to implement.

implement ​

implement is the gate before any file editing. It triages complexity: test-free work (docs, config, a one-liner) stays in the main conversation; everything else routes through the implement-orchestrator, a read-only Opus agent that decides architecture, contracts, and slice boundaries, which then fans the work out to bounded Sonnet implementation-worker agents running local TDD slices. Each worker writes the failing test first, makes the smallest passing change, and reports evidence.

simplify ​

simplify runs four independent cleanup agents in parallel, each reviewing the diff from one angle: reuse, simplification, efficiency, and altitude. It deduplicates their findings and applies only fixes that preserve intended behavior. This is not a correctness review; it improves quality without hunting for bugs.

qa ​

qa proves whether the intended user or client can complete the changed flow. It routes by project shape: browser QA with direct screenshots and console checks for frontend, contract-level API or CLI verification for backend, both for hybrids. It ends with a SHIP, DO NOT SHIP, or SHIP WITH CAVEATS verdict backed by direct evidence, not just "tests pass". qa is the closer for the single-diff implement path: ship stops at this verdict, and batch opens its own PRs.

batch ​

batch is the fan-out alternative to implement for plans that split into many independently-mergeable units. It runs one parallel worktree worker per unit, each opening its own PR. Use batch when you want parallel PRs rather than a single integrated change.

ship ​

ship drives the whole loop to a verdict. It plans when needed, implements, simplifies when useful, runs afk:review as a quality gate between simplify and qa, QA-checks behavior, and ends with a ship/no-ship decision. Ship also calls reflect at the end to persist session learnings back to the brain vault.