New ADR
SkillAI & modelsCreate a new ADR under docs/adr/ with the next sequential number and update the index. Use whenever a technical decision is made (CLAUDE.md requires every decision to be recorded).
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the New ADR skill
What this skill tells your AI
The instructions your AI receives, as published by recomposesh/recompose in .claude/skills/new-adr/SKILL.md and read by ahel’s review.
Create an Architecture Decision Record for the decision given in the arguments.
Steps
- Find the next number:
ls docs/adr/ | grep -o '^[0-9]*' | sort -n | tail -1+ 1, zero-padded to 4 digits. - Create
docs/adr/NNNN-kebab-case-title.mdin the house format (match existing ADRs):
# ADR-NNNN: Title
**Status**: Accepted
**Date**: <today>
## Context
Why this decision was needed. 2-4 sentences, project-specific.
## Decision
What was decided. Plain and direct.
## Alternatives
- **Option**: why it was rejected.
## Consequences
**Good**: concrete benefits.
**Bad**: honest trade-offs and risks, with mitigations if any.
- Add a row to the index table in
docs/adr/README.md(keep column alignment). - Never edit an accepted ADR — supersede: new ADR references the old one, old one's Status becomes
Superseded by ADR-NNNN.
Keep it under one page. Honest cons over marketing pros.
Signals
- GitHub stars
- 27
- Last commit
- Aug 2026
Advanced
- Catalog kind
- skill
- Gateway key
new-adr-recomposesh- Source
- github.com/recomposesh/recompose