Spec Preflight Gate
Use this gate before accepting or ending a spawn/dispatch turn that routes work from a spec, plan, or handoff file.
The gate is deterministic and replay-based:
bun skills/golem-powers/spec-preflight-gate/scripts/spec-preflight-gate-cli.mjs < transcript.jsonl
bun skills/golem-powers/spec-preflight-gate/scripts/spec-preflight-gate-cli.mjs fixture.json
cat transcript.jsonl | bun skills/golem-powers/spec-preflight-gate/scripts/spec-preflight-gate-cli.mjs -
Exit codes:
0 = PASS3 = FLAG2 = usage / parse error
Scope
A deterministic gate for spawn/dispatch briefs that reference spec or handoff files.
Doctrine
For spawn/dispatch briefs:
- Assert every referenced spec/handoff path exists before dispatching from it.
- Brief from grep-patterns and structural invariants, not a load-bearing exact filename.
- Keep seat identity consistent across
name, repo, launcher, and "you are ..." prompt text.
- Try user-space setup workarounds before declaring an install blocker human-only.
Evidence Rule
Clearance comes only from tool calls and tool_result outputs in the current turn:
- Dispatch calls:
spawn_agent, Task, send_to, send_to_agent, agent, and parallel.
- Spec checks: earlier
Read, cat, ls, test -f, grep, stat, or similar file probes of the exact path.
- Workarounds: visible
--appdir, ~/Applications, $HOME, shared.env, --user, --no-sudo, or user-space install paths before the blocker output.
Assistant prose can state intent, but it cannot verify a path, clear identity drift, or prove a workaround was attempted.
1---2name: spec-preflight-gate3description: Gate for briefs citing spec files. Triggers: spawn hygiene, assert-before-spawn, handoff brief, spec path preflight.4---56# Spec Preflight Gate78Use this gate before accepting or ending a spawn/dispatch turn that routes work from a spec, plan, or handoff file.910The gate is deterministic and replay-based:1112```bash13bun skills/golem-powers/spec-preflight-gate/scripts/spec-preflight-gate-cli.mjs < transcript.jsonl14bun skills/golem-powers/spec-preflight-gate/scripts/spec-preflight-gate-cli.mjs fixture.json15cat transcript.jsonl | bun skills/golem-powers/spec-preflight-gate/scripts/spec-preflight-gate-cli.mjs -16```1718Exit codes:1920- `0` = PASS21- `3` = FLAG22- `2` = usage / parse error2324## Scope2526A deterministic gate for spawn/dispatch briefs that reference spec or handoff files.2728## Doctrine2930For spawn/dispatch briefs:3132- Assert every referenced spec/handoff path exists before dispatching from it.33- Brief from grep-patterns and structural invariants, not a load-bearing exact filename.34- Keep seat identity consistent across `name`, `repo`, `launcher`, and "you are ..." prompt text.35- Try user-space setup workarounds before declaring an install blocker human-only.3637## Evidence Rule3839Clearance comes only from tool calls and tool_result outputs in the current turn:4041- Dispatch calls: `spawn_agent`, `Task`, `send_to`, `send_to_agent`, `agent`, and `parallel`.42- Spec checks: earlier `Read`, `cat`, `ls`, `test -f`, `grep`, `stat`, or similar file probes of the exact path.43- Workarounds: visible `--appdir`, `~/Applications`, `$HOME`, `shared.env`, `--user`, `--no-sudo`, or user-space install paths before the blocker output.4445Assistant prose can state intent, but it cannot verify a path, clear identity drift, or prove a workaround was attempted.
EtanHey