adr-writer

Name: adr-writer
Availability: InStock
Author: shakhovskiya-create

Generate MADR-style Architecture Decision Records and update the index automatically.

Updated May 5, 2026

Search Tags:#architecture #documentation #adr #software-design #madr #decision-record

Ready to run

npx skills add https://github.com/shakhovskiya-create/shakhoff-claude-marketplace --skill adr-writer-shakhovskiya-create

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: adr-writer
Source: https://github.com/shakhovskiya-create/shakhoff-claude-marketplace/tree/main/plugins/solo-sdlc/skills/adr-writer
Command: npx skills add https://github.com/shakhovskiya-create/shakhoff-claude-marketplace --skill adr-writer-shakhovskiya-create

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ADR writer helps teams capture the rationale, context, and trade-offs behind architectural decisions, ensuring decisions are documented and future maintenance understands the reasoning.

Core Features & Use Cases

Generate MADR-style ADRs for major architecture choices (databases, frameworks, deployment patterns).
Maintain an organized ADR directory with proper numbering and linking to related work.
Update ADR index automatically when new ADRs are added.

Quick Start

Draft an ADR for your next architectural decision and store it under docs/architecture/adr/NNNN-decision-slug.md.

Frequently Asked Questions about adr-writer

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

FAQPage Schema

How do I document architectural decisions for databases and frameworks?▼

To document architectural decisions for databases and frameworks, you can generate MADR-style ADRs that capture context, options, and rationale. This ensures consistent documentation standards and traceability for future maintenance.

What is an architecture decision record and when do I need one?▼

An architecture decision record (ADR) captures the rationale, context, and trade-offs behind meaningful software architecture choices. You need an ADR when making non-trivial decisions across databases, frameworks, and deployment patterns to ensure reasoning is documented.

How does automatic ADR indexing work for software design documentation?▼

Automatic ADR indexing works by writing MADR-style decision records into docs/architecture/adr/NNNN-decision-slug.md files and automatically updating the ADR index when new records are added, maintaining an organized directory with proper numbering and linking.

What is the best way to maintain an organized ADR directory with proper numbering?▼

The best way to maintain an organized ADR directory is to automate creation and indexing of architecture decision records. This approach writes files with proper numbering and automatically updates the index when new ADRs are added.

Can I use MADR-style templates for deployment pattern decisions?▼

Yes, you can use MADR-style templates for deployment pattern decisions. The ADR writer supports non-trivial decisions across deployment patterns, capturing context, options, and rationale while ensuring consistent documentation standards.