Efficient ADR Workflow Tool for Claude Code & Codex

Efficient ADR Workflow Tool for Claude Code & Codex

The Efficient ADR Workflow Tool is designed to assist developers using AI coding agents, such as Claude Code and Codex, in managing Architectural Decision Records (ADRs). This skill automates the lifecycle of ADR management, enabling users to scaffold, accept, index, and link ADRs directly within their projects, ensuring structured documentation of critical architectural decisions.

What this skill does

• Scaffold ADRs: Creates a structured ADR document in the `docs/decisions/` directory, with auto-numbering and slug-collision checks. The initial status is set to "Proposed" in both the frontmatter and the body of the document.
• Accept ADRs: Updates the ADR's status to "Accepted" in an atomic operation, modifying both the frontmatter and the prose line within the document.
• Supersede ADRs: Allows users to document when one ADR supersedes another by appending a reference to the new ADR.
• Index ADRs: Facilitates indexing for easy retrieval and referencing within a development project.
• Link ADRs: Enables linking of ADRs that resolve specific refinement-todo entries, aiding traceability and project management.

Who it is for

This tool is ideal for developers, software architects, and engineering teams who rely on AI coding agents to support their decision-making processes in software development projects. It is especially beneficial for teams seeking a streamlined way to record and manage architectural decisions.

Use cases

• Software teams working on large projects requiring consistent documentation of architectural decisions.
• Development processes where capturing and managing important decisions in a structured manner is crucial.
• Projects that need a straightforward way to formalize and maintain records of changes and decisions for future reference.

Technical details

The Efficient ADR Workflow Tool leverages the capabilities of Claude Code, an AI agent that determines the content of decisions. It integrates directly into projects using Python (`adr.py`), ensuring that ADR management is consistent and automated. It simplifies the documentation process without reliance on external systems, providing an efficient solution for ADR lifecycle management.

Source & Licence

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