recording-architecture-decisions
FeaturedUse 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.
Install
Quality Score: 93/100
Skill Content
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
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.
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.
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...