diff --git a/README.md b/README.md index a6fa317..339dfcd 100644 --- a/README.md +++ b/README.md @@ -112,6 +112,33 @@ Profile resolution lives in `_primitives/MANIFEST.toml` — one `[primitive. **Re-install disclaimer:** `install.sh` is idempotent for clean state but **overwrites kit-owned `_blocks/`, `_primitives/`, `_bridges/`, `_templates/`, `_assembler/`, `hooks/`, and `skills/` on re-run** — local modifications under those directories are backed up to `.bak-TIMESTAMP/` (or, for shared hook files, to `.bak-TIMESTAMP`). User-owned `_manifests/*.toml` are never overwritten. +## Runtime hook controls + +Every kit-shipped hook (v0.14.2+) honours two env vars so you can silence noise or isolate a failure without editing `~/.claude/settings.json`: + +- `KEI_DISABLED_HOOKS` — comma- or space-list of hook base names (no `.sh`), e.g. `KEI_DISABLED_HOOKS=site-wysiwyd-check,milestone-commit-hook`. The literal `all` disables every hook. +- `KEI_HOOK_PROFILE` — one of `full` (default), `advisory-off`, `minimal`, `off`. + +| Profile | What stays on | +|---|---| +| `full` (default) | Every hook | +| `advisory-off` | Disables pure-stderr advisories (`recurrence-suggest`, `citation-verify`, `error-spike-detector`, `milestone-commit-hook`). Safety gates stay on. | +| `minimal` | Only safety-critical: `no-github-push`, `genesis-leak-guard`, `no-hand-edit-agents`, `secrets-guard`, `assemble-validate`, `git-pre-commit-genesis`. Everything else off. | +| `off` | Every hook off — escape hatch for debugging hook interactions. | + +```bash +# One-session disable of a single noisy hook: +export KEI_DISABLED_HOOKS=site-wysiwyd-check + +# Permanent quieter profile (paste into ~/.zshrc / ~/.bashrc): +export KEI_HOOK_PROFILE=advisory-off + +# Full re-enable: +unset KEI_DISABLED_HOOKS KEI_HOOK_PROFILE +``` + +Interactive wizard: run `/hooks-control` — click-only picker that shows current state and emits the `export` / `unset` command for you to paste. The skill never executes anything itself. + ## What you get | Category | Count | Examples | @@ -127,6 +154,8 @@ Profile resolution lives in `_primitives/MANIFEST.toml` — one `[primitive.