skills.rest
echohello-dev
echohello-devOFFICIAL
Explore all skills by this author →
WebsiteGitHub

adr-writing

Create and track Architecture Decision Records in a standardized format.

Updated Dec 6, 2025
Search Tags:#adr#traceability#docs#architecture-decisions#decision-records
One-click install
npx skills add https://github.com/echohello-dev/betterfit --skill adr-writing
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr-writing
Source: https://github.com/echohello-dev/betterfit/tree/main/.claude/skills/adr-writing
Command: npx skills add https://github.com/echohello-dev/betterfit --skill adr-writing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture decisions are easy to forget; this Skill helps teams capture, structure, and reference ADRs so future maintainers understand trade-offs and context.

Core Features & Use Cases

  • ADR lifecycle: Create, update, and track ADRs in a standardized format.
  • Standards compliance: Enforces frontmatter, sections, and conventions.
  • Traceability: Links ADRs to decisions, PRs, and related docs.

Quick Start

Create a new ADR under docs/adrs/ with a descriptive title, using the next available number (e.g., 0003-...) and set status to Proposed.