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 1,179 stars 52 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 93/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
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
4 months ago
Last Updated
yesterday
Language
Python
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 4 days ago
sebastian-software
API & Backend Listed

architectural-decision-records

The single source of truth for capturing architectural decisions. Use for EVERY feature, service, endpoint, schema change, framework/library choice, integration, infrastructure change, or refactor an agent builds or modifies — no such change is "done" until an Architectural Decision Record (ADR) is written and committed alongside the code. Produces MADR-format records by default (Nygard lightweight for trivial decisions), auto-detecting or establishing the repo's ADR directory and sequential numbering. Trigger PROACTIVELY whenever the user asks to build, add, implement, design, choose, adopt, migrate, refactor, or change anything architectural — a new service, "which database should we use," "let's switch to gRPC," "add caching," "split this into microservices," a new API contract, an auth model — even when they never say the words "ADR," "decision record," "documentation," or "why." If a change would make a future engineer ask "why was it built this way?", it needs an ADR, and this skill governs how.

0 Updated 1 weeks ago
techfleetworks
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...

6 Updated today
rootcastleco