ossrules.md

adr-skill

Create and maintain Architecture Decision Records (ADRs) optimized for agentic coding workflows. Use when you need to propose, write, update, accept/reject, deprecate, or supersede an ADR; bootstrap an adr folder and index; consult existing ADRs before implementing changes; or enforce ADR conventions. This skill uses Socratic questioning to capture intent before drafting, and validates output against an agent-readiness checklist.

Install
npx skills add 'https://github.com/vercel/ai/tree/main/skills/adr-skill'
Download bundle ↓
main · 8b92ba9 ↗Scanned 2026-09-15

Contributors

GitHub-linked commit authors for this SKILL.md at the saved revision. Co-authors and history before file renames are not included.

File history ↗

assets/templates/adr-readme.md

assets/templates/adr-readme.mdBrowse 11 files
View on GitHub
164 tokens

659 bytes
Token encoding: o200k_base
Snapshot 8b92ba9

← Back to SKILL.md

Architecture Decision Records (ADR)

An Architecture Decision Record (ADR) captures an important architecture decision along with its context and consequences.

Conventions

  • Directory: {ADR_DIR}
  • Naming:
    • Use date-prefixed files: YYYY-MM-DD-choose-database.md
    • If the repo already uses slug-only names, keep that: choose-database.md
  • Status values: proposed, accepted, rejected, deprecated, superseded

Workflow

  • Create a new ADR as proposed.
  • Discuss and iterate.
  • When the team commits: mark it accepted (or rejected).
  • If replaced later: create a new ADR and mark the old one superseded with a link.

ADRs

Referenced from SKILL.md
SKILL.mdView in source ↗
Source excerpt starting at line 299.
- `assets/templates/adr-madr.md` — MADR 4.0 template for decisions with multiple options and structured tradeoffs.- `assets/templates/adr-readme.md` — default ADR index scaffold used by `scripts/bootstrap_adr.js`.
← All AI SDK skillsProject instructions →