return-to-caller.md
33 lines · skills/ce-work/references/return-to-caller.md at 3449230
Most marks come from matching words in the file, so treat them as pointers.
Return to Caller
Read this when input triage enters Return-to-Caller Mode, and read it again immediately before returning. Input triage owns and validates the invocation grammar (references/input-triage.md parses the mode token and carriers). This file defines every field of the summary you return, the evidence rule for status: complete, how a repeated run recovers without reimplementing, and the standalone work you must not do here: simplify, review, PR, CI, and babysitting.
In this mode ce-work performs implementation and local verification only — including mid-implementation Phase 2 "Simplify as You Go" — then returns a structured summary instead of running the standalone shipping tail (final simplify, review, PR, CI). It still makes the canonical commit for each completed unit, as Phase 2 directs; the caller commits only what remains. When the plan ships as several PRs, build every unit on one branch anyway; the caller splits the work into PRs, so references/multi-pr-delivery.md does not apply here. The summary is the last thing this mode writes. It ends this skill, not the turn. The caller runs in this same session, and its next step follows the summary.
Return:
status:complete,blocked, orfailedplan_pathchanged_filesu_ids_attemptedu_ids_completedverification_resultsverification_evidence: one entry per attempted behavior-bearing unit, plus any non-behavioral unit where tests were intentionally skipped. Each entry states the unit/task,behavior_changed,existing_tests_inspected,tests_added_or_changed, tests used unchanged, red failure or characterization observed when applicable, verification commands/results, and any exception reason. For units executed by subagents, this entry is assembled from each worker's returned evidence, not reconstructed from the diff — the red-before-implementation observation exists only in the worker's report.implementation_engine_binding: the resolved one-runmode,target,model, andsource, ornullwhen native execution was selected without a bindingrequested_routeandactual_route: target plus harness/intermediary identity, kept separate when fallback or same-family substitution occurredrequested_modelandactual_model: the model that was requested and the model identity the route's receipt reports as served (unverifiedwhen the route supplies no trustworthy receipt)requested_effort: the reasoning effort requested for the external worker, ornullwhen none was requested or execution was nativefallback_reason:nullwhen none, otherwise the observed route-unavailable or substitution reasonrun_id: durable external run identifier, ornullfor native executionsource_kindandsource_digest: what the controller recorded as the implementation source (planplus its digest in Return-to-Caller Mode; standalone bare-prompt runs useprompt)unit_receipts: route, model, detached-process, integration, verification, canonical-commit, and cleanup state for each attempted unitplan_checkpoint: the disclosed checkpoint commit when the selected plan was the only canonical dirt, otherwisenullblockersrecovery_path: the run/workspace location the controller preserved and checked, when recovery remains; otherwisenullsettled_decision_conflicts: conflicts withsession-settled:-labeled KTDs or Key Decisions encountered during implementation — each entry names the labeled entry, the evidence, and how it was routed (proceeded-and-flagged vs blocker); empty when nonebehavior_change: whether behavior-bearing code changedstandalone_shipping_skipped: true
Return status: complete only when behavior-bearing work has verification evidence or a deliberate exception. Before returning it, re-open the plan and re-check its active units, Verification Contract, and Definition of Done against the diff, because context may have been compacted to a summary that dropped detail. Remove code left over from approaches that did not pan out. If a previous return-to-caller run implemented code but omitted evidence, a later same-plan return-to-caller run should use the idempotency check to inspect the existing work, complete the evidence, and return without reimplementing.
Engine selection (references/execution-engines.md) still applies in this mode, but only for implementation. Whichever engine runs must not open a PR, run the standalone shipping steps, or skip the checks the caller controls.