What is the purpose of the ADR skill?

It automates the process of recording significant technical decisions, ensuring they are documented consistently with numbering, rationales, and tradeoffs.

Does it automatically commit changes to Git?

No, it prepares the record and then provides a pre-formatted git commit command for the user to execute, ensuring human oversight.

Where does this skill save the decision records?

The skill specifically appends new ADR entries to the 'memory-bank/tech-stack.md' file in your project repository.

How does the skill handle ADR numbering?

It automatically scans your existing records to find the highest number and increments it for the new entry, preventing numbering conflicts.

Architecture Decision Records (ADR)

Name: Architecture Decision Records (ADR)
Author: SwervoJake

bySwervoJake

0•

Learning & Documentation

Automates the documentation and tracking of significant technical decisions within a project's memory bank.

The ADR skill streamlines the architectural decision-making process by automatically managing the numbering and formatting of Architecture Decision Records (ADRs). It ensures that every critical pivot—such as changing a tech stack or adopting a new design pattern—is captured with its rationale, accepted tradeoffs, and review dates. By appending these records directly to the project's technical documentation, it maintains a persistent 'source of truth' that helps both human developers and AI agents understand the historical context and system constraints of the codebase.

Key Features

01Automatic sequential ADR numbering

020 GitHub stars

03Automated git commit message generation

04Guided prompts for decision metadata and review dates

05Standardized templates for rationale and tradeoffs

06Direct integration with memory-bank documentation

Use Cases

01Logging a permanent record of technical pivots and framework selections

02Creating an audit trail for system design trade-offs during project scaling

03Maintaining architectural alignment across multiple AI agents and human collaborators

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add swervojake/claaaude-studio adr

For use in Claude.ai and ChatGPT