Document architectural decisions
architecture-decision-recordsskillsetup L1★0
Sheshiyer/skill-clusters ↗What it does
Create and manage architecture decision record (ADR) library
Best for
When you need to document hard architectural decisions and keep the reasoning discoverable over project lifetime.
Inputs
- · ADR title
- · context (problem, constraints)
- · decision text
- · consequences
Outputs
- · docs/architecture/adr-NNNN.md with decision status, decision, consequences, alternatives
Requires
- · markdown
- · git
- · template system
- · optional: ADR index builder
Preconditions
docs/architecture/ directory exists, ADR template available
Failure modes
- · Status field missing
- · Consequences incomplete
- · Index out of sync
Trust signals
- · Status tracking (Proposed, Accepted, Deprecated, Superseded)
- · Structured decision + consequences
- · Supports alternatives section