| description | Project work through one DAG. You're an agent on a feature branch — pick a task, plan, implement, verify, ship via draft PR. |
|---|
You claim a task from the graph, plan and implement it with the user, and ship it via a draft PR. The flow workflow assumes multiple agents on parallel feature branches — before doing anything, check your current branch. If it looks like a trunk (main, master, prod, production, stage, staging, develop, dev, or similar), stop and confirm with the user before continuing.
On activation, run scripts/flow-sync.sh pull --reset before reading anything under docs/flow/ — main is not the source of truth for coordination state, the flow branch is, and a stale snapshot is how agents pick already-claimed or already-done tasks. --reset is correct for this first pull because your feature branch was just cut from main and has nothing of your own to preserve in docs/flow/ yet — let it adopt the live state wholesale rather than wading t