flow_update
Update a flow's state or submit implementation plan, agent summary, and testing instructions to advance it through the DevFlow workflow.
Instructions
Update a flow's state or submit deliverables. Use this to:
Change flow state (idea -> planning -> approval -> ready -> in_progress -> review -> done)
Submit implementation plan for review
Submit agent summary after implementation
agentStatus is automatically derived from your tool calls - you don't need to set it manually.
IMPORTANT: Some state transitions require mandatory fields:
approval requires: implementationPlan
review requires: agentSummary AND testingInstructions
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prUrl | No | GitHub PR URL for this flow | |
| flowId | Yes | The flow ID to update | |
| commits | No | List of git commits to add to this flow. New commits are appended to existing ones. TIP: When transitioning to `review`, either include your docs commit(s) here in the same call, OR ensure you have previously registered docs commits on the flow — docsUpdate=5 will block review otherwise. For Git-Discipline 5, at least one commit must be visible on the flow (either in this call or persisted). | |
| prState | No | GitHub PR state | |
| prNumber | No | GitHub PR number for this flow | |
| branchName | No | Git branch name for this flow (required at strictness 4+ when git is enabled) | |
| agentStatus | No | Override for agent status (normally auto-derived, only set if needed) | |
| agentMessage | No | Override for agent message (normally auto-derived, only set if needed) | |
| agentSummary | No | Agent summary after implementation (required for review state) | |
| currentState | No | New state for the flow | |
| filesChanged | No | Repo-relative paths changed by this flow (e.g. from `git diff --name-only origin/main...HEAD`). Required by the adr-compliance gate on review→done when git is enabled. | |
| selfApproved | No | DF-292 — set to true to claim this transition under 'agent_with_discipline' policy. Must be combined with disciplineTokens. | |
| testStrategy | No | DF-435 — evidence for devflow-tdd/verification: how the change was tested (commands + results). | |
| acVerification | No | DF-435 — per-AC verification evidence: [{acId, status, evidence}]. | |
| disciplineTokens | No | DF-292 — signed HMAC tokens (one per required skill) returned by devflow_token_emit. Backend verifies all required tokens before allowing the transition. | |
| acceptanceCriteria | No | List of acceptance criteria | |
| implementationPlan | No | Markdown content of the implementation plan (required for approval state) | |
| planReconciliation | No | DF-435 — plan-vs-reality reconciliation: { perAcStatus: [{acId, status}, ...] }. | |
| testingInstructions | No | Instructions for user testing (required for review state). Include what to test, expected behavior, and edge cases. |