recording-architecture-decisions

Solid

Use when the user asks to create, write, update, amend, supersede, or evaluate an ADR, architecture decision record, durable architecture decision, decision log, or baseline sync after architecture-changing work.

DevOps & Infrastructure 400 stars 16 forks Updated today MIT

Install

View on GitHub

Quality Score: 89/100

Stars 20%
87
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Recording Architecture Decisions ## Purpose Record durable architecture decisions without losing the current-state baseline closure. An ADR records why a decision was made; a baseline records what the architecture is after that decision. This skill is a lazy, task-specific workflow. It does not replace `verification-before-completion`, does not grant completion authority, and does not make authoritative `GateDecision` or `PolicySnapshot` outputs. ## Required Read Set Before deciding or writing, read the smallest relevant excerpts from: - `docs/adr/ADR-CREATION-GATE.md` - `docs/current/AEGIS_ADR_AUTO_BACKFILL.md` - the target project's current ADR, baseline, or authority docs that own the affected architecture surface For Aegis repository changes, use this repository's `docs/adr/` and `docs/current/` authority order. For target projects with their own ADR system, respect that project owner instead of duplicating the same decision into `docs/aegis/adr/`. ## When To Use Use this skill when the user asks to: - create, write, update, amend, supersede, or evaluate an ADR - decide whether an architecture decision record is needed - record a durable architecture decision or decision log entry - close baseline sync after an ADR-relevant architecture change - verify that an ADR action did not leave the architecture baseline stale Do not use it for simple wording edits, ordinary README cleanup, tests-only coverage improvements, low-risk single-file changes, or bug fixes t...

Details

Author
GanyuanRan
Repository
GanyuanRan/Aegis
Created
1 months ago
Last Updated
today
Language
Shell
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

architecture-decision-records

Architecture decision record workflow. Use when the user chooses between significant technical options, asks to record a decision, asks why a design exists, or discusses architecture, dependencies, data models, deployment shape, or long-lived tradeoffs.

0 Updated today
JunMystery
DevOps & Infrastructure Featured

architecture-decision-records

Comprehensive patterns for creating, maintaining, and managing Architecture Decision Records (ADRs) that capture the context and rationale behind significant technical decisions.

27,681 Updated today
davila7
AI & Automation Listed

architecture-decision-records

Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. Use when documenting significant technical decisions, reviewing past architect...

5 Updated yesterday
rootcastleco
AI & Automation Featured

architecture-decision-records

Comprehensive patterns for creating, maintaining, and managing Architecture Decision Records (ADRs) that capture the context and rationale behind significant technical decisions.

39,227 Updated today
sickn33
DevOps & Infrastructure Solid

architecture-decision-record

Create an Architecture Decision Record (ADR) for any technical decision. Use when asked to document a technical decision, write an ADR, record an architecture choice, or capture why a technology or approach was selected. Produces a structured ADR with context, decision, consequences, and tradeoffs.

915 Updated 3 days ago
mohitagw15856