flow

Guides projects through 11 gated stages from idea to deployed URL using a deterministic shell checker.

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/MathematicGuy/team-006-vin20k --skill flow-mathematicguy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: flow
Source: https://github.com/MathematicGuy/team-006-vin20k/tree/main/.claude/skills/flow
Command: npx skills add https://github.com/MathematicGuy/team-006-vin20k --skill flow-mathematicguy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It prevents teams from skipping critical planning and verification steps when building software, enforcing evidence-based gates at every stage from idea to deployment so nothing ships on vibes or unchecked boxes. ## Core Features & Use Cases - Gated stage progression: Walks a project through 11 stages (idea, research, scope, PRD, ADR, contract, cards) where each gate must pass deterministic checks before the next unlocks. - Two operating modes: Teach mode makes learners write every artifact themselves; work mode interviews the operator once, drafts the stages, and pauses only at scope sign-off. - Autonomous build driver: The /flow auto command runs a preflight check, then dispatches one subagent per card with dependency-aware parallel grouping, world-state evidence requirements, and a resumable AUTO-LOG.md. - Use Case: A solo founder with a SaaS idea runs /flow next to unlock stage 00, fills the idea template, and the gatekeeper refuses to advance until the research stage contains real evidence with named first-10-users channels. ## Quick Start Ask the assistant to run /flow status to see where your project stands and what is blocking the next gate.

Frequently Asked Questions about flow

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

FAQPage Schema
How do I run the buildflow gatekeeper on my project?▼

Invoke /flow with a subcommand such as status, next, card, or check C-NNN. The runner script flow.sh performs deterministic checks on your flow/ and cards/ markdown files, and the assistant adds qualitative review on top of the script output.

What is the difference between teach mode and work mode?▼

Teach mode requires the user to write every artifact while the gatekeeper refuses hollow work. Work mode interviews the operator once, drafts stages 00-05 itself, and pauses only at the scope gate for sign-off. Gates and rubric are identical in both.

How does /flow auto build cards autonomously?▼

It runs a preflight check that planning is complete and every card is well-formed with a deps line, then dispatches one subagent per card using parallel-safe groups from flow.sh ready. The planner reviews diffs, runs verify steps, and logs events to AUTO-LOG.md.

Why does /flow next refuse to unlock the next stage?▼

The gate fails when the current stage file has unchecked boxes in its Gate section or leftover [FILL] placeholders. Fix the listed items in the stage file, or the assistant may also block advancement over hollow content, fake evidence, or impact inflation.

What counts as done evidence for a build card?▼

Done means world-state evidence pasted into the card's Evidence section, such as a clickable deployed URL or curlable endpoint. Tests passing, code merged, or local-only screenshots do not qualify for cards with a deployable surface.

Can I edit the flow.sh script or templates for my project?▼

No. Editing _templates/ or flow.sh per project is forbidden. Improvement ideas go into FLOW-FEEDBACK.md via the /flow retro protocol and are carried upstream to the buildflow template repo for adoption or rejection.