kiss-debt-guardlisted

# KISS — Debt Guard Reflexes slip; a guard does not. This installs the smallest useful enforcement: a script that fails when a file exceeds its size budget, so the discipline survives a tired afternoon. ## What it installs Copy from `assets/` into the target repo (default `tools/kiss/`): - `kiss-size-audit.py` — dependency-free (Python 3 stdlib) size-budget audit. - `kiss-budget.config.json` — the repo's tiers, included file types, excluded paths, and waivers. ## Install workflow 1. Copy both files into `tools/kiss/`. 2. **Baseline, don't fantasize.** Run the audit and set tiers from the repo's real distribution; record genuine over-budget files as waivers with an expiry, rather than relaxing tiers to make the first run green. 3. Add a contract line to `CLAUDE.md`/`AGENTS.md`: *"Before adding code to a file, check its size against `tools/kiss/kiss-budget.config.json`; if over the extract tier, extract first."* 4. Wire it where it runs: a pre-commit hook, a CI step, or a documented manual run per milestone. ## Running ``` python tools/kiss/kiss-size-audit.py <repo-root> ``` Exit code is non-zero if any non-waived file exceeds the **hard-stop** tier — suitable for a hook or CI gate. `--report` prints the full review/extract/hard-stop breakdown without failing. ## Bloat vs. length The audit flags by line count, but line count is a *proxy*. A flagged file that has a single responsibility and is cleanly sectioned (see `kiss-modularity`, `kiss-readable`) is legi