What format does this skill use for ADRs?

The skill uses the MADR (Markdown Architectural Decision Records) format, which is a lean and structured template designed to capture the context and rationale behind architectural decisions.

Does this skill help with organizing existing ADRs?

Absolutely. It automatically maintains a README index in your docs/adr directory, handles sequential numbering, and validates paths to ensure your documentation remains organized.

Can it handle different types of technical decisions?

Yes, it includes four specific templates: technology-selection, architecture-pattern, process-change, and deprecation to ensure the right information is captured for each scenario.

How do I start creating a new ADR?

You can trigger the skill by using the /adr command followed by your topic, or by mentioning keywords like 'Architecture Decision' or 'Design Decision' during your conversation.

ADR Creator

Name: ADR Creator
Author: thkt

bythkt

•

协作工具

Generates and manages structured Architecture Decision Records (ADRs) using the MADR format through an automated 6-phase workflow.

关于

This skill streamlines the architectural decision-making process by guiding users through a comprehensive 6-phase workflow to create, validate, and index Architecture Decision Records (ADRs). By enforcing the Markdown Architectural Decision Records (MADR) format, it ensures that all technical choices—from technology selection to deprecation—are documented with clear context, alternatives, and consequences. The skill automatically handles duplicate checks, cross-linking, and directory indexing, making it an essential tool for maintaining high-quality technical documentation and team alignment in evolving software projects.

主要功能

3 GitHub stars
Intelligent duplicate detection and cross-linking between related decisions
Automatic directory management and README index generation
Automated 6-phase ADR creation workflow from pre-check to indexing
Specialized templates for technology selection, architecture patterns, process changes, and deprecations
Built-in validation for MADR compliance and required sections

使用场景

Documenting the rationale and alternatives when choosing a specific framework or library
Managing the deprecation of legacy systems with structured migration plans and consequences
Recording changes to team development processes, workflows, or coding standards

关于

主要功能

3 GitHub stars
Intelligent duplicate detection and cross-linking between related decisions
Automatic directory management and README index generation
Automated 6-phase ADR creation workflow from pre-check to indexing
Specialized templates for technology selection, architecture patterns, process changes, and deprecations
Built-in validation for MADR compliance and required sections

使用场景

Documenting the rationale and alternatives when choosing a specific framework or library
Managing the deprecation of legacy systems with structured migration plans and consequences
Recording changes to team development processes, workflows, or coding standards