From d1e1e38879a5722ab69a5924c64c939401458b03 Mon Sep 17 00:00:00 2001 From: sjat Date: Sun, 14 Jun 2026 21:27:23 +0200 Subject: [PATCH] feat(kaizen): nudge in /review-repo; STATUS + TODO Co-Authored-By: Claude Opus 4.8 (1M context) --- .claude/commands/review-repo.md | 4 ++++ STATUS.md | 1 + docs/TODO.md | 10 ++++++---- 3 files changed, 11 insertions(+), 4 deletions(-) diff --git a/.claude/commands/review-repo.md b/.claude/commands/review-repo.md index fb1c48d..1feb02d 100644 --- a/.claude/commands/review-repo.md +++ b/.claude/commands/review-repo.md @@ -33,6 +33,10 @@ ADR "Deferred/Open" entry — a checklist to confirm) and `stale-deferred` (an e another file describes as resolved but which isn't marked resolved in place — high-confidence, usually auto-fixable by marking the source ADR's entry RESOLVED). +Also run `python3 scripts/friction-scan.py --nudge` and include its one-line output in the +report's summary — it flags when the kaizen loop (`/kaizen`) is overdue (recurring signals, +backlog size, or age). This is a reminder only; do not act on `FRICTION.md` from here. + ### Phase 1 — fan-out judgement review Scale to repo size: - **Small** (≤ ~10 roles, like boma today): a few sub-agents, or one pass per area. diff --git a/STATUS.md b/STATUS.md index 14a1951..4c54b7a 100644 --- a/STATUS.md +++ b/STATUS.md @@ -20,6 +20,7 @@ _Last reviewed: 2026-06-14._ | Pre-commit hooks | Configured: lint, gitleaks, vault-encryption guard. Activate with `pre-commit install` after `make setup`. | | Vault password client | `scripts/vault-pass-client.sh` fetches the master password from Vaultwarden via `rbw` (wired as `vault_password_file`). Requires `rbw` installed + `rbw unlock`. | | `/review-repo` | Repo audit: `scripts/repo-scan.py` (Phase 0) + `.claude/commands/review-repo.md`, reports to `docs/reviews/`. On-demand only; cron + email deferred (`docs/TODO.md`). | +| `/kaizen` | Curate `docs/FRICTION.md` Open signals → decisions ledger (`scripts/friction-scan.py` Phase 0, unit-tested, + `.claude/commands/kaizen.md`). Interactive, on-demand; `--nudge` (recurrence/age/backlog) surfaces in `/review-repo`. Headless/cron deferred (TODO 11.3). | | Terraform HCL (`terraform/`) | Written (proxmox VM module + envs) — but never run; see below. Offsite env also written — see "Designed but not built". | | `docs/hardware/reference.md` + `scripts/capacity-scan.py` | Present — reference doc (skeleton until real hardware) + stdlib scan; emits capacity JSON | | `/capacity-review` | Works — on-demand capacity evaluation → `docs/hardware/reviews/`. Intent-based (no live usage yet) | diff --git a/docs/TODO.md b/docs/TODO.md index 9c78cdf..5e6c0f2 100644 --- a/docs/TODO.md +++ b/docs/TODO.md @@ -114,10 +114,12 @@ auto-install.) 11. **Kaizen loop** — set up ~2026-06-06 (one week from now). - 1. Build `/retro`: reads `docs/FRICTION.md` + recurring `/review-repo` - findings + a tooling-usage inventory; proposes add / change / **remove** - (biased to remove); records decisions as ADRs; evaluates itself. - Recurrence-triggered plus a light periodic sweep. + 1. ~~Build `/retro`~~ **DONE — built as `/kaizen`** (`scripts/friction-scan.py` + + `.claude/commands/kaizen.md`; spec `docs/superpowers/specs/2026-06-14-kaizen-command-design.md`). + Scope narrowed to **curate-only** per the 2026-06-14 spec (no auto-harvest, no + tooling-usage inventory; decision re-challenge is TODO 13, not this). Verdicts are + add / change / **park** / remove (park-with-resurrection-trigger). The `--nudge` + (recurrence/age/backlog) surfaces in `/review-repo`; headless/cron is 11.3. 2. Keep appending raw signals to `docs/FRICTION.md` (live now) until the retro consumes them. 3. **Automation deferred (revisit when the notify + cron stack is up):** the