How does the skill handle ADR numbering?

The skill automatically scans the '.architecture/decisions/adrs/' directory, identifies the highest existing ADR number, and increments it for the new record.

An Architectural Decision Record (ADR) is a short text file that captures an important architectural decision, including the context in which it was made and the consequences it has for the project.

Can this skill track deferred decisions?

Yes, if deferrals are enabled in the configuration, the skill can track decisions that have been intentionally postponed in a dedicated deferrals file.

What is Pragmatic Mode in this skill?

Pragmatic Mode is an optional analysis section that scores a decision's necessity against its complexity to help engineers determine if a solution is appropriate or over-engineered.

Where are the ADR files stored?

ADRs are stored as Markdown files within the '.architecture/decisions/adrs/' directory of your repository for easy version control and accessibility.

Architectural Decision Record (ADR) Creator

Name: Architectural Decision Record (ADR) Creator
Author: codenamev

bycodenamev

•

学習とドキュメンテーション

Generates standardized Architectural Decision Records (ADRs) to document technical choices and evaluate architectural trade-offs.

This skill streamlines the process of capturing critical technical decisions by automating the creation of Architectural Decision Records. It handles sequential numbering, input sanitization, and template management to ensure documentation remains consistent and professional. Beyond simple documentation, it includes an optional Pragmatic Mode that enforces an analysis of necessity versus complexity, helping teams avoid over-engineering while maintaining a clear audit trail of why specific frameworks, patterns, or tools were chosen.

主な機能

01Standardized template enforcement for context and consequences

0242 GitHub stars

03Strict input sanitization and kebab-case filename generation

04Lifecycle status tracking (Proposed, Accepted, Deprecated, Superseded)

05Pragmatic Enforcer analysis to assess over-engineering risks

06Automated sequential numbering for ADR file management

ユースケース

01Recording a shift in architectural patterns like moving to microservices

02Evaluating and justifying security protocols or authentication strategies

03Documenting the selection of a new database or backend framework

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add codenamev/ai-software-architect create-adr

For use in Claude.ai and ChatGPT

Download Skill