How does this skill help with documentation?

It automates the creation of ADRs using templates and provides commands to list, search, and view them, ensuring documentation stays consistent and accessible.

What is an Architecture Decision Record (ADR)?

An ADR is a short document that captures a significant architectural decision, including its context and consequences, to track the evolution of a project's design.

Can I supersede old decisions?

Yes, the skill includes a specific action to supersede existing ADRs, allowing you to create a new record that officially replaces an older one while maintaining the history.

Where are the ADRs stored?

By default, they are stored in your project repository in folders like /doc/adr/ or /docs/adr/, ensuring your architectural history is version-controlled.

Architecture Decision Records (ADR)

Name: Architecture Decision Records (ADR)
Author: jellydn

byjellydn

•

Learning & Documentation

Simplifies the creation, tracking, and management of Architecture Decision Records within your development workflow.

The Architecture Decision Records (ADR) skill provides a unified interface for documenting critical architectural choices directly within your repository. It helps engineering teams maintain a clear history of design decisions, their context, and consequences, facilitating smoother onboarding and preventing the loss of institutional knowledge as projects evolve. By standardizing the ADR lifecycle—from initialization and creation to superseding outdated decisions—this tool ensures architectural transparency and consistency across the entire development lifecycle.

Key Features

01Initialize standardized ADR directory structures automatically

02Supersede outdated decisions to maintain an accurate historical record

03View detailed ADR content directly within your AI-powered coding session

04Create new ADRs using professional templates with context and consequences

05Search and list existing records to quickly find architectural rationale

0642 GitHub stars

Use Cases

01Documenting the rationale behind choosing a specific database or framework

02Tracking the evolution of system design and API standards over time

03Onboarding new developers by providing a searchable history of architectural choices

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jellydn/my-ai-tools adr

For use in Claude.ai and ChatGPT

Download Skill