new-adr
Scaffold a new Architecture Decision Record, auto-numbered from existing ADRs
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Menu
Scaffold a new Architecture Decision Record, auto-numbered from existing ADRs
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Audit context window consumption across LOTRAOM agents, skills, rules, MCP servers, and CLAUDE.md. Report token estimates, flag bloat, recommend trims.
Hard-block Edit/Write outside a chosen directory. Use to scope-lock edits during a focused fix or refactor. Pair with /unfreeze to release.
Six-phase root-cause debugging for crashes, build failures, or "why is this broken" reports. Iron Law - no fixes without root cause. Auto-engages /freeze.
Release the directory edit lock set by /freeze. Edit and Write are unrestricted again. No-op if /freeze was never set.
Dispatch an independent Codex verification job for the current changes
Inspect all changed files, group by logical concern, and guide atomic per-concern commits
| name | new-adr |
| description | Scaffold a new Architecture Decision Record, auto-numbered from existing ADRs |
| argument-hint | ["decision-name e.g. use-event-sourcing"] |
Create a new ADR at docs/adrs/ for: $ARGUMENTS
List existing ADRs — ls docs/adrs/ to find the next number (ADR-NNN format).
Gather context — git log --oneline -10 and read last CHANGELOG [Unreleased] section.
Create the ADR at docs/adrs/ADR-NNN-$ARGUMENTS.md:
# ADR-NNN: [Title]
**Status:** Proposed
**Date:** [today's date]
## Context
[What prompted this decision?]
## Decision
[What did we decide?]
## Consequences
### Positive
- [benefit]
### Negative
- [trade-off]
## Alternatives Considered
### [Alternative 1]
- **Pros:** ...
- **Cons:** ...
- **Why rejected:** ...
## References
- [Related ADRs, commits, issues]
[Unreleased].