Skip to main content
Version: Next

Change-request flow

Sometimes a task is delivered and approved, then a human wants further changes — an enhancement, a UX tweak, a refinement. Rather than reopening review or filing a brand-new task, insight-flow tracks these as a change-request side-flow on the existing task.

The path

done ─request-changes─▶ changes-requested ─▶ changes-implementing ─▶ changes-implemented ─▶ git
StatusSet byMeaning
request-changes/task-request-changesA change request is being recorded.
changes-requested/task-request-changesChange(s) recorded; awaiting work.
changes-implementing/task-implement (change mode)Implementing the requested changes.
changes-implemented/task-implement (change mode)Done; hands back to /task-git.

Agents involved

  • /task-request-changes records the human's request (preserving their exact wording) and moves the task into changes-requested.
  • /task-implement runs in change mode: it implements only the recorded change requests, then sets changes-implemented.
  • /task-git takes it from there to push/PR.

CLI commands

insight-flow change-request --id Nxx --description "..."
insight-flow change-start --id Nxx
insight-flow change-end --id Nxx --files "a.ts,b.ts" --comment "..."
insight-flow next-change # pick the next change request

See the CLI: Change requests group for full flags.