version 1.22.0

33 commands  ·  11 agents  ·  34 workflowws

floww-CLI

Install    Commands    Agents    Architecture    Changelog

Find your floww...

Goal-backward project management for Claude Code. Understands what you're building, researches what it doesn't know, plans work that can actually be executed, builds it commit by commit.

Commands

| Command | | |---------|---| | /floww | Detects project state, recommends what to do next | | /floww:help | Context-aware — "Getting Started" or "Right Now" |

| Command | | |---------|---| | /floww:new-project | Questioning, research, requirements, roadmap | | /floww:map-codebase | Analyze existing codebase with parallel agents |

| Command | | |---------|---| | /floww:discuss-phase N | Articulate vision before planning | | /floww:research-phase N | Deep ecosystem research | | /floww:list-phase-assumptions N | Surface Claude's assumptions | | /floww:plan-phase N | Create execution plans with verification |

| Command | | |---------|---| | /floww:execute-phase N | Wave-based parallel execution | | /floww:quick | One-off task with floww guarantees |

| Command | | |---------|---| | /floww:add-phase | Append phase to milestone | | /floww:insert-phase N | Insert urgent work as decimal phase | | /floww:remove-phase N | Remove and renumber |

| Command | | |---------|---| | /floww:new-milestone | Start new milestone cycle | | /floww:complete-milestone | Archive, tag, prepare next | | /floww:audit-milestone | Audit against original intent | | /floww:plan-milestone-gaps | Close audit-identified gaps |

| Command | | |---------|---| | /floww:progress | Status and routing | | /floww:stamp | Project state snapshot | | /floww:resume-work | Resume with full context | | /floww:pause-work | Create handoff file |

| Command | | |---------|---| | /floww:debug | Scientific-method debugging, persistent across /clear | | /floww:add-todo | Capture idea without losing flow | | /floww:check-todos | List and work on pending todos | | /floww:verify-work N | Conversational UAT | | /floww:add-tests N | Generate tests from UAT criteria |

| Command | | |---------|---| | /floww:settings | Workflow toggles and model profile | | /floww:set-profile tier | Switch quality / balanced / budget | | /floww:health | Diagnose planning directory | | /floww:cleanup | Archive completed phases | | /floww:update | Update with changelog preview |

floww knows whats expected...

Install

npx floww-cli-cc@latest

/floww

floww Detects your project state. Routes you to what's next.

Understands your floww...

𝒇 · Philosophy

Delegation — Structure over speed. Organization enables depth.

Structural clarity — If a phase tries to do too much, split it. Organized work produces organized code.

Proactive questioning — flowwCLI would rather slow down and ask than rush through with poor structure.

Plans before it builds...

and lets you save progress at any time

Builds with precision and purpose

Agents

| Agent | Role | |-------|------| | floww-planner | Goal-backward phase plans with task decomposition | | floww-executor | Atomic commits with deviation handling | | floww-debugger | Scientific-method debugging with persistent sessions | | floww-phase-researcher | Domain research before planning | | floww-project-researcher | Ecosystem research during initialization | | floww-research-synthesizer | Synthesizes parallel research outputs | | floww-plan-checker | Verifies plans achieve the goal | | floww-roadmapper | Maps requirements to phases | | floww-verifier | Goal-backward phase verification | | floww-codebase-mapper | 7-area codebase analysis | | floww-integration-checker | Cross-phase E2E verification |

Agents pick their Claude model based on the active profile:

| Profile | Planning | Execution | Research | Verification | |---------|----------|-----------|----------|--------------| | quality | Opus | Opus | Opus | Sonnet | | balanced | Opus | Sonnet | Sonnet | Sonnet | | budget | Sonnet | Sonnet | Haiku | Haiku |

/floww:set-profile budget

Architecture

.claude/
├── commands/floww/            33 slash commands
├── agents/                    11 specialized agents
├── settings.json              hooks + status line
└── floww-cli/
    ├── VERSION                1.22.0
    ├── bin/floww-cli.cjs      CLI utility
    ├── hooks/                 ANSI startup banner + status line
    ├── workflowws/            34 orchestration workflowws
    ├── references/            15 specs (voice, ui-brand, model profiles...)
    └── templates/             36 file templates

.planning/
├── PROJECT.md          vision and identity
├── REQUIREMENTS.md     scoped requirements with REQ-IDs
├── ROADMAP.md          phases mapped to requirements
├── STATE.md            position, decisions, metrics
├── STAMP.md            latest context snapshot
├── config.json         workflow toggles
├── research/           domain research
├── todos/              captured ideas
├── debug/              debug sessions
└── phases/
    ├── 01-foundation/
    │   ├── CONTEXT.md
    │   ├── 01-01-PLAN.md
    │   └── 01-01-SUMMARY.md
    └── ...

MIT · Built with Claude Code

floww — the visual AI workspace