flow_update
Update a flow's state through defined stages and submit required deliverables (implementation plan, agent summary) for transitions to approval or review.
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 |
|---|---|---|---|
| flowId | Yes | The flow ID to update | |
| currentState | No | New state for the flow | |
| 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) | |
| acceptanceCriteria | No | List of acceptance criteria | |
| implementationPlan | No | Markdown content of the implementation plan (required for approval state) | |
| agentSummary | No | Agent summary after implementation (required for review state) | |
| testingInstructions | No | Instructions for user testing (required for review state). Include what to test, expected behavior, and edge cases. | |
| 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). | |
| branchName | No | Git branch name for this flow (required at strictness 4+ when git is enabled) | |
| prUrl | No | GitHub PR URL for this flow | |
| prNumber | No | GitHub PR number for this flow | |
| prState | No | GitHub PR state | |
| selfApproved | No | DF-292 — set to true to claim this transition under 'agent_with_discipline' policy. Must be combined with disciplineTokens. | |
| 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. |