shared-adr

Create, list, and supersede Architecture Decision Records with a CLI script.

3|1|Updated Feb 12, 2026

Search Tags:#workflow #architecture #templates #documentation #adr #decision-records

Ready to run

npx skills add https://github.com/edfenton/claude-skills --skill shared-adr

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: shared-adr
Source: https://github.com/edfenton/claude-skills/tree/main/shared/shared-adr
Command: npx skills add https://github.com/edfenton/claude-skills --skill shared-adr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Document architectural decisions with structured Architecture Decision Records (ADRs) to preserve context, rationale, and traceability across projects.

Core Features & Use Cases

Create, template, and manage ADRs in docs/adr to standardize decision documentation.
List, supersede, and reference ADRs with clear status tracking to maintain historical accuracy.
Reuse templates and references to ensure consistency when recording architectural decisions.
Use case: when selecting a technology stack, capture the decision, alternatives considered, and consequences for future teams.

Quick Start

Run the ADR script with a descriptive title to initialize your first ADR file.

Frequently Asked Questions about shared-adr

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

FAQPage Schema

How do I document architectural decisions to preserve context and rationale across projects?▼

Document architectural decisions using Architecture Decision Records (ADRs) to capture context, alternatives considered, and consequences for future teams, ensuring traceability and standardized decision documentation across projects.

What is the best way to manage ADR status and supersede outdated decision records?▼

Manage ADR status and supersede outdated decision records by using a CLI script that enforces consistent naming, clear status tracking, and cross-references to maintain historical accuracy when architectural decisions change.

How do I create and template new Architecture Decision Records in my software project?▼

Create and template new Architecture Decision Records by running the ADR CLI script with a descriptive title, which initializes a standardized file in your docs directory using reusable templates and reference structures.

Can I list existing ADRs and cross-reference related architectural decisions?▼

Yes, you can list existing ADRs and cross-reference related architectural decisions using the provided CLI script, which maintains consistent file structures and links between superseded, referenced, and active decision records.

Why use ADR templates for recording technology stack decisions in software engineering?▼

Use ADR templates to standardize the recording of technology stack decisions, ensuring consistent naming, status tracking, and documentation of alternatives and consequences for future development teams.

Do I need specific dependencies to run the ADR workflow scripts?▼

No specific dependencies are required to run the ADR workflow scripts, as the tool provides a standalone CLI script and file structure to create, list, and supersede architecture decision records without external framework dependencies.