Mastering AI Project Context & Decisions with ADR Skills

Mastering AI Project Context & Decisions with ADR Skills

This skill assists developers and teams using AI coding agents, such as Claude Code, Cursor, and Codex, in effectively managing project context and critical decisions with Architecture Decision Record (ADR) skills. It simplifies the documentation process by establishing structured domain contexts and decision-making protocols.

What this skill does

• Creates and maintains a CONTEXT.md file to govern domain language, supporting the clarification of domain terminology, confirmed ambiguities, and critical concept relationships.
• Facilitates the creation of architecture decision records, where each decision is documented in an individual ADR file within the docs/adr/ directory.
• Includes a thin index docs/adr/README.md listing the ADRs by number, title, status, and link, ensuring a standardized format.
• Applies consistent numbering and status options (proposed, accepted, deprecated, superseded) for each decision record.
• Updates PROJECT_LOG.md to reflect any decision events, ensuring traceability.

Who it is for

This skill is designed for developers, project leads, and technical teams involved in projects where AI coding agents are used, such as Claude Code, Cursor, and Codex.

Use cases

• Clarifying ambiguous domain terms and aligning understanding across development teams in an AI-driven project.
• Documenting architectural decisions in a structured manner to ensure clear rationale and traceability for software design choices.
• Facilitating consistent governance of project context and decisions for effective project management and alignment.

Technical details

• Utilizes context management and decision documentation capabilities provided through files in the source code repository.
• Integration with standard project management tools like GitHub for tracking tasks, statuses, and decision processes.
• Employs structured templates for context and decision record files to ensure consistency and clarity.

Source & Licence

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