AI Agent Skill for Architecture Decision Records (ADR) Management

AI Agent Skill for Architecture Decision Records (ADR) Management

This skill facilitates the management of Architecture Decision Records (ADR) within your development projects. It provides a structured approach to documenting significant architecture decisions that are costly to reverse, affect multiple components or teams, or involve the rejection of a plausible alternative.

What this skill does

• Creates a new ADR file in the docs/hydraia/adr/ directory following a standardized naming convention (e.g., 0001- .md).
• Assists in versioning decisions by automatically generating the next file number through the directory listing (ls, sort, tail operations).
• Guides users in filling out the ADR template, which includes status, date, context, decision, considered alternatives, and consequences.
• Supports the lifecycle of an ADR by ensuring new decisions supersede older ones appropriately, maintaining honest historical records.
• Ensures ADR references in the Phase 2 spec for review and consistency with the accepted decisions.

Who it is for

• Developers and software architects who need a consistent process for documenting important architectural decisions.
• Teams working with AI coding agents like Claude Code, Cursor, or Codex that require structured decision documentation.
• Project managers overseeing software projects with a significant architectural component.

Use cases

• Documenting pivotal infrastructure choices like data storage solutions or authentication models.
• Recording the rationale behind selecting a specific software framework over alternative options.
• Superseding outdated design decisions with newer, contextually relevant architectures.

Technical details

• Designed for use with AI coding agents such as Claude Code, Cursor, and Codex.
• Utilizes basic file operations (ls, sort, tail) to manage ADR documentation.
• Relies on the simplified MADR-lite format for succinct decision recording.
• Ensures traceability and auditability of architectural decisions through proper documentation and status management.

Source & Licence

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