Architecture Decision Records
Creates proper Architecture Decision Records using proven templates like MADR, Y-statements, and RFC formats. Generates the full ADR structure with context, decision drivers, considered options, consequences, and implementation notes. Use this when you need to document significant tech decisions like database choices, framework adoption, or architecture patterns. The templates handle everything from lightweight decisions to complex migrations with deprecation workflows. Honestly, it's mainly valuable because it enforces the discipline of actually writing down why you made technical choices, which most teams skip until they're debugging a mystery decision from two years ago.
- install copies · 90 days. Times the install command was copied on this site in the last 90 days, bots filtered.
- 5
- skills.sh installs
- 24.5K
- GitHub stars
- 42.4K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add wshobson/agents --skill architecture-decision-records --agent claude-codeInstalls into .claude/skills of the current project.
Files
Architecture Decision Records
Comprehensive patterns for creating, maintaining, and managing Architecture Decision Records (ADRs) that capture the context and rationale behind significant technical decisions.
When to Use This Skill
- Making significant architectural decisions
- Documenting technology choices
- Recording design trade-offs
- Onboarding new team members
- Reviewing historical decisions
- Establishing decision-making processes
Core Concepts
1. What is an ADR?
An Architecture Decision Record captures:
- Context: Why we needed to make a decision
- Decision: What we decided
- Consequences: What happens as a result
2. When to Write an ADR
| Write ADR | Skip ADR |
|---|---|
| New framework adoption | Minor version upgrades |
| Database technology choice | Bug fixes |
| API design patterns | Implementation details |
| Security architecture | Routine maintenance |
| Integration patterns | Configuration changes |
3. ADR Lifecycle
Proposed → Accepted → Deprecated → Superseded
↓
Rejected
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/wshobson/agents
- Categories
- Documentation, Code Review & Quality, Productivity & Planning
More from wshobson/agents
All 174- Prompt Engineering Patterns24.3K
- Python Design Patterns23.7K
- Error Handling Patterns23.6K
- Modern Javascript Patterns23.3K
- Stride Analysis Patterns22.2K
- Responsive Design22K
- Rust Async Patterns21.9K
- Threat Mitigation Mapping21.2K
- Javascript Testing Patterns21.1K
- Auth Implementation Patterns20.9K
- Sql Optimization Patterns20.4K
- Git Advanced Workflows19.9K
- Dotnet Backend Patterns19.6K
- Async Python Patterns18.8K
- Attack Tree Construction18.8K
- Godot Gdscript Patterns18.3K
- Github Actions Templates18.1K
- Database Migration18K
- Data Storytelling17.6K
- Backtesting Frameworks17.5K
- Kpi Dashboard Design17.2K
- Python Code Style17.1K
- Openapi Spec Generation17K
- Interaction Design17K
Recommended
More Documentation
modern-javascript-patternswshobson/agentsMaster ES6+ features including async/await, destructuring, spread operators, arrow functions, promises, modules, iterators, generators, and functional programmi23.3Kskills.sh installs
langfuselangfuse/skillsInteract with Langfuse and access its documentation. Use when needing to (1) query or modify Langfuse data programmatically via the CLI — traces, prompts, datas20.9Kskills.sh installs
threejs-shaderscloudai-x/threejs-skillsThree.js shaders - GLSL, ShaderMaterial, uniforms, custom effects. Use when creating custom visual effects, modifying vertices, writing fragment shaders, or ext19.7Kskills.sh installs
shopify-adminshopify/shopify-ai-toolkitWrite or explain **Admin GraphQL** queries and mutations for apps and integrations that extend the Shopify admin. Use when the user wants to **understand, desig17.8Kskills.sh installs
readoutwarpdotdev/common-skillsProduce a polished, self-contained HTML "readout" document under ~/.readouts (with an auto-maintained index page), either by snapshotting the findings accumulat17.7Kskills.sh installsopenapi-spec-generationwshobson/agentsGenerate and maintain OpenAPI 3.1 specifications from code, design-first specs, and validation patterns. Use when creating API documentation, generating SDKs, o17Kskills.sh installs