skills.rest
sakamotomomotaro0809-netizen
sakamotomomotaro0809-netizenCOMMUNITY
Explore all skills by this author →
GitHub

sdd-adr

Generate Architecture Decision Records in MADR format for spec-driven development workflows.

Updated Mar 23, 2026
Search Tags:#documentation#markdown#adr#spec-driven development#technical decisions#architecture decision record#madr
One-click install
npx skills add https://github.com/sakamotomomotaro0809-netizen/tateyomi --skill sdd-adr-sakamotomomotaro0809-netizen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sdd-adr
Source: https://github.com/sakamotomomotaro0809-netizen/tateyomi/tree/main/taisun_agent/.claude/skills/sdd-adr
Command: npx skills add https://github.com/sakamotomomotaro0809-netizen/tateyomi --skill sdd-adr-sakamotomomotaro0809-netizen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Important technical decisions often go undocumented, making it impossible to understand later why a technology or approach was chosen. This Skill generates standardized Architecture Decision Records (ADRs) so decisions, alternatives, and trade-offs are captured and traceable. ## Core Features & Use Cases - MADR-Formatted ADRs: Generates ADR files with standardized sections covering context, decision, consequences, alternatives, implementation, and validation. - Automatic Numbering and Naming: Scans existing ADRs to assign the next sequential number and produces kebab-case filenames like ADR-001-jwt-authentication.md. - Status Lifecycle Management: Tracks ADR status (Proposed, Accepted, Deprecated, Superseded) and maintains an adr/README.md index listing all records. - Use Case: While designing a reporting feature, you decide to adopt JWT for authentication. Run the Skill with the title and spec slug to produce a complete ADR comparing JWT against session-based auth and doing nothing, stored under .kiro/specs/<spec-slug>/adr/. ## Quick Start Ask the AI to generate an ADR titled "Adopt JWT for authentication" for the spec slug google-ad-report using the sdd-adr skill.

Frequently Asked Questions about sdd-adr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an Architecture Decision Record for a project?▼

Invoke the Skill with an ADR title and a spec slug, for example "/sdd-adr Adopt-JWT-for-authentication google-ad-report". It scans existing ADRs, assigns the next number, and writes a MADR-formatted file to the spec's adr directory.

What is the MADR format for architecture decision records?▼

MADR (Markdown Any Decision Records) is a standardized markdown template for ADRs. This Skill generates sections for context, decision, consequences, at least two alternatives plus doing nothing, implementation milestones, and validation criteria.

Where are generated ADR files stored?▼

By default ADRs are written to .kiro/specs/<spec-slug>/adr/ with filenames like ADR-001-jwt-authentication.md. You can pass an optional target directory as the third argument to override the default location.

How are ADR statuses managed over time?▼

Each ADR carries a status of Proposed, Accepted, Deprecated, or Superseded. The Skill also maintains an adr/README.md index table listing every ADR with its ID, title, status, and creation date.

Can I customize the ADR template used for generation?▼

Yes, the Skill references a templates/adr.template.md file as the basis for generated records. Editing that template changes the structure of all subsequently generated ADRs.

Related Skills

Explore More Software Engineering Skills→
rachel353rachel353

design

Generate a DESIGN.md document with design requirements and typography from IA structure.

Community
Intermediate
pawan0631pawan0631

notion-spec-to-implementation

Convert Notion specs into implementation plans with tasks and progress tracking.

Community
Advanced
sddevelopment-besddevelopment-be
13

Decision-First Development Workflow

Capture architectural decisions and rationale in traceable ADR-aligned workflows.

Official
Advanced
cooperacodecooperacode
5

adr

Generate MADR-based Architecture Decision Records from active wiki pages.

Official
Advanced