Create Adr
Automatically generates Architecture Decision Records (ADRs) from project context and discussions, streamlining documentation.
Install on your platform
We auto-selected Claude Code based on this skill’s supported platforms.
Run in terminal (recommended)
claude mcp add create-adr npx -- -y @trustedskills/create-adr
Or manually add to ~/.claude/settings.json
{
"mcpServers": {
"create-adr": {
"command": "npx",
"args": [
"-y",
"@trustedskills/create-adr"
]
}
}
}Requires Claude Code (claude CLI). Run claude --version to verify your install.
About This Skill
What it does
The create-adr skill generates Architecture Decision Records (ADRs) based on provided context. It structures decisions with a standardized format, including the problem statement, proposed solution, consequences, and decision rationale. This helps teams document architectural choices clearly and consistently over time.
When to use it
- Documenting technical debt: Use it when refactoring existing code or addressing known limitations in a system.
- Evaluating new technologies: Capture the considerations and trade-offs when choosing between different frameworks or libraries.
- Standardizing design patterns: Formalize recurring architectural choices to ensure consistency across projects.
- Onboarding new team members: Provide clear records of past decisions, reducing knowledge silos and accelerating onboarding.
Key capabilities
- Generates ADR documents in a standardized format.
- Includes sections for problem statement, solution, consequences, and rationale.
- Facilitates consistent documentation of architectural choices.
Example prompts
- "Create an ADR about choosing between REST and GraphQL APIs for our new service."
- "Generate an ADR outlining the decision to migrate from MongoDB to PostgreSQL."
- "Write an ADR documenting why we selected React over Angular for the frontend."
Tips & gotchas
The quality of the generated ADR depends heavily on the clarity and detail provided in the prompt. Be specific about the context, problem, and potential solutions you want the skill to consider.
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.