| name | task-deliver |
| description | task-deliver workflow v3 — Stage ③.d 子任务交付 sub-workflow (ralph-loop COMPLETE
wrapper + Agent Teams conditional escalation + R20.10 explicit max_iterations_exceeded
fallback)。2-phase composition: 01-deliver (ralph-loop SDK wrapper with completion_promise
verbatim "COMPLETE" + parallelism judgments.parallelism-gate.ralph-loop-wrapper.fires +
fallback emit_warning_and_halt exit_code 1) → 02-progress-mark (Claude Code plugin
/plan mark subtask complete in progress.md)。
schema_version: harnessed.workflow.v3 with disciplines_applied [6] + tools_available
[ralph-loop, agent-teams-create, agent-teams-send-message, agent-teams-shutdown,
planning-with-files]. Triggered by harnessed CLI `harnessed task-deliver --task <text>`
or slash command `/task-deliver` after `harnessed setup`.
|
| trigger_phrases | ["deliver this subtask","task-deliver workflow","Stage 3 deliver","ralph-loop COMPLETE","跑 task-deliver"] |
task-deliver workflow (v3)
Overview
2-phase sub-workflow mapping the user's CLAUDE.md Stage ③.d 子任务交付 discipline
onto the harnessed runtime, fully harnessed.workflow.v3 schema (Phase v3.0-3.4 W0
T3.4.W0.9 — D-09 L0 Discipline Substrate + D-10 ralph-loop SDK wrapper + D-11 Agent
Teams 升级 5 触发 OR-chain + R20.10 explicit max_iterations_exceeded handler).
| phase | id | upstream | model | capability / args / parallelism / fallback |
|---|
| 1 | 01-deliver | ralph-loop | haiku | {{ capabilities.ralph-loop.cmd }} + args: {completion_promise: COMPLETE, max_iterations: ...} + parallelism: judgments.parallelism-gate.ralph-loop-wrapper.fires + fallback.max_iterations_exceeded.action: emit_warning_and_halt |
| 2 | 02-progress-mark | planning-with-files | haiku | {{ capabilities.planning-with-files.cmd }} / invokes: /plan / artifacts_expected: [progress.md] |
Per-phase config loads from workflows/task/deliver/workflow.yaml; engine.runRouting
spawns each phase as a sub-agent via @anthropic-ai/claude-agent-sdk 0.3.142+.
Phase 01 ralph-loop COMPLETE wrapper (R20.10 + D-10 + ADR 0011)
ralph-loop SDK wrapper 保 completion-promise verbatim string "COMPLETE" — sub-task
被认为完成的判据是子任务输出包含 verbatim "COMPLETE" string (NOT 启发式 / NOT
LLM-as-judge). Sister capabilities.yaml ralph-loop entry impl bundled-skill +
sdk_ref: src/workflow/lib/ralphLoop.ts (Phase 2.2 v0.2.0 ship)。
交互面三级偏好链 (v4.15.0 / ADR 0036): ralph-loop plugin 优先 (fail-closed 逐字匹配 +
硬 max-iterations) → 未装时 native /goal gate (Claude Code 2.1.139+ / Codex 双平台内置,
条件句写 verbatim <promise>COMPLETE</promise> + turn 上界) → /goal 亦不可用时 self-loop
兜底。SDK 路径 (ralphLoopWrap 硬上界) 不参与该链,始终 verbatim 匹配。
Parallelism — ralph-loop 正交 wrapper
parallelism: judgments.parallelism-gate.ralph-loop-wrapper.fires ref — per R20.10
- D-10, ralph-loop 是 正交 wrapper 套在 subagent-default / agent-teams-upgrade /
main-session-fallback 任 1 mode 外层 (NOT 互斥触发器, 而是
wraps: orthogonal field
in parallelism-gate.yaml L42-45). Runtime engine 评估 wrapping mode 后 spawn 相应
execution unit + 套 ralph-loop completion check。
Agent Teams conditional escalation (D-11 + agent-teams.md 5 OR-chain)
5 升级触发 (per capabilities.yaml agent-teams-create.fires_when + agent-teams.md):
teammate_send_message_needed == true — teammate 间 SendMessage 互通 (NOT fire-and-forget)subagent_context_overflow == true — subagent 撞 context 上限shared_task_list == true — 多 teammate 共享 task list 自协调opposing_hypothesis_debate == true — 对立假设辩论fullstack_three_way == true — 全栈三路协同
任 1 fire → escalate subagent fan-out → Agent Teams Pattern A/B/C。Cleanup mandatory
per agent-teams.md 防呆清单 (SendMessage shutdown_request + TeamDelete) — engine-level
wiring, NOT yaml schema scope。
R20.10 explicit max_iterations_exceeded handler (NOT silent abort)
phase.fallback.max_iterations_exceeded = {action: emit_warning_and_halt, message, exit_code: 1} — schema-enforced via FallbackMaxIterationsExceeded Type.Literal(
'emit_warning_and_halt') (workflow.ts L70-77). Sister Phase 2.4 W1.2 fallbackHandlers.ts
engine.ts wire — ralph-loop 撞 max_iterations 时 explicit emit warning + halt with
exit_code 1, NOT silent abort / continue。
Brief enforcement W0.9: ✅ ralph-loop completion_promise COMPLETE / ✅ parallelism-gate
ref / ✅ R20.10 explicit max_iterations_exceeded handler。
Phase 02 progress-mark planning-with-files (D-15 + Q-AUDIT-5a Option A)
02-progress-mark invokes Claude Code plugin slash cmd /plan to mark subtask complete
in progress.md — sister Phase 01-code progress update pattern, last call in Stage
③ task chain. Requires planning-with-files Claude Code plugin (install via
Claude Code plugin marketplace).
How to invoke
!harnessed checkpoint intent task-deliver
The banner above (when present) means this invocation is REGISTERED with the engine (an intent marker) — not yet compliant: the steps below (prompt → spawn → checkpoint complete) resolve it, and a per-turn <workflow-intent> reminder persists until they run.
The numbered sequence below is the state machine — execute it with Bash. Do NOT improvise
an equivalent flow from the Overview above: freelancing bypasses the engine (no ledger, no
evidence guard). harnessed gives you the spawn-ready prompt; YOU spawn the subagent with a
CC-native Task / Agent tool (keeps the session responsive + lets clarification round-trips reach the user).
Do NOT pipe to harnessed run task-deliver — that is the CI/headless path (in-process SDK spawn
that blocks the session inside Claude Code).
- Bash:
harnessed prompt task-deliver --task "$ARGUMENTS" --json → parse {prompt, max_iterations, model}.
- Spawn a CC-native subagent (Task / Agent tool) with that
prompt + model, wrapped in the ralph-loop plugin: /ralph-loop "<prompt>" --max-iterations <max_iterations> --completion-promise "COMPLETE". If the plugin is absent, use the native goal gate instead (Claude Code 2.1.139+ / Codex): /goal "this subtask is delivered: the subagent's final output contains verbatim <promise>COMPLETE</promise>; or stop after <max_iterations> turns" then spawn the subagent and let the goal evaluator drive re-spawns until it clears. If /goal is unavailable too, self-loop: spawn → check output for <promise>COMPLETE</promise> → re-spawn with prior output appended (up to max_iterations). Set the goal only at the leaf subtask level — /goal is single-slot per session and a nested goal overwrites the outer one.
- If the output contains
STATUS: NEEDS_CLARIFICATION + a question list: STOP, relay them verbatim via AskUserQuestion, append the answers to the spec, then re-spawn the same sub.
- On
<promise>COMPLETE</promise>: Bash harnessed checkpoint complete task-deliver --summary "<one-line>". The evidence guard runs here (fail-CLOSED): if a declared artifacts_expected file is missing it exits non-zero — re-spawn to produce it before treating the sub as done.
References
- D-09 — L0 Discipline Substrate always-on (6 disciplines)
- D-10 — ralph-loop 真接 SDK wrapper (NOT mock reference; v0.2.0 ship)
- D-11 — Agent Teams 升级 5 触发 OR-chain per bundled parallelism-gate rules
- R20.10 — ralph-loop max_iterations_exceeded explicit emit_warning_and_halt
(acceptance c "NOT silent abort"); ralph-loop 正交 wrapper wraps 3 mode
- D-02 — SKILL.md
name: bare slash cmd (task-deliver NOT task/deliver) per ADR 0030
- ADR 0011 — SDK + ralph-loop integration v0.2.0 baseline
workflows/judgments/parallelism-gate.yaml triggers.ralph-loop-wrapper +
agent-teams-upgrade + subagent-default + main-session-fallbackworkflows/capabilities.yaml — ralph-loop + agent-teams-{create,send-message,shutdown}
- planning-with-files entries
workflows/defaults.yaml — ralph_max_iterations.task-deliver.* values (T3.4.W2.2 followup)docs/WORKFLOW.md — 4-stage workflow mermaid + Stage ③ Execute 章节
