Create Adr
Automatically generates Architecture Decision Records (ADRs) from project context, streamlining documentation and design rationale.
Install on your platform
We auto-selected Claude Code based on this skill’s supported platforms.
Run in terminal (recommended)
claude mcp add smartworkx-create-adr npx -- -y @trustedskills/smartworkx-create-adr
Or manually add to ~/.claude/settings.json
{
"mcpServers": {
"smartworkx-create-adr": {
"command": "npx",
"args": [
"-y",
"@trustedskills/smartworkx-create-adr"
]
}
}
}Requires Claude Code (claude CLI). Run claude --version to verify your install.
About This Skill
What it does
The smartworkx-create-adr skill automates the creation of Architecture Decision Records (ADRs). It generates ADR files with a standardized template, including sections for context, decision, consequences, and status. This helps teams document important technical decisions in a consistent and maintainable way.
When to use it
- When starting a new project and needing to quickly establish architectural guidelines.
- During design reviews where key choices need to be formally recorded.
- To ensure all team members understand the reasoning behind specific technical implementations.
- When refactoring existing codebases to document past decisions and their rationale.
Key capabilities
- Generates ADR files with a predefined template.
- Standardizes documentation of architectural decisions.
- Facilitates consistent record-keeping for technical choices.
Example prompts
- "Create an ADR about choosing React over Angular for the frontend."
- "Generate a new ADR documenting our decision to use microservices architecture."
- “Draft an ADR outlining the rationale behind selecting PostgreSQL as our database.”
Tips & gotchas
The skill assumes familiarity with Architecture Decision Record (ADR) principles. While it provides a template, users should ensure the content accurately reflects the actual decision and its implications.
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.