Plan-Flow: Structured AI-Assisted Development

A comprehensive skill set for AI-assisted software development with structured workflows and persistent project memory.

Available Commands

Command	Description
`/setup`	Analyze project and generate pattern files
`/discovery`	Create discovery document for requirements gathering
`/create-plan`	Create implementation plan with phases and complexity scores
`/execute-plan`	Execute plan phases with verification
`/create-contract`	Create integration contract from API docs
`/review-code`	Review local uncommitted changes
`/review-pr`	Review a Pull Request
`/write-tests`	Write tests to achieve coverage target
`/flow`	Toggle autopilot mode (auto-chains the full workflow)

Always-Active Features

Feature	Description
Project Ledger	Persistent learning journal at `flow/ledger.md` - silently captures mistakes, corrections, and project-specific knowledge across sessions

Recommended Workflow

Automated - runs without asking permission:

1. /setup           → Index project patterns (run once)
2. /discovery       → Gather requirements for a feature
3. /create-plan     → Create structured implementation plan (auto-runs after discovery)
4. /execute-plan    → Execute the plan phase by phase (auto-runs after plan)
5. /review-code     → Review changes before committing
6. Archive          → Move discovery + plan to flow/archive/

Only stop to ask the user when:

Missing critical information (device type, browser, etc.)
Need to reproduce an issue
Ambiguous requirements
Need approval for destructive actions

Never ask "Ready to create plan?" or "Proceed with execution?" - just do it.

Core Concepts

Complexity Scoring

Every plan phase has a complexity score (0-10):

Score	Level	Description
0-2	Trivial	Simple, mechanical changes
3-4	Low	Straightforward implementation
5-6	Medium	Moderate complexity, some decisions
7-8	High	Complex, multiple considerations
9-10	Very High	Significant complexity/risk

Flow Directory Structure

All artifacts are stored in flow/:

flow/
├── archive/           # Completed/abandoned plans
├── contracts/         # Integration contracts
├── discovery/         # Discovery documents
├── plans/             # Active implementation plans
├── references/        # Reference materials
├── reviewed-code/     # Code review documents
├── reviewed-pr/       # PR review documents
└── ledger.md          # Persistent project learning journal

plan-flow

Install via CLI (Recommended)