AI-Powered ADR Writer: Automate Your Design Decisions

AI-Powered ADR Writer: Automate Your Design Decisions

The AI-Powered ADR Writer skill captures and documents architectural design decisions as Architectural Decision Records (ADRs) within a repository’s docs/adr/ directory. It determines whether a decision qualifies for an ADR, or should be documented as a note or within the commit body. This skill streamlines the recording process by automating the directory detection, sequence numbering, and index updating within the repository, while the main loop is responsible for writing the decision prose.

What this skill does

• Evaluates if a design decision meets the criteria for an ADR, including being hard to reverse and surprising without context.
• Automates the recording of design decisions with a consistent ADR structure, managing boilerplate tasks such as directory detection, file numbering, and index updates.
• Operates a main loop to handle decision writing, separating decision-making from rendering outputs.
• Includes an evidence script to verify the fidelity of the recorded decision.

Who it is for

• Developers working with AI coding agents such as Claude Code, Cursor, and Codex.
• Software development teams aiming to improve the documentation consistency of their design decisions.
• Technical leads and architects requiring a systematic approach to recording complex design choices.

Use cases

• Coding teams seeking to maintain a clear and organized record of design decisions at project repositories.
• Development environments where automated documentation of irreversible design choices helps streamline software maintenance.
• Projects requiring a traceable history of architectural changes and decisions for auditing and review purposes.

Technical details

• Functions as an AI agent skill compatible with Claude Code, Cursor, and Codex.
• Employs agent-knowledge-cycle, aiapplication, and adr-writer tools to facilitate decision record management.
• Ensures decision records are consistently numbered and indexed in the intended directory.

Source & Licence

This package is built on open-source work published by shimo4228 (shimo4228/akc-cycle) 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.