creating-adrs
Structured ADR creation in MADR format. Use when creating architecture decision records, documenting technology choices, or when user mentions ADR, Architecture Decision, 決定記録, 技術選定, アーキテクチャ決定, deprecation, 非推奨化.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
ADR Creator
6-Phase Process
| Phase | Actions |
|---|---|
| 1. Pre-Check | ls adr/*.md, check duplicates, get next number |
| 2. Template | Match keywords to template type |
| 3. References | Gather project docs, issues, external resources |
| 4. Validate | Check required sections (Title, Status, Context, Decision, Consequences) |
| 5. Index | Auto-generate adr/README.md |
| 6. Recovery | Handle missing dirs, duplicates, missing sections |
Template Selection
| Template | Use Case | Required Sections |
|---|---|---|
| technology-selection | Library, framework choices | Options (min 3), Pros/Cons |
| architecture-pattern | Structure, design policy | Context, Consequences |
| process-change | Workflow, rule changes | Before/After comparison |
| deprecation | Retiring technology | Migration plan, Timeline |
Directory Structure
adr/
├── README.md # Auto-generated index
├── 0001-*.md # Sequential numbering
└── 0002-*.md
References
| Topic | Resource |
|---|---|
| MADR | https://adr.github.io/madr/ |
| Command | ../../commands/adr.md |
| Templates | ../../templates/adr/ |
| Scripts | ./scripts/ |
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!