delegation-templates

Delegation Prompt Templates

Fill every {blank}. Delete a line only if truly inapplicable — never skip the ACCEPTANCE or REPORT sections. A delegation without objective acceptance criteria is a guess you outsourced.

REFERENCES (optional, prefer when they exist): paths to code, tests, rubrics, or HTML/specs that DEFINE done — a rich reference beats prose restating it. Add a REFERENCES: line to any template below when the task has one.

For non-trivial work, add these filled lines before ACCEPTANCE:

BUDGET: {max turns/time/tokens}. Stop at {stop condition}; escalate on {escalation condition}. EXCLUDED PATHS: {attempted or ruled-out approaches + evidence}. MAIN VERIFICATION: {fresh evidence the delegator must reproduce before accepting done}. NESTED: allowed — only when the subagent must dispatch its own subagents; without it the gate denies nested dispatch (W42-12).

Common footer — include in EVERY delegation:

REPORT: return ONLY short conclusion bullets + file:line per claim + verification evidence if you changed anything. Long artifacts → write to {artifact_path} and return the path. Do not paste file contents or logs. If you cannot meet an acceptance criterion, say which one and why — do not fake it. On work over 15 minutes, send one progress line (done, next, blocker) at each finished item or every 15 minutes, through SendMessage or the worker channel; silence is not progress.

{artifact_path} is a filesystem path YOU choose and fill in before sending — never a field name to harvest on. For a tmux worker the result contract is status, summary, artifacts, errors, and the payload sits under .body; result wait-required --fields status,summary,artifact_path left two finished workers unharvested for ~24 minutes on 2026-09-08. Ask for the produced file as .body.artifacts.

1. SEARCH / LOCATE (cheapest capable tier; read-only agent type if available)

GOAL: Find {what} in {repo/dir}. This will be used to {why}.
SCOPE: Look in {paths/globs}; also consider {alternative naming/conventions}.
ACCEPTANCE:
- Every match listed as file:line with a one-line role description.
- Explicitly state "no other occurrences" only after checking {N} naming variants: {variants}.
- Zero-result duty: before reporting zero matches, prove each search pattern works on a known positive (or synthetic sample); an unproven zero = UNCONFIRMED, not zero.
NON-GOALS: Do not review quality, do not propose fixes.

2. IMPLEMENT (default worker tier)

3. REFACTOR (default worker tier)

4. RESEARCH (default worker tier)

5. REVIEW / VERIFY (when judgment-rubrics §2 calls for a fresh verifier; stronger tier when the change is risky; NEVER the author)

Dispatch shape A — in-process subagent (Agent tool)

Parallelize independent delegations in one message. Wait for results before dispatching anything that depends on them.

Dispatch shape B — tmux worker (agent-tmux )

When the delegate is a tmux worker, ADD these lines to the filled template (they replace nothing — the common footer still applies):

Do not spawn additional tmux sessions or delegate further. WORKER_ARTIFACT: {absolute path} — write your findings to this file. When done, write the structured completion (result.json contract, schema_version 1) to {absolute result path} — do not rely on $TMUX_AGENT_RESULT inside tool sandboxes. Put the REPORT bullets in its summary field. If the dispatcher gives an overall deadline, write that valid result at least 120 seconds before it; an artifact without it remains UNCONFIRMED.

Embed BOTH paths literally, resolved before dispatch (agent-tmux <cli> result --path <name> computes the result path without starting anything). Do not write "the path injected into this prompt": prefix injection is best-effort and CAN be dropped during CLI boot — on 2026-08-30 agy submitted from # GOAL alone, never learned its result path, and its pending was therefore permanent.

Dispatch shape C — supervision proxy brief (typed contract)

Only for a Claude session WITHOUT the tmux-agent mod (with it, dispatch via mcp__tmux-agent__assign; no proxy). The subagent that HOSTS the one assign --detach gets this brief verbatim. It is a fixed schema, not prose; check-bol-prompt.sh validates the three declared fields and nothing else.

This schema is COMPLETE verbatim: no common footer, no tmux addendum, nothing after the REPORT block (the addendum belongs in the worker packet, shape B). The REPORT block is FIXED — any edit is denied, including "return the worker's answer verbatim", which §4 forbids the proxy from doing and which is anyway unsatisfiable while result.json is pending (the 2026-08-30 incident). Findings flow WORKER → WORKER_ARTIFACT → parent, never through the proxy. Known ceiling: an UNMARKED brief bypasses this gate entirely (deliberate — the alternative denies runbook, review, and debugging briefs that merely quote an assign command). Rule text is the ceiling there.

Write the filled template to a prompt file and pass its path to assign — never interpolate raw task text into the command line. assign owns start, submission, supervision, canonical-result validation, and stop; do not hand-chain them. Ownership boundaries: this skill owns the prompt body (templates + footers + addendum). The dispatch shapes above are illustrative carriers showing where the filled prompt lands — the authoritative rules for deciding WHETHER to delegate, constructing invocations, and supervising workers after launch live in the using-tmux-agent-tools and tmux-agent-tools skills, and are not restated here.