Architecture Decision Records
This skill generates Architecture Decision Records (ADRs) to document design choices, fostering clarity and collaboration within projects.
Install on your platform
We auto-selected Claude Code based on this skill’s supported platforms.
Run in terminal (recommended)
claude mcp add architecture-decision-records npx -- -y @trustedskills/architecture-decision-records
Or manually add to ~/.claude/settings.json
{
"mcpServers": {
"architecture-decision-records": {
"command": "npx",
"args": [
"-y",
"@trustedskills/architecture-decision-records"
]
}
}
}Requires Claude Code (claude CLI). Run claude --version to verify your install.
About This Skill
What it does
The architecture-decision-records skill helps AI agents document and manage architectural decisions made during software development. It provides a structured format for recording the context, options considered, decision rationale, and consequences of each choice, ensuring transparency and traceability in system design.
When to use it
- When documenting major technical choices in a project for future reference
- During team collaboration to ensure alignment on architectural decisions
- As part of a software development lifecycle to maintain an audit trail of design trade-offs
Key capabilities
- Structured documentation of architectural decisions
- Recording context, options, rationale, and consequences
- Facilitating traceability and transparency in system design
Example prompts
- "Document the decision to use microservices over monolithic architecture for our new application."
- "Create an architecture decision record for choosing React over Vue.js as our frontend framework."
- "Generate a template for recording architectural decisions during our sprint planning meeting."
Tips & gotchas
- Ensure all stakeholders are involved in reviewing and approving decisions before finalizing the records.
- Maintain consistency in formatting to make records easier to search, review, and update later.
Tags
TrustedSkills Verification
Unlike other registries that point to live repositories, TrustedSkills pins every skill to a verified commit hash. This protects you from malicious updates — what you install today is exactly what was reviewed and verified.
Security Audits
| Gen Agent Trust Hub | Pass |
| Socket | Pass |
| Snyk | Pass |
🌐 Community
Passed automated security scans.