Skills
.Work. You
Rest

adr-drafting

Community

Draft ADRs with clarity and speed.

Software Engineering#template#architecture#documentation#adr#governance#decision-record
Authortillysoso
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Creates new Architecture Decision Record (ADR) documents for significant architectural changes using a consistent template and repository-aware naming and storage guidance. Use when a user or agent decides on an architectural change, needs to document technical rationale, or wants to add a new ADR to the project history.

Core Features & Use Cases

  • ADR drafting: from discovery to final Markdown using standard sections.
  • Conventions discovery: inspects repository for ADR location and naming patterns, or defaults to docs/architecture/adr with zero-padded filenames like 0001-<title>.md.
  • Guided workflow: prompts for Title, Status, Context, Decision, and Consequences, and ensures you are creating a new ADR (not editing an existing one).
  • Use Case: Document major architectural decisions to preserve history and rationale.

Quick Start

Provide the ADR details (title, context, decision, and consequences) and let the skill draft and save a new ADR file in the repository’s ADR location.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: adr-drafting
Download link: https://github.com/tillysoso/mv1/archive/main.zip#adr-drafting

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.