skills.rest
avgarcia
avgarciaCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

adr-creator

Create structured Architecture Decision Records with MADR formatting and index updates.

Updated May 15, 2026
Search Tags:#architecture#documentation#adr#decision records#madr#log4brains
One-click install
npx skills add https://github.com/avgarcia/runcriticon --skill adr-creator-avgarcia
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr-creator
Source: https://github.com/avgarcia/runcriticon/tree/main/.claude/skills/adr-creator
Command: npx skills add https://github.com/avgarcia/runcriticon --skill adr-creator-avgarcia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the repetitive and error-prone work of creating Architecture Decision Records by enforcing the project's ADR structure, numbering, metadata, and documentation conventions.

Core Features & Use Cases

  • ADR Scaffolding: Creates new ADR files with the correct MADR/log4brains format, status, date, sections, and naming conventions.
  • Decision Documentation Workflow: Guides the collection of context, options, decisions, consequences, and related references while preserving project standards.
  • Index Maintenance: Updates the ADR index and handles related documentation such as deferred decisions tracking when required.
  • Use Case: When a team decides to introduce a new architectural pattern or technology choice, use this Skill to generate a properly structured ADR draft instead of writing one manually.

Quick Start

Ask the skill to create a new ADR for the architecture decision you want to document.

Frequently Asked Questions about adr-creator

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

FAQPage Schema
How do I create an Architecture Decision Record using MADR formatting?▼

To create an Architecture Decision Record, you provide the architectural decision context, and the Skill generates a structured MADR draft with correct status, date, sections, and naming conventions.

What is the best way to document software architecture decisions consistently?▼

Documenting software architecture decisions consistently requires enforcing project standards for metadata, structure, and numbering, which this Skill automates by scaffolding ADR files and guiding decision capture.

Does log4brains work with automated ADR generation workflows?▼

log4brains works with automated ADR generation by producing files that adhere to its expected MADR format, ensuring new architecture decision records integrate seamlessly into the documentation index.

How do I update the ADR index when adding a new decision record?▼

Updating the ADR index happens automatically during ADR creation, as the Skill maintains the index and handles related documentation like deferred decisions tracking to preserve project conventions.

What do I need to start scaffolding architecture decision records for my project?▼

Scaffolding architecture decision records requires no dependencies, only your project's architectural context and decision options, which the Skill uses to validate references and format the output.

When should I not use automated ADR scaffolding for decision capture?▼

Automated ADR scaffolding is not suited for decisions lacking clear context or options, as the Skill requires adequate architectural information to properly populate the MADR template and validate related references.

Related Skills

Explore More Software Engineering Skills→
cloudvoyantcloudvoyant

new

Guide interactive creation of Architectural Decision Records as markdown files.

Official
Intermediate
sortie-aisortie-ai
121

managing-adrs

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

Official
Advanced
vanman2024vanman2024
3

Decision Tracking

Create AngularJS, create and manage ADRs with automated numbering and templates.

Community
Basic
bugrabilgebugrabilge
10

architecture-decision-records

Create and manage Architecture Decision Records using multiple templates.

Community
Intermediate