kami-config-and-flags

Catalogs every configuration flag, escape hatch, and lever in the kami-kakushi repository.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a commit or push is blocked by a git hook or Claude hook in the kami-kakushi repo, developers need to know which escape flag (if any) is legitimate, what each SKIP_/KAMI_ variable actually does, and how to add new flags without widening the bypass surface. This Skill is the single reference catalog for every flag, env var, vite define, URL boot param, and balance-cockpit lever, each anchored to its enforcing file:line. ## Core Features & Use Cases - Escape flag catalog: Tables covering commit/push escapes (SKIP_VERIFY, SKIP_JOURNAL, SKIP_QUEUE, SKIP_ATTRIB), Claude-hook escapes (SKIP_SWEEPGUARD, SKIP_DEVGUARD, KAMI_ALLOW_MULTI_DEV), script env vars (VERIFY_FULL, UPDATE_MAP_GOLDEN, SHIP_DEV_TOOLS, QA_URL), vite defines (DEV_TOOLS, VERSION), and URL boot params (?dev, ?fixture, ?bal.<path>, ?story-<bundle>). - Ground rules and hard blocks: Documents which combinations are hard-blocked (e.g. SKIP_VERIFY=1 with git push) and which destructive git ops have no escape at all. - Add-a-flag checklist: Per-class procedures for safely introducing new gates, hook escapes, env vars, defines, URL params, and cockpit levers. - Re-derive greps: Ready-to-run grep commands to regenerate every table when the catalog drifts from the code. - Use Case: A commit is blocked by the sweep guard on git add -A; consult this Skill to learn that SKIP_SWEEPGUARD=1 is the escape, that every use is auto-logged to the sweepguard ledger, and what the legitimate case is. ## Quick Start Ask the assistant to load the kami-config-and-flags skill and explain what SKIP_CODE_VERIFY does and when it is legitimate to use.

Frequently Asked Questions about kami-config-and-flags

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

FAQPage Schema
How do I bypass a blocked git commit hook with SKIP_VERIFY?

Prefix the git command with the flag, e.g. SKIP_VERIFY=1 git commit -m ... -- <paths>. It skips the whole verify at commit and push, but combining it with git push is hard-blocked by guard-bash-safety.sh, and narrower lane flags like SKIP_CODE_VERIFY are preferred.

What does the SKIP_SWEEPGUARD environment variable do?

SKIP_SWEEPGUARD=1 escapes guard-git-add-all.sh, which blocks shared-index sweeps like git add -A or bare git commit. Every use is auto-logged to project/status/sweepguard-ledger.md and auto-committed by the post-commit hook.

How do I enable the DEV panel with URL boot parameters?

Use ?dev=yes to opt in at runtime; in dev serve the panel defaults on and ?dev=no opts out, while in prod both default off. The panel requires __DEV_TOOLS__ in the bundle, and params like ?fixture, ?bal.<path>, and ?story-<bundle> follow similar gating.

Can SKIP_VERIFY be used to push a red build to main?

No. SKIP_VERIFY=1 combined with git push is hard-blocked with exit code 2 by guard-bash-safety.sh lines 40-49. There is no sanctioned way for an agent to push a red tree; the verify failure must be fixed first.

How do I add a new configuration flag or cockpit lever?

Follow the per-class checklist in section 7: commit-gate escapes need a guard plus documented bypass block, hook escapes need env and inline text matching, and cockpit levers require five lockstep touches including BALANCE_CANON and the BALANCE_LEVERS registry.

When should I not use this flag catalog?

Do not use it for diagnosing what a specific verify gate checks (use kami-verify-gates), for save schema questions (kami-save-and-schema), or for game-state story flags, which are core state under ADR-179 rather than configuration.