Architecture-Change-Record

Document architecture decisions in MADR format with risk analysis and diagrams.

Updated Apr 28, 2026

Search Tags:#architecture #documentation #diagram #risk-analysis #madr #decision-record

Ready to run

npx skills add https://github.com/garrardkitchen/skills --skill architecture-change-record

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: Architecture-Change-Record
Source: https://github.com/garrardkitchen/skills/tree/main/architecture-change-record
Command: npx skills add https://github.com/garrardkitchen/skills --skill architecture-change-record

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables teams to capture architectural decisions in a consistent MADR-based format, including risk analysis, visual diagrams, and an organized folder/index structure to preserve decisions over time.

Core Features & Use Cases

MADR-based decision records for architecture decisions and changes
Diagram generation and visualization for current and proposed architectures
Integrated risk analysis and trade-off documentation
Folder structure documentation and automatic index management
Governance-friendly auditing and historical traceability

Quick Start

Create an Architecture Change Record to document a major architectural decision.

Frequently Asked Questions about Architecture-Change-Record

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

FAQPage Schema

How do I document architectural decisions using the MADR format?▼

You document architectural decisions by creating a record that applies the MADR format to capture context, trade-offs, and automated risk analysis. This skill structures the decision, generates architecture diagrams, and maintains the documentation index.

What is the best way to track system-wide architecture changes for governance auditing?▼

Tracking system-wide architecture changes for governance auditing is best handled by formal decision records. This skill ensures historical traceability by organizing records into a structured folder and maintaining an automated index for easy review.

How do I generate diagrams for proposed architecture migrations?▼

To generate diagrams for proposed architecture migrations, you document the change using this skill. It produces visual diagrams representing both current and proposed architectures directly within the formal decision record file.

Can I include risk analysis and trade-off documentation in my architecture decision records?▼

Yes, you can include risk analysis and trade-off documentation in your architecture decision records. This skill integrates enhanced risk analysis directly into the MADR format to ensure trade-offs are formally captured alongside the diagrams.

Does this architecture documentation skill manage the folder structure and index automatically?▼

Yes, this architecture documentation skill manages the folder structure and index automatically. When you create an architecture decision record, it updates the folder organization and maintains the index to preserve decisions over time.