Create Architectural Decision Record
Automatically generates architectural decision records documenting design choices, rationale, and potential trade-offs.
Install on your platform
We auto-selected Claude Code based on this skill’s supported platforms.
Run in terminal (recommended)
claude mcp add create-architectural-decision-record npx -- -y @trustedskills/create-architectural-decision-record
Or manually add to ~/.claude/settings.json
{
"mcpServers": {
"create-architectural-decision-record": {
"command": "npx",
"args": [
"-y",
"@trustedskills/create-architectural-decision-record"
]
}
}
}Requires Claude Code (claude CLI). Run claude --version to verify your install.
About This Skill
What it does
This skill helps users create architectural decision records (ADRs) by guiding them through the process of documenting decisions made during software architecture design. It provides structured templates, prompts for capturing context and alternatives, and ensures clarity in rationale and trade-offs.
When to use it
- You're working on a complex software project and need to document key architectural choices.
- Your team requires standardized documentation for decision-making processes.
- You want to ensure transparency and traceability of design decisions for future reference or audits.
Key capabilities
- Structured template creation for ADRs
- Guidance on documenting context, problem, solution, and trade-offs
- Prompts for capturing alternatives and rationale
Example prompts
- "Create an architectural decision record for choosing a microservices over monolithic architecture."
- "Document the decision to use React instead of Angular in our frontend stack."
- "Generate a template for recording decisions related to database schema design."
Tips & gotchas
- Ensure all stakeholders are involved when documenting decisions to maintain accuracy and alignment.
- Use this skill early in the project lifecycle to avoid rework later on.
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 |
🏢 Official
Published by the company or team that built the technology.