devflow

DevFlow

CLI-driven progressive disclosure workflow. Advance one verified step at a time.

Overview

DevFlow enforces a disciplined development process where each step must be completed and verified before advancing. It uses TOML workflow definitions, gate-based verification, and a devflow done checkpoint system.

When to Use

• Project has .devflow/workflows/*.toml files
• You see devflow commands in project docs
• Task requires writing requirements, design docs, or code in stages
• You need gate-based verification (tests must pass before advancing)

When NOT to use: Project has no .devflow/ directory — this is a standard project, use normal development.

Quick Start

devflow --help          # Verify CLI is installed

If devflow is not found, install first:

pip install agent-devflow     # From PyPI

Then start the workflow:

devflow list-workflows              # See available workflows
devflow select-workflow MODE-A      # Pick one
devflow current                     # Read current step

Core Loop (ALWAYS follow this)

1. devflow current     -> Read what to do
2. Execute the step    -> Write code, create docs, run tests
3. devflow done        -> Check gates -> advance or retry
4. Repeat until "Workflow complete!"

Core rule: Only advance through devflow done. Never skip steps. Never create files for future steps.

Commands

Command	Purpose
devflow current	Show current step instruction
devflow done	Check gates and advance
devflow back	Go back one step
devflow approve ITEM	Mark item as user-approved
devflow set KEY VALUE	Set state variable
devflow list-workflows	List available workflows
devflow select-workflow ID	Select and start a workflow
devflow run	Start autonomous Ralph Loop

Gate Types

Gates block advancement until satisfied:

• file_exists:path — File must exist
• file_contains:path:content — File must contain text
• command_success:{test_command} — Command exits 0
• user_approved:ITEM — Requires devflow approve ITEM
• state_set:var — State variable must be set