kami-verify-gates

Diagnoses and fixes RED verify gates in the kami-kakushi pre-commit and CI roster.

1|Updated Jun 29, 2026
One-click install
npx skills add https://github.com/Raynos/kami-kakushi --skill kami-verify-gates-raynos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kami-verify-gates
Source: https://github.com/Raynos/kami-kakushi/tree/main/.claude/skills/kami-verify-gates
Command: npx skills add https://github.com/Raynos/kami-kakushi --skill kami-verify-gates-raynos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When pnpm run verify (or a pre-commit, pre-push, or CI run) goes RED in the kami-kakushi repository, developers need to know what that specific gate checks, why it exists, and the sanctioned fix — without guessing or bypassing quality gates. ## Core Features & Use Cases - Gate-by-gate fix book: Covers all 21 roster gates (tsgo, oxlint, oxfmt, vitest, gen-docs, fixtures, gen-narrative, gen-prd-regions, checkpoint, verify-content, verify-prd, verify-changelog, md-links, milestone-integrity, pacing, playcheck, doc-budgets, inbox-ledger, review-link, deferred-work, human-todo) with the exact regen or repair command for each. - Lane mechanics guidance: Explains SKIP_CODE_VERIFY / SKIP_DOCS_VERIFY / VERIFY_FULL scoping, the 8-second commit budget, and which pre-commit checks are NOT roster gates. - Meta-rules enforcement: Codifies invariants like "regen, don't hand-edit", "never widen a threshold to go green", and "don't fight someone else's red" in a shared working tree. - Use Case: A commit is blocked because gen-docs reports t0-content.md is stale; the skill directs you to run pnpm run gen:docs and commit the regenerated output with the triggering change. ## Quick Start Ask the assistant to diagnose why the verify gate went RED and give the sanctioned fix for the failing gate.

Frequently Asked Questions about kami-verify-gates

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix a RED verify gate in a pre-commit hook?

Read the gate's own output first, since most REDs name the exact fix command or file. Re-run just that gate using its command from src/scripts/gates.ts, then apply the gate-specific fix such as a regen command or registry edit.

How do I fix a stale generated file error like gen-docs or fixtures?

Run the named regeneration command, such as pnpm run gen:docs or pnpm run fixtures:regen, and commit the regenerated artifact together with the change that staled it. Never hand-edit generated files, since byte-compare gates will RED again.

What is the difference between SKIP_CODE_VERIFY and SKIP_DOCS_VERIFY?

Each gate has a scope of code, docs, or both; SKIP_CODE_VERIFY=1 skips code-scoped gates and SKIP_DOCS_VERIFY=1 skips docs-scoped gates. Pre-push force-unsets both flags and sets VERIFY_FULL=1, so pushes always run the full roster.

Why did my commit get blocked by the 8 second budget?

The commit lane hard-blocks runs over 8 seconds per ADR-176. If your new test pushed the gate past budget, tag it with a top-of-file // @slow pragma so it runs only in the push and CI lane, never use SKIP_BUDGET.

When should I bless the playcheck baseline?

Bless only when the slowdown is the intended effect of a design change the human has already accepted via an ADR or closed item. Run pnpm run playcheck -- --bless, commit the baseline with the change, and name the accepting record; never bless to get a change accepted.

What should I do when a verify failure is caused by a co-agent's changes?

Gates read the working tree, not HEAD, so a co-agent's uncommitted edits can red your run. Verify against committed canon with git show HEAD:<path>, leave your commit local, and never SKIP_VERIFY a red tree onto main.