Skills
.Work. You
Rest

role-architect:adr-writer

Community

Document architecture decisions.

Software Engineering#architecture#documentation#system design#decision record#adr#technical debt
Authorrnavarych
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill streamlines the process of documenting significant architectural decisions, ensuring clarity, consistency, and a traceable history of design choices.

Core Features & Use Cases

  • ADR Creation: Guides the writing of Architecture Decision Records with a structured format.
  • Lifecycle Management: Manages the status transitions of ADRs (Proposed, Accepted, Deprecated, Superseded).
  • Linking Decisions: Facilitates linking related ADRs to show dependencies and evolution.
  • Use Case: When deciding on a new database technology, use this Skill to create a formal ADR, detailing the context, decision, consequences, and alternatives considered, ensuring team alignment and future reference.

Quick Start

Write a new Architecture Decision Record for using PostgreSQL for the Order Service.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: role-architect:adr-writer
Download link: https://github.com/rnavarych/alpha-engineer/archive/main.zip#role-architect-adr-writer

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.