kovaflow makes the discipline the path of least resistance: no code before a task exists, states walk in order and never skip, and you keep one task in progress at a time. It opens the task, advances it a single legal step at a time, and hands you the branch/commit names so git history stays tied to the board.
export KOVANEX_ADDR=127.0.0.1:9090
bash start.sh <project_id> "add rate limiter" "token bucket on the gateway" feature 2
# started #239 (in_progress)
# branch: KX-239-add-rate-limiter
# commits: KX-239: <description>Creates the task, walks it backlog → todo → in_progress, warns if
something is already in progress, and prints the names to use. Set
PREFIX for other projects (TR, KI, …).
bash advance.sh <task_id> review # in_progress → review
bash advance.sh <task_id> done # review → done
bash advance.sh <task_id> done # from in_progress → REFUSED (can't skip review)It reads the current state and moves only to the immediate next one. Ask it to skip a step and it refuses — that's the guard that keeps the board honest.
bash wip.sh <project_id> # lists everything in_progress — should be oneA bug found mid-task is a new backlog task, not an inline fix:
kovanex-ctl tasks create … bug 2, then come back to it later.
Unpack into your agent's skills folder:
tar xzf kovaflow.tar.gz -C ~/.claude/skills/ — then set KOVANEX_ADDR and run /kovaflow.
Source →
skills/kovaflow/ in the public mirror (SKILL.md · start.sh · advance.sh · wip.sh · README.md)