Structured ADR creation in MADR format. Use when: ADR, Architecture Decision, 決定記録, 技術選定, アーキテクチャ決定, deprecation, 非推奨化.
From shipnpx claudepluginhub thkt/dotclaude --plugin toolkitThis skill is limited to using the following tools:
scripts/colors.shscripts/pre-check.shscripts/update-index.shscripts/validate-adr.shscripts/validate-markdown.shProvides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
Analyzes competition with Porter's Five Forces, Blue Ocean Strategy, and positioning maps to identify differentiation opportunities and market positioning for startups and pitches.
| Phase | Actions |
|---|---|
| 1. Pre-Check | Run ./scripts/pre-check.sh "$TITLE" (uses shared scripts) |
| 2. Template | Run $HOME/.claude/scripts/select-adr-template.sh "$TITLE" |
| 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 |
Use script to auto-select template:
TEMPLATE=$("$HOME/.claude/scripts/select-adr-template.sh" "$TITLE")
| 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 |
adr/
├── README.md # Auto-generated index
├── 0001-*.md # Sequential numbering
└── 0002-*.md
| Rule | Detail |
|---|---|
| Immutability | Once accepted, never modify. To change, create a new ADR that supersedes it |
| Brevity | Target ~80 lines. Context: 3 lines. Options: 3-5 lines each. Consequences: 2-3 bullets |
| Confidence | - Confidence: {level} — {rationale} in metadata. Level + reason in one line |
| Reassessment | Optional ## Reassessment Triggers section after Consequences |
| Level | When to use |
|---|---|
| high | All options evaluated, clear winner, team consensus |
| medium | Some unknowns remain, limited production data |
| low | Best guess under constraints, significant unknowns exist |
| Topic | Resource |
|---|---|
| MADR | https://adr.github.io/madr/ |
| Fowler | https://martinfowler.com/articles/architecture-decision-record.html |
| Skill | ../adr/SKILL.md |
| Templates | ../../templates/adr/ |
| Scripts | ./scripts/ |