← ClaudeAtlas

hook-bypass-reviewlisted

Audit work/current/hook-bypass.md for stale entries, expired bypasses, and patterns suggesting a hook needs tuning
bakw00ds/yakos · ★ 2 · Code & Development · score 81
Install: claude install-skill bakw00ds/yakos
# hook-bypass-review ## Purpose Periodically audit `work/current/hook-bypass.md` for entries that should be removed (expired, completed, or never followed up) and patterns that suggest a hook is too aggressive rather than the bypass being legitimate. Invoke before `yakos archive` (so stale bypasses don't roll into the archive) and weekly during long projects. ## Scope Reads only: - `work/current/hook-bypass.md` (the active bypasses) - `work/current/logs/<hook>.ndjson` (to confirm hook fire history) Writes nothing automatically — outputs a structured report the operator reviews. ## Automated pass Walk every `## bypass:<id>` entry in the Active entries section. For each: ```markdown ### bypass:<id> - **Hook:** <hook name from the entry> - **Created:** <ts> - **Expires:** <ts> - **Status:** - **EXPIRED** (Expires has passed) — should be removed - **STALE** (Created > 7 days ago, no Follow-up activity) — review - **ACTIVE** (within Expires) — fine - **Pattern check:** has this Scope been bypassed > 2 times in the last 14 days? - If yes → suggests the underlying hook is too aggressive for this project; recommend tuning the hook rather than repeating the bypass. Cite the previous bypass entries. - **Follow-up status:** does the Follow-up field describe a concrete action that's been done? - If no → the bypass is unaccounted for; surface to operator. ``` ## Manual pass Operator reads the report. For each EXPIRED entry: remove from hook-bypass.md (or