ADR Writer
Creates and edits Architecture Decision Records (ADRs) following strict, project-specific formatting and content guidelines.
The source repository doesn't declare a license. Check its terms before reusing the code.
Key features
- Guides the use of pseudocode to illustrate concepts instead of implementation-specific code.
- Promotes clear documentation of decision context, trade-offs, and considered alternatives.
- Enforces a strict, predefined ADR structure (Context, Decision, Consequences).
- Follows project-specific conventions by referencing existing ADRs for style.
- Automates ADR numbering and file naming conventions.
Use cases
- Updating an existing ADR to reflect new information or a revised decision.
- Formally documenting a new architectural decision for a project.
- Recording the justification and trade-offs for choosing a specific technology or pattern.
FAQ
When should I use this skill?
Use this skill whenever you need to document a significant technical decision. Activate it with prompts like "create an ADR for our new caching strategy" or "update ADR-005 with new consequences" to maintain a clear and standardized decision log.
How does this skill improve my workflow?
It saves you time by automating tedious tasks like numbering and formatting. By enforcing consistency and guiding you to document context, trade-offs, and alternatives, it improves the clarity and long-term value of your project's architectural history.
What unique capabilities does it provide?
This skill enforces a strict ADR structure, automates file naming conventions, promotes documenting trade-offs, and guides the use of pseudocode instead of implementation-specific code. It also analyzes existing ADRs to match your project's specific style.
What does the ADR Writer skill do?
The ADR Writer skill helps you create and edit Architecture Decision Records (ADRs). It strictly enforces a predefined structure (Context, Decision, Consequences), automates file naming, and ensures your team's technical decisions are documented consistently.
Related skills
Claude Skill Developer Guide
Provides a standardized reference and template for creating high-quality Claude Code plugin skills.
Learning Documentation31,86212 ptsAxiom Getting Started
Guides new users to the most relevant Axiom skills for their project and development focus through an interactive onboarding experience.
Learning Documentation5212 ptsSkill Making
Creates and refines Claude agent skills by providing established best practices, structural guidelines, and development workflows.
Learning Documentation1712 pts