Architecture-Change-Record

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.

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.

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.

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.

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.