What problem does it solve? Deferred items, interim shortcuts, and open architecture decisions get forgotten between sessions and team members when they live only in chat or gitignored scratch notes. This Skill keeps a single committed, team-visible table (docs/RISK_REGISTER.md) as the durable index of everything unresolved, with validation scripts that prevent rows from silently disappearing or becoming malformed. ## Core Features & Use Cases - Append-only row management: Add new rows with a permanent, never-reused id (last # + 1), and resolve entries by flipping Status, Date, and Decision together without touching immutable columns. - Schema and history validation: Two shell scripts enforce row shape against a JSON schema and block commits that delete previously-committed rows, wired into a pre-commit hook. - Clear boundaries: Distinguishes register-worthy risks from finalized ADRs, low-stakes tech-debt items, and ephemeral session-local scratch notes. - Use Case: While shipping a feature without a dead-letter queue, immediately file a Shortcut row with a concrete description and risk statement, run both validation scripts, and commit — so the gap survives across sessions and teammates. ## Quick Start Add a new row to docs/RISK_REGISTER.md for the shortcut we just took, then run both validation scripts to confirm they pass before committing.
