mr-wolv/skill_playground_bakr101_2026/architecture-decision-records
Claude Code and agent skill by mr-wolv/skill_playground_bakr101_2026
- community
Checking that the SKILL.md file is still in the repository.
Write and maintain formal Architecture Decision Records (ADRs) for significant technical decisions. Use when the output should be an ADR specifically, rather than broader engineering documentation.
Install
npx vskill@latest install mr-wolv/skill_playground_bakr101_2026/architecture-decision-recordsSKILL.md
The same SKILL.md was published earlier as mr-wolv/skill_playground_bakr101_2026/architecture-decision-records.
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
Boundary
Use this skill when the output should be a formal Architecture Decision Record: a durable decision artifact with explicit context, decision, consequences, and lifecycle state.
Do not use this skill for broader documentation work such as README refreshes, general architecture notes, onboarding context, or mixed documentation bundles. For that, use documentation-and-adrs.
Do not use this skill merely to review whether an existing document is clear or complete. For that, use document-reviewer.
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
Templates
Template 1: Standard ADR (MADR Format)
Template 2: Lightweight ADR
Template 3: Y-Statement Format
Template 4: ADR for Deprecation
Template 5: Request for Comments (RFC) Style
OrderCreated { orderId, customerId, items[], timestamp } OrderItemAdded { orderId, item, timestamp } OrderItemRemoved { orderId, itemId, timestamp } PaymentReceived { orderId, amount, paymentId, timestamp } OrderShipped { orderId, trackingNumber, timestamp }
ADR Management
Directory Structure
ADR Index (README.md)
Automation (adr-tools)
Review Process
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/architecture-decision-records/SKILL.md
Popularity
- 7-day trend score
- 5
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/mr-wolv/skill_playground_bakr101_2026/architecture-decision-records)