What happens if I don't provide a title?

The skill will stop and ask you for a title immediately, as a clear description is necessary to generate a valid ADR and filename.

An Architecture Decision Record (ADR) is a document that captures an important architectural decision made along with its context and consequences.

How does this skill handle file numbering?

The skill automatically scans the 'docs/adr/' directory to find the latest record and increments the sequential number for the new file.

Does it follow a specific standard?

Yes, it uses a standardized RFC-style template that includes status, context, decision, consequences (positive/negative/neutral), and alternatives considered.

Architecture Decision Records (ADR)

Name: Architecture Decision Records (ADR)
Author: atournayre

byatournayre

0•

学习与文档

Generates structured, RFC-formatted Architecture Decision Records to document and track technical choices within a project.

The ADR Architect skill streamlines the process of documenting critical technical decisions using the Architecture Decision Record (ADR) pattern. It automatically manages sequential numbering by scanning your existing documentation, incorporates project-specific context from your codebase, and uses a standardized RFC-style template. This skill ensures that the 'why' behind your architecture is captured with sections for context, consequences, and alternatives, providing a clear audit trail for current and future team members.

主要功能

01Context-aware analysis of existing project documentation

020 GitHub stars

03Structured capture of status, consequences, and alternatives

04Automatic slug generation and file organization

05Automatic sequential numbering for ADR files

06Standardized RFC-style Markdown templates

使用场景

01Documenting the migration to a new framework or database system

02Establishing team-wide coding patterns or architectural standards

03Tracking technical debt decisions and their long-term justifications

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add atournayre/claude-personas adr

For use in Claude.ai and ChatGPT