القائمة
Run canonical session-start gates (HEAD pin, working tree clean, settings.local.json baseRef, bd lint parse) with machine-parseable output for linter consumption.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Close a bd issue with structured rationale, evidence-path verification, worktree-owner lifecycle enforcement, and post-close verification. Idempotent.
Assemble a bdClosureAttestation JSON object (bd-close evidence shape — issueId/head/timestamp/evidenceBundle/evidencePaths/rationaleHash). This is DISTINCT from the canonical ADR-016 §6 closureAttestation (post-sign-off-correction) shape; see amnesia-pdqi.
Resolve P1 references per-class (Cerberus-aggregate; no halt-on-first) — invoke tools/validate-refs.sh to validate file_path / commit_sha / bd_id / adr_anchor / memory_binding citations against their named targets via the 5 per-class adapters at tools/role_schema/adapters/refs/. Returns full inventory of {resolved, violations, warnings}; exit 1 on any block-severity (STALE/NOT_FOUND/AMBIGUOUS for non-warn classes), exit 0 on all RESOLVED OR only warn-severity (bd_id STALE; memory ACTIVE_PENDING_CODIFICATION) per ADR-017 §2.4 + AC
Assemble a canonical role identity (P3 adapter per ADR-017 §2.1 Layer 3) for a dispatch — resolve a role name against the canonical roster (Directive
Manage halt-condition state across a dispatch lifecycle (ARMED → CHECKED → FIRED → ATTESTED) per ADR-017 §2.4 — arm halts pre-flight via tools/halt-arm.sh (Task 3.2), query/fire mid-dispatch via tools/halt-check.sh (Task 3.3 TBD).
Validate a dispatch contract YAML against ADR-017 §2.2 canonical packet shape + P4 structural + P3 role-canonical + P1 reference resolution; emit conformance diagnostic for pre-launch gating.
| name | preflight-verify |
| description | Run canonical session-start gates (HEAD pin, working tree clean, settings.local.json baseRef, bd lint parse) with machine-parseable output for linter consumption. |
At session start before opening any non-trivial work; before issuing any agent dispatch; before any commit-on-main. The four checks together establish the baseline environmental contract that downstream tools assume.
Invokes tools/preflight-verify.sh to run four canonical gates (HEAD pin, working tree porcelain, .claude/settings.local.json worktree.baseRef presence, bd lint --json parse) and returns a single aggregated JSON object describing each check's pass/fail state. The output shape is documented in the script header as the o4fp.2 GSOM linter extensibility contract.
tools/preflight-verify.sh--check <head|tree|settings|bd-lint|all> (default all)--expected-head <sha> (optional; pin HEAD to a known SHA)--json (machine-readable output){
"checks": [
{"name": "head", "pass": true, "actual": "<sha>", "expected": "<sha-or-empty>"},
{"name": "tree", "pass": true, "actual": "", "expected": ""},
{"name": "settings", "pass": true, "actual": "<baseRef>", "expected": "<non-MISSING>"},
{"name": "bd-lint", "pass": true, "actual": "total=<n>", "expected": "parses"}
],
"all_pass": true
}
all_pass is true; 1 if any check fails.tools/preflight-verify.sh --check all --json
tools/preflight-verify.sh --check head --expected-head 62aaf6842da1b0fd614dd0b9303f93ee0f2da022 --json
head check fails (HEAD missing or mismatched against --expected-head) — blocking; halt + surface the actual SHA.tree check fails (working tree dirty) — blocking; halt + surface the porcelain output.settings check fails (file missing, JSON unparseable, or worktree.baseRef MISSING) — warning-class; surface but do not block routine engineering work.bd-lint check fails (cannot parse bd lint --json) — warning-class; surface and continue.amnesia-o4fp.2 GSOM linter: downstream consumer of the schema; this primitive's output is one input source.tools/divergence-report.sh (HEAD vs remote drift), tools/bundle-extract.sh (post-dispatch artifact extraction).