Menu
Create a new Architecture Decision Record (ADR) for a proposed feature or design change.
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
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.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/im9/inboil --skill adrThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Based on SOC occupation classification
Showing SKILL.md
| name | adr |
| description | Create a new Architecture Decision Record (ADR) for a proposed feature or design change. |
| argument-hint | <title> |
| allowed-tools | Read, Glob, Grep, Bash(ls *), Write |
Create a new ADR document for: $ARGUMENTS
Determine next ADR number: List docs/ai/adr/ to find the highest existing number, then increment by 1.
Research the topic: Before writing, explore the codebase to understand the current state of the relevant area. Read related files, check existing ADR documents for context, and identify what currently exists vs what's missing.
Write the ADR at docs/ai/adr/{NNN}-{slug}.md using this format:
# ADR {NNN}: {Title}
## Status: Proposed
## Context
{Why is this needed? What's the current situation? What problems exist?}
## Decision
{The proposed design. Include:}
- Architecture / structure
- UI layout (ASCII diagrams if helpful)
- State management approach
- Implementation details
- Mobile considerations
## Considerations
{Trade-offs, open questions, alternative approaches considered}
## Future Extensions
{What could be built on top of this later}