recording-architecture-decisions

Featured

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 811 stars 39 forks Updated today MIT

Install

View on GitHub

Quality Score: 91/100

Stars 20%
97
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
2 months ago
Last Updated
today
Language
Shell
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

Code & Development Listed

decision-records

Create, review, update, supersede, and audit Architecture Decision Records (ADRs) for durable project decisions. Use when a user asks for an ADR, decision log, architecture decision, design decision, communication or brand voice decision, or recorded rationale; when a cross-cutting technical, product, design, content, marketing, security, operational, or process choice must remain understandable across people, tools, and agent sessions; or when another skill identifies a decision whose undocumented rationale would otherwise drift. Preserve existing repository conventions and do not create skill-specific dot folders or private memory formats.

0 Updated 2 days ago
sebastian-software
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 3 days ago
rootcastleco
Code & Development Solid

record

Keep durable architecture decisions and product specs in sync with the work happening in the conversation. AUTO-INVOKE when a request establishes or changes a long-lived architectural boundary, public contract, data ownership rule, operational invariant, or repo-wide convention with meaningful alternatives. Also invoke on explicit triggers: "record this", "create an ADR", "document this decision", "update the spec", "ADR for X". Run BEFORE coding when the decision is upfront, or AFTER landing when the right call only became clear during implementation. Do not create ADRs for simple features, local implementation choices, routine dependency changes, or bug fixes that do not establish a durable rule.

494 Updated today
kdlbs