skills.rest
edfenton
edfentonCOMMUNITY
Explore all skills by this author →
Website𝕏@edfentonGitHub

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
One-click install
npx skills add https://github.com/edfenton/claude-skills --skill shared-adr
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
masa-codehubmasa-codehub

bootstrapping-skills

Generate Gemini CLI agent skill scaffolds with SKILL.md templates.

Community
Intermediate
JongsixJongsix

moai-docs-generation

Generate technical documentation from source code and API definitions.

Community
Advanced
stevolandstevoland

adr

Create and manage MADR-compliant Architecture Decision Records across projects.

Community
Basic
hgflimahgflima
1

documentation-and-adrs

Create and manage architectural decision records using markdown templates.

Community
Advanced