Context
During the review of PR #11178 (which automates the active PR cycle state extraction into sandman_handoff.md), the swarm requested narrowing the scope. AC4 (boot-time pre-flight) and AC5 (hard-refusal predicate) were deferred to ensure the base extraction logic could be merged quickly without introducing complex new boot constraints simultaneously.
The Problem
While sandman_handoff.md now contains the active PR cycle state, nightshift agents do not automatically enforce behavior based on this state upon booting. Without a boot-time pre-flight and hard-refusal predicate, an agent could pick up a new task or open a new PR while a parallel PR is still waiting on peer review, risking duplicate PRs or collision.
The Architectural Reality
The runSandman pipeline now reliably deposits the GoldenPath and PR metadata into resources/content/sandman_handoff.md.
The agent's boot sequence (likely integrated into the Mailbox Check Protocol AGENTS.md §22 or a new Pre-Flight step) must be updated to consume this artifact and evaluate the lane-state string.
The Fix
- Implement a Boot-Time Pre-Flight step that parses
resources/content/sandman_handoff.md.
- Implement a Hard-Refusal Predicate: If the
lane-state is AWAITING_REVIEW, AWAITING_HUMAN, or similar blocked state, the agent must halt execution of any new ticket intake or PR creation until the blocking state is resolved (or explicitly overridden by the operator).
Acceptance Criteria
Out of Scope
- Generation of the
sandman_handoff.md file itself (handled by PR #11178).
Origin Session ID: 57502eb2-7f7b-4b9b-a849-49f016b08c95
Context During the review of PR #11178 (which automates the active PR cycle state extraction into
sandman_handoff.md), the swarm requested narrowing the scope. AC4 (boot-time pre-flight) and AC5 (hard-refusal predicate) were deferred to ensure the base extraction logic could be merged quickly without introducing complex new boot constraints simultaneously.The Problem While
sandman_handoff.mdnow contains the active PR cycle state, nightshift agents do not automatically enforce behavior based on this state upon booting. Without a boot-time pre-flight and hard-refusal predicate, an agent could pick up a new task or open a new PR while a parallel PR is still waiting on peer review, risking duplicate PRs or collision.The Architectural Reality The
runSandmanpipeline now reliably deposits theGoldenPathand PR metadata intoresources/content/sandman_handoff.md. The agent's boot sequence (likely integrated into the Mailbox Check ProtocolAGENTS.md§22 or a new Pre-Flight step) must be updated to consume this artifact and evaluate thelane-statestring.The Fix
resources/content/sandman_handoff.md.lane-stateisAWAITING_REVIEW,AWAITING_HUMAN, or similar blocked state, the agent must halt execution of any new ticket intake or PR creation until the blocking state is resolved (or explicitly overridden by the operator).Acceptance Criteria
sandman_handoff.mdprior to executing any workflow skills.lane-stateis detected, halting new task execution.Out of Scope
sandman_handoff.mdfile itself (handled by PR #11178).Origin Session ID: 57502eb2-7f7b-4b9b-a849-49f016b08c95