Create Adr
Automatically generates Architecture Decision Records (ADRs) from project context and discussions to document key technical choices.
Install on your platform
We auto-selected Claude Code based on this skill’s supported platforms.
Run in terminal (recommended)
claude mcp add codenamev-create-adr npx -- -y @trustedskills/codenamev-create-adr
Or manually add to ~/.claude/settings.json
{
"mcpServers": {
"codenamev-create-adr": {
"command": "npx",
"args": [
"-y",
"@trustedskills/codenamev-create-adr"
]
}
}
}Requires Claude Code (claude CLI). Run claude --version to verify your install.
About This Skill
What it does
The codenamev-create-adr skill generates Architecture Decision Records (ADRs). ADRs are text files that capture important decisions made during software development, including context and consequences. This skill helps standardize documentation of architectural choices, making them easily discoverable and understandable for the team. It aims to improve maintainability and reduce misunderstandings related to design decisions.
When to use it
- Documenting a new technology choice: Before committing to a specific framework or library, capture the reasoning behind your selection.
- Resolving architectural debates: Formalize discussions and outcomes regarding different approaches to a problem.
- Onboarding new team members: Provide clear explanations of past decisions and their rationale.
- Reviewing existing architecture: Create ADRs for previously made design choices that lack documentation.
Key capabilities
- Generates ADR files in markdown format.
- Captures context, decision, and consequences related to architectural choices.
- Standardizes the documentation of architectural decisions.
Example prompts
- "Create an ADR about choosing React for the frontend."
- "Generate a record documenting our decision to use GraphQL instead of REST."
- "Write an ADR explaining why we opted for microservices architecture."
Tips & gotchas
- The skill is most effective when used proactively, before significant architectural decisions are made.
- While the skill generates the structure, you'll need to provide specific details and reasoning related to your decision.
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.