Skills
.Work. You
Rest

aoa-adr-write

Community

Capture and verify key architectural decisions.

Software Engineering#architecture#documentation#adr#verification#decision#repository
Author8Dionysus
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Teams often lose the rationale behind structural, tooling, or workflow changes, making future maintenance and onboarding difficult. This skill ensures those decisions are clearly recorded, placed in a canonical location, and kept in sync with the actual code changes.

Core Features & Use Cases

  • Decision Capture: Record the context, options, chosen path, and tradeoffs of an architectural or workflow decision.
  • Canonical Placement: Automatically store the ADR in the repository’s decision surface for easy discovery.
  • Verification: Validate that the documented decision aligns with the associated code changes and is reachable from the expected location.
  • Use Case: When introducing a new build system or refactoring a core module, use this skill to document why the change was made and ensure the ADR lives in the project's docs/adr directory.

Quick Start

Use the aoa-adr-write skill to record a new architectural decision and place it in the canonical ADR directory.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 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: aoa-adr-write
Download link: https://github.com/8Dionysus/aoa-skills/archive/main.zip#aoa-adr-write

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.