decision-record-writer
CommunityCreate auditable ADRs with immutable history.
Software Engineering#adr#governance#technical documentation#append-only#architecture decision#decision traceability#risk logging
AuthorGustavoGutierrez
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Writing architecture decision records is often inconsistent, non-auditable, and loses rationale over time; this skill standardizes how decisions are captured so teams can trace why choices were made.
Core Features & Use Cases
- Append-only ADR supersession: Creates new ADRs for the same topic key instead of rewriting prior decisions, preserving an immutable decision trail.
- Rigor checks before writing: Verifies there is a real decision (at least two plausible alternatives with explicit tradeoffs) and rejects vague feature requests masquerading as decisions.
- Governance-ready ADR output: Produces a single Markdown ADR file with a structured template including context, decision, alternatives, tradeoffs, consequences (with mandatory negatives), risks, scope, and review trigger.
Quick Start
Ask the AI to write an ADR using the decision-record-writer skill for your architectural choice, providing at least two alternatives with tradeoffs and the negative consequences you expect.
Dependency Matrix
Required Modules
None requiredComponents
references
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: decision-record-writer Download link: https://github.com/GustavoGutierrez/engineering-skills/archive/main.zip#decision-record-writer Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.