skills.rest
sortie-ai
sortie-aiOFFICIAL
Explore all skills by this author โ†’
WebsiteGitHub

managing-adrs

Create and validate MADR 4.0 Architecture Decision Records with required frontmatter.

121|10|Updated Mar 17, 2026
Search Tags:#automation#template#architecture#documentation#adr#readme#madr
One-click install
npx skills add https://github.com/sortie-ai/sortie --skill managing-adrs
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: managing-adrs
Source: https://github.com/sortie-ai/sortie/tree/main/.github/skills/managing-adrs
Command: npx skills add https://github.com/sortie-ai/sortie --skill managing-adrs

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes scripts (resource) and assets (resource) components.

What problem does it solve?

Coordinate and standardize architecture decisions by creating, updating, and validating Architecture Decision Records (ADRs) in MADR 4.0 format.

Core Features & Use Cases

  • ADR creation from the assets/adr-template.md into docs/decisions/NNNN-kebab-case-title.md with required frontmatter (status, date, decision-makers) and a structured body.
  • ADR lifecycle management: update status, date, and table of contents in docs/decisions/README.md.
  • Validation and guidance: enforce naming, frontmatter, and required sections; support deriving the next ADR number via scripts/next_adr_number.sh.

Quick Start

Create a new ADR using the ADR template and update the docs/decisions/README.md accordingly.

Frequently Asked Questions about managing-adrs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an Architecture Decision Record using the MADR 4.0 format?โ–ผ

To create an Architecture Decision Record, a new ADR file is generated from a template into the docs/decisions/ directory using the MADR 4.0 format, complete with required frontmatter and a structured body.

What frontmatter is required for ADR files in MADR 4.0?โ–ผ

Required frontmatter for ADR files includes status, date, and decision-makers. The validation process enforces these frontmatter conventions whenever new ADRs are created or renamed.

How do I automatically update the ADR index in my documentation?โ–ผ

The ADR index in docs/decisions/README.md is automatically updated with status, date, and table of contents entries after new architecture decision records are created or modified.

What is the best way to manage the ADR lifecycle and status changes?โ–ผ

ADR lifecycle management is handled by updating the status, date, and table of contents directly within the docs/decisions/README.md file to reflect current architecture decisions.

How do I determine the next ADR number for my architecture decisions?โ–ผ

The next ADR number is derived automatically using the scripts/next_adr_number.sh script, ensuring sequential naming for new architecture decision records.

Does this ADR validation enforce naming conventions and required sections?โ–ผ

Yes, ADR validation enforces kebab-case naming, required frontmatter, and structured body sections to ensure all architecture decision records conform to MADR 4.0 standards.

Related Skills

Explore More Software Engineering Skillsโ†’
thktthkt
11

adr

Generate Architecture Decision Records in MADR format with sequential numbering.

Community
Basic
zzafergokzzafergok
1

markdown-to-html-skill

Convert Markdown documents to HTML using marked.js, pandoc, gomarkdown, or static site generators.

Community
Intermediate
kssuminkssumin

doc-enforce

Categorize discussion content into design decisions, solutions, or ADRs and store them under docs/ paths.

Community
Advanced
loriensleafsloriensleafs

adr-review

Coordinate six agents to review Architecture Decision Records and produce MADR 4.0 compliant updates.

Community
Advanced