Flow

plan

Planning

Plan a new scenario on the plan/next-gen Memory branch. Researches the codebase, designs the component graph, and writes all graph objects.

agent session requires key
Branch
plan/next-gen
Verify
flow verify --key <key>
Skill
flow-plan-scenario

implement

Implementation

Implement a planned scenario end-to-end: writes code bottom-up (migration → SQL → service → API → UI), verifies against the graph, and opens a PR.

agent session requires key needs workspace
Branch
scenario/<key>
Verify
gh pr list --head scenario/<key>
Skill
flow-implement-scenario

audit

Quality

Run a constitution audit on a scenario and all its components, checking required properties, key naming conventions, and planning-phase patterns.

agent session requires key
Branch
(repo root)
Verify
flow audit --key <key> --force

bugfix

Implementation

Fix a bug described in a GitHub issue. Creates a fix/<key> branch, commits the fix, and opens a PR against master.

agent session requires key needs workspace
Branch
fix/<key>
Verify
gh pr list --head fix/<key>
Auto-trigger
GitHub issue opened with label "bug"

improvement

Planning

Plan a new scenario for a product improvement described in a GitHub issue. Works on the plan/next-gen branch — does not write any code.

agent session requires key
Branch
plan/next-gen
Verify
flow verify --key <key>
Skill
flow-plan-scenario
Auto-trigger
GitHub issue opened with label "improvement" or "enhancement"

test

Local

Run a suite of local environment checks (git repo present, branch readable, working tree clean) without launching an agent session.

local run
Verify
N/A (local only)

review

Quality

Custom job type.

agent session requires key