Skills
.Work. You
Rest

create-adr

Community

Document architectural decisions with ease.

Software Engineering#documentation#decision record#technical debt#software architecture#ADR#architectural decision#pragmatic mode
Authorcodenamev
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Architectural decisions are often made and forgotten, leading to inconsistent patterns, technical debt, and difficulty onboarding new team members. This Skill standardizes and automates the creation of Architectural Decision Records (ADRs), ensuring critical choices are well-documented and easily discoverable.

Core Features & Use Cases

  • Automated ADR Generation: Creates new ADRs with a unique sequential number and a standardized template.
  • Pragmatic Mode Integration: Automatically includes a "Pragmatic Enforcer" analysis to challenge over-engineering if enabled.
  • Input Validation: Ensures safe and consistent naming for ADR files.
  • Use Case: Your team decides to switch from a monolithic database to a microservice-specific database approach. You use "Create ADR for microservice database strategy" to document the problem, alternatives, decision, and consequences for future reference.

Quick Start

Create ADR for PostgreSQL database choice

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: create-adr
Download link: https://github.com/codenamev/ai-software-architect/archive/main.zip#create-adr

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.