subagent-rules

===SKILL:SUBAGENT_RULES=== META: TYPE::SKILL VERSION::"2.5.0" STATUS::ACTIVE PURPOSE::"Enforce oa-router delegation with anchor ceremony for all subagent Task() calls"

§1::ROUTING_RULE SCOPE::"Task()/Agent tool delegations only. External CLI dispatch (pal clink→goose/gemini/codex) is a separate mechanism — see /review §4." RULE::"ALL Task() agent delegation MUST use subagent_type:'oa-router'. NEVER call role agents directly." RATIONALE::"oa-router runs anchor ceremony providing identity, governance, context, enforcement (I5)"

§2::TEMPLATE INVOCATION::Task({ subagent_type: "oa-router", description: "{brief description}", prompt: role: {role} tier: {tier|default} topic: {context for ARM computation} BEFORE ANY WORK: Load deferred MCP tool schemas via ToolSearch if needed (see §4d), then complete the anchor ceremony. Do not read or act on the task below until you have a valid PERMIT_SID. YOUR TASK {detailed task description} SUCCESS CRITERIA {what done looks like} })

§3::TIER_SELECTION TIERS::[ micro::trivial_read_only_tasks[0_tensions,tension_bypass], quick::fast_iteration_single_constraint[1_tension], default::standard_work[2_tensions], deep::critical_decisions_production_impact[3_tensions] ]

§4::CALLER_RULES MUST::["Include anchor-first instruction in every prompt (baked into §2 template)", "Include role field (oa-router cannot bind without it)", "Store agent_id from Task() result for same-role reuse", "Use resume parameter with stored agent_id for subsequent calls to same role"] NEVER::["Skip/bypass anchor ceremony", "Pre-assign identity (e.g., 'You are an implementation-lead')", "Omit role from prompt", "Include pre-ceremony instructions that bypass binding", "Launch fresh Task() for same role when previous agent_id exists in session", "Use run_in_background:true for oa-router delegations"] BACKGROUND_RULE::[ PROHIBITION::"oa-router Task() calls MUST run in foreground (run_in_background MUST be false or omitted)", RATIONALE::"Background execution hides the anchor ceremony — multi-stage identity proofs (I5) become unauditable. Foreground shows every sub-agent action (anchor_request, file reads, anchor_lock, anchor_commit) enabling real-time verification.", PARALLEL_ALTERNATIVE::"For throughput, use multiple foreground Task() calls in a single message — Claude Code executes independent calls concurrently while preserving visibility.", DETECTION::"IF oa-router output contains 'Async agent launched successfully' THEN ceremony auditability is lost → treat as governance concern" ] INVALID_WORK::"IF subagent produces output without valid PERMIT_SID THEN work is INVALID per I5 → discard and re-delegate"

§4b::RESUME_RULE RULE::"When delegating to a role previously invoked in the same session, MUST use Task({resume: agent_id}) instead of launching fresh" RATIONALE::"Fresh launch forces full re-anchor (~50k+ tokens). Resume preserves anchor context, governance state, and loaded capabilities." PATTERN::[ FIRST_CALL::Task({subagent_type: "oa-router", prompt: "role: X ..."})→store_agent_id, SUBSEQUENT::Task({resume: stored_agent_id, prompt: "continue: ..."})→reuse_context ] EXCEPTION::"Launch fresh only when role changes OR context has fundamentally shifted (different branch, different project)"

§4c::CONTINUATION_RULE RULE::"Subagents using external tools with continuation/thread IDs (PAL continuation_id, future equivalents) MUST store and reuse the ID returned from the first call in ALL subsequent calls to the same tool within the session." RATIONALE::"Each call without continuation_id starts a fresh conversation — losing accumulated context, wasting tokens on re-explanation, and risking inconsistent responses across calls." SCOPE::[ PAL_CHAT::continuation_id[returned_in_response→pass_in_next_call], PAL_CLINK::continuation_id[same_principle], FUTURE_TOOLS::"Any tool returning a thread/session/continuation identifier" ] PATTERN::[ FIRST_CALL::mcp__pal__chat({prompt: "...", ...})→store_continuation_id_from_response, SUBSEQUENT::mcp__pal__chat({prompt: "...", continuation_id: stored_id, ...})→reuse_thread ] NEVER::["Discard continuation_id between calls to the same tool", "Start fresh PAL conversations when continuation_id is available"]