Craft Adr

Recording architectural decisions. Why we chose X over Y.

attac-t 4d700aa 2 files · 1.9 KB Updated

File contents

Skill: Craft ADR

"Decisions in code are temporary. Decisions in ADRs are permanent."

The Standard

  1. Location: docs/{domain}/ADR/ADR-001-title.md.
  2. Status: Proposed → Accepted → Deprecated.
  3. Structure: Context → Decision → Consequences.
  4. Rationale: Document what was rejected and why.

When to Record

Record Don't Record
Package choice Trivial fixes
Pattern choice Standard CRUD
Schema design Config changes
Integration approach Obvious decisions

Real-World Examples

See examples.md.

attac-t/the-foundry/tree/main/plugins/kernel/skills/craft-adr commit 4d700aa781

Frequently asked questions

npx skillmds@latest add attac-t/craft-adr