recording-architecture-decisions

Community

Capture durable architecture decisions with context.

AuthorGanyuanRan
Version1.0.0
Installs0

System Documentation

What problem does it solve?

The skill helps teams capture and preserve the rationale behind architectural decisions by creating durable ADRs, baseline snapshots, and decision logs alongside the current architecture state.

Core Features & Use Cases

  • Create, amend, supersede, or evaluate ADRs and baseline-sync records to document architecture changes.
  • Route work to the correct ownership surface (docs/adr, docs/aegis/adr, etc.) and ensure memory of decisions is preserved.
  • Enforce ADR conventions, provide a guided decision flow, and guardrails to avoid stale baselines or misapplied changes.

Quick Start

Identify an architecture decision you want to record and follow the ADR workflow to create or amend the ADR in the appropriate surface.

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: recording-architecture-decisions
Download link: https://github.com/GanyuanRan/Aegis/archive/main.zip#recording-architecture-decisions

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 510,000+ vetted skills library on demand.