Master ADR Authoring: AI Agent Skills for Claude & Codex

Master ADR Authoring: AI Agent Skills for Claude & Codex

This AI agent skill assists technical teams in writing, reviewing, and maintaining Architecture Decision Records (ADRs) with clarity and consistency. Geared towards users of Claude Code and Codex, this skill ensures the documentation of design decisions remains comprehensive and organized, emphasizing the contexts, alternatives, and lifecycle governance involved.

What this skill does

• Facilitates the creation of ADRs to capture design rationale and alternative considerations for consequential technical decisions.
• Maintains a structured format for ADRs that includes temporal context, confirming links, and enforceable architectural constraints.
• Organizes ADRs into a pyramid mapping, aiding in navigation and providing clarity on current and past decisions.
• Guides ADRs through a defined lifecycle, from Initiating to Sunsetting, ensuring comprehensive documentation over time.

Who it is for

• Software developers and engineers using AI coding agents, such as Claude Code, Cursor, and Codex.
• Technical teams responsible for architectural governance and documentation.
• Project managers ensuring team decisions are properly archived and accessible.

Use cases

• Documenting the decision-making process for new architectural changes in a software project.
• Reviewing past decisions to understand the evolution of system architecture.
• Providing rationale and context for technical decisions to stakeholders and new team members.

Technical details

• Compatible with and extends capabilities of Claude Code and Codex for ADR authoring.
• Supports the ADR-to-Pyramid mapping structure, organizing ADRs by navigation index, active status, and superseded status.
• Processes ADRs through stages: Initiating, Researching, Evaluating, Implementing, Maintaining, and Sunsetting.

Source & Licence

This package is built on open-source work published by magnus919 (magnus919/agent-skills) and distributed under MIT. The original licence text and copyright notice are included in your download.

Personal and commercial use, modification and redistribution are permitted, provided the original copyright and licence notice are retained.

Your purchase covers curation, licence verification, packaging, documentation and instant delivery. It does not grant exclusive rights to the underlying open-source code, which remains available under its original licence.

Delivery & Support

• Delivery: instant — a secure download link is emailed to you as soon as payment is confirmed.
• Format: ZIP archive containing the skill files, documentation and the original licence.
• Support: support@mcpcart.com — we aim to reply within 2 business days.
• Updates: updates are included only where stated on this page.

Refunds

This is a digital product delivered immediately after purchase. By completing your order you request immediate delivery and acknowledge that, once the download has been accessed, the statutory right to cancel no longer applies to the extent permitted by law. Refund requests are handled in accordance with our published Refund Policy.

Claude, Codex, Gemini and Cursor are trademarks of their respective owners. MCP Cart is an independent marketplace and is not affiliated with, endorsed by, or sponsored by any of them. Compatibility references describe interoperability only.