Where are the ADR files stored in my project?

The skill typically stores ADRs in the docs/decisions/ directory, following a standardized XXXX-short-title.md naming convention.

Can I use this to edit existing ADRs?

ADRs are intended to be immutable records of a point-in-time decision. This skill focuses on creating new records; if a decision changes, you should create a new ADR that supersedes the old one.

What template does this skill use for ADRs?

It uses the MADR (Markdown Architecture Decision Records) template, enhanced with AI-specific sections for implementation guidance.

What are AI-specific extensions in an ADR?

These are metadata fields that specify how much autonomy an AI has when implementing a decision, preferred tools, and specific test expectations for AI agents.

ADR Creator

Name: ADR Creator
Author: cmd-llm

bycmd-llm

•

学习与文档

Standardizes architectural decision-making by generating comprehensive ADRs using the MADR template with AI-specific extensions.

关于

The ADR skill empowers developers to document significant technical choices and their rationales directly within a project's repository. By leveraging the AI-driven MADR (Markdown Architecture Decision Records) template, it ensures that every architectural decision includes necessary context, alternatives considered, and consequences. This skill goes beyond traditional documentation by including AI-specific extensions that define how future AI agents should implement these decisions, specifying autonomy levels and tool preferences to ensure long-term project consistency.

主要功能

Automated MADR template generation with sequential file numbering
Integrated risk assessment for both technical and business impacts
Standardized file naming and directory structure management
AI-specific extensions for defining implementation autonomy and tool preferences
7 GitHub stars
Interactive discovery of architectural context, drivers, and options

使用场景

Creating a permanent record of trade-offs made during a major system refactor
Documenting the selection of a new database, language, or framework
Defining AI agent implementation guidelines for specific project modules

关于

主要功能

Automated MADR template generation with sequential file numbering
Integrated risk assessment for both technical and business impacts
Standardized file naming and directory structure management
AI-specific extensions for defining implementation autonomy and tool preferences
7 GitHub stars
Interactive discovery of architectural context, drivers, and options

使用场景

Creating a permanent record of trade-offs made during a major system refactor
Documenting the selection of a new database, language, or framework
Defining AI agent implementation guidelines for specific project modules