skills.rest
Roger-Quinelato
Roger-QuinelatoCOMMUNITY
Explore all skills by this author →
GitHub

create-adr

Create structured Architecture Decision Records with context, options, and consequences.

Updated May 1, 2026
Search Tags:#architecture#software design#ADR#decision documentation#architecture decision records
One-click install
npx skills add https://github.com/Roger-Quinelato/BBSIA-Copia --skill create-adr-roger-quinelato
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-adr
Source: https://github.com/Roger-Quinelato/BBSIA-Copia/tree/main/.claude/skills/create-adr
Command: npx skills add https://github.com/Roger-Quinelato/BBSIA-Copia --skill create-adr-roger-quinelato

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill simplifies the process of recording and maintaining clear, structured documentation of architectural decisions, ensuring teams preserve rationale and context for future reference.

Core Features & Use Cases

  • Structured ADR Creation: Guides users to create well-formatted Architecture Decision Records in multiple styles.
  • Automated Numbering: Scans existing ADRs to assign sequential identifiers automatically.
  • Multilingual Support: Detects user language and generates content accordingly, ensuring accessibility across teams.
  • Context and Rationale Capture: Prompts for essential decision details like context, options, and consequences.
  • Use Case: A team decides to switch database technologies and uses this Skill to formally document the reasoning, alternatives considered, and trade-offs involved.

Quick Start

Ask the AI to "Create an ADR for migrating to microservices" and supply the decision context when prompted.

Frequently Asked Questions about create-adr

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

FAQPage Schema
What is an architecture decision record and when should I document one?▼

An architecture decision record (ADR) documents the context, options, and consequences of a technical choice. You should create an ADR whenever a team makes a significant software design decision that future developers need to understand.

How do I create an ADR for migrating to a new database technology?▼

To create an ADR, prompt the AI with your decision topic and provide the context when asked. The Skill guides you through capturing the rationale, alternatives considered, and trade-offs to produce a structured record.

Does this ADR generator support multiple languages for international teams?▼

Yes, the ADR generator detects the user's language and generates the decision documentation accordingly. This multilingual support ensures distributed teams can maintain accessible architecture histories.

How does automated numbering work for existing architecture decision records?▼

Automated numbering scans your existing ADRs to assign sequential identifiers automatically. This ensures that each new architecture decision record maintains a consistent and chronological history across technical projects.

What is the best way to capture context and rationale in software design documentation?▼

The best way is using a structured ADR format that prompts for essential details. This Skill guides you to encapsulate the decision context, available options, and future consequences to ensure comprehensive technical records.

Related Skills

Explore More Software Engineering Skills→
gelsonsimoesgelsonsimoes

architecture

Frame architectural decisions using a structured ADR-based framework.

Community
Intermediate
voidrotvoidrot

domain-modeling

Develop domain terminology and maintain Architecture Decision Records (ADRs).

Community
Advanced
jeremy-newhousejeremy-newhouse

wa:design-adr

Create Architecture Decision Records with context, rationale, alternatives, and consequences.

Community
Advanced
jeremyaryjeremyary
7

adr

Create structured Markdown Architecture Decision Records in the plans/adr/ directory.

Community
Intermediate