gate-check

name	gate-check
description	Run the 12 gates against a named crate and report pass/fail per gate. Use before crate admission or when verifying gate progress on an in-flight crate.
argument-hint	["crate-name"]
allowed-tools	Bash, Read, Grep

12-Gate Check — $ARGUMENTS

Run each gate sequentially on crate $ARGUMENTS. Report PASS / FAIL / N/A with a 1-line reason.

Gate 1 — SPEC

test -f docs/crate-specs/$ARGUMENTS.md && echo PASS || echo FAIL

Gate 2 — TDD (tests written first)

grep -rc -E '#\[(test|tokio::test)\]' crates/$ARGUMENTS/src 2>/dev/null | awk -F: '{s+=$2} END{print s " tests"}'

PASS if tests > 20 per 1k LOC. Check git log --oneline crates/$ARGUMENTS/ for test-first commit order.

Gate 3 — IMPL (compiles, tests pass)

cargo test -p $ARGUMENTS --lib 2>&1 | tail -5

Gate 4 — CLIPPY 0

cargo clippy -p $ARGUMENTS --all-targets -- -D warnings 2>&1 | grep -E '(error|warning)' | wc -l

PASS if output is 0.

Gate 5 — MUTATION ≥ 90 %

cargo mutants -p $ARGUMENTS --timeout 30 2>&1 | tail -5

Gate 6 — PROPERTY (proptest if parser/security/encoding)

grep -rE 'proptest!|quickcheck!' crates/$ARGUMENTS/ 2>/dev/null | wc -l

N/A if crate is pure types. Document exemption in spec.

Gate 7 — BENCHMARKS (if hot path)

test -d crates/$ARGUMENTS/benches && echo PASS || echo "N/A (not hot path)"

Gate 8 — DOCS (cargo doc 0 warnings, pub items documented)

cargo doc --no-deps -p $ARGUMENTS 2>&1 | grep -iE 'warning' | wc -l

Gate 9 — CANARY E2E

test -f tests/canary-$ARGUMENTS.nika.yaml && echo PASS || echo "N/A"

Gate 10 — PARITY LEGACY

Crate-specific. Check golden-test file against git show brouillon:… output.

Gate 11 — REVIEW SWARM

Launch 3 parallel agents. See .claude/agents/review-swarm.md.

Gate 12 — ATOMIC COMMIT

git log --oneline --grep "admit to workspace" crates/$ARGUMENTS/ | head -5

PASS = exactly 1 commit feat($ARGUMENTS): admit to workspace — all 12 gates passed, co-authored Nika 🦋.

---

After running all 12 gates, print a summary table:

Gate  Status  Detail
────  ──────  ──────────────
1     PASS    docs/crate-specs/$ARGUMENTS.md exists
2     PASS    87 tests
3     PASS    all green
...

If any FAIL → stop, report why. Do NOT proceed with admission.