Keeps this page in sync as the body changes. Pause it any time for a quieter view.
Path /specs/unified-agent-cli-flow-patch-on-fail
Last refresh never
Unified Agent CLI Flow: All Task Types, Patch on Verification Fail
inventory_source local | spec_api /api/spec-registry/unified-agent-cli-flow-patch-on-fail | registry_updated 2026-04-09T03:10:09.047758Z
potential_value 0.00 | actual_value 1.00 | value_gap 0.00
estimated_cost 0.00 | actual_cost 1.00 | cost_gap 1.00
estimated_roi 0.00 | actual_roi 1.00
Missing contributor linkage. Submit a change request with contributor attribution.
Open process view for this spec
task_ids -
branches -
source_files specs/agent-execution-lifecycle-hooks.md, specs/unified-agent-cli-flow-patch-on-fail.md
evidence_refs -
Open implementation view for this spec
implementation_refs spec-registry:agent-execution-lifecycle-hooks, spec-registry:unified-agent-cli-flow-patch-on-fail
lineage_ids -
public_endpoints -
summary Ensure every agent provider CLI (aider/claude, cursor, openclaw) can run the full delivery flow locally and remotely: generate spec from idea, implement a spec, run tests, review implementation against spec verification, and—when verification fails—produce enough structured information to create a patch so the next step can fix the implementation without discarding work. Optionally improve the spec’s Verification section when the verification step is ambiguous or wrong.
process_summary Every executor (`claude`, `cursor`, `codex`, `gemini`) supports `spec`, `impl`, `test`, `review`, and `heal` task types ; The flow executes end-to-end (`idea -> spec -> impl -> test -> review`) for local and remote runner modes with no task-t; `review` failure output includes structured `VERIFICATION_RESULT`, `FILES_TO_CHANGE`, and `PATCH_GUIDANCE` blocks that c; On failed review, pipeline context carries patch guidance forward to the next `impl`/`heal` task without destructive tru; Review may emit `SPEC_VERIFICATION_IMPROVEMENT` when verification steps are ambiguous, so spec verification can be tight
pseudocode_summary -
implementation_summary api/scripts/run_cli_task_flow_matrix.py (unified CLI flow, PASS_FAIL contract); api/scripts/local_runner.py (local CLI execution)