Architecture Decision Framework

Generate ADRs, MADRs, Y-statements, and C4 diagrams from requirements.

6|Updated Oct 25, 2025
One-click install
npx skills add https://github.com/williamzujkowski/cognitive-toolworks --skill architecture-decision-framework
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Architecture Decision Framework
Source: https://github.com/williamzujkowski/cognitive-toolworks/tree/main/skills/architecture-decision-framework
Command: npx skills add https://github.com/williamzujkowski/cognitive-toolworks --skill architecture-decision-framework

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture teams need a repeatable, auditable approach to capture decisions, rationale, and trade-offs for complex systems.

Core Features & Use Cases

  • Generate Architecture Decision Records (ADRs) in multiple formats (Nygard, MADR, Y-statement)
  • Perform ATAM-style trade-off analyses and produce actionable pattern recommendations
  • Create C4 model diagrams (context, container, component) to visualize decisions

Quick Start

Ask me to generate an ADR and related analyses from your project context.

Frequently Asked Questions about Architecture Decision Framework

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

FAQPage Schema
What is an Architecture Decision Record and when do I need one?

An Architecture Decision Record (ADR) captures architectural decisions, rationale, and trade-offs. You need ADRs when your project requires traceable, auditable decisions that ensure alignment among stakeholders across complex systems.

How do I generate ADRs from project requirements?

You can generate ADRs by providing your project context and system requirements, which are used to create template-driven architecture decision artifacts in formats like Nygard, MADR, or Y-statement with validated inputs.

What is the best way to perform ATAM-style trade-off analysis?

ATAM-style trade-off analysis evaluates architectural decisions against quality attributes. Apply ATAM methods to your system context to produce actionable pattern recommendations and traceable trade-off assessments for stakeholder alignment.

Can I create C4 model diagrams to visualize architectural decisions?

Yes, you can create C4 model diagrams including context, container, and component views. These visual models map directly to your architectural decisions to help communicate system structure and trade-offs to stakeholders.

What ADR formats are supported for documenting decisions?

Supported ADR formats include Nygard, MADR, and Y-statement templates. Each format provides reproducible structures for capturing decisions, trade-offs, and rationale, allowing you to choose the documentation style that fits your team.

Are there limitations to using ADRs for stakeholder alignment?

ADRs provide traceable documentation but require accurate input validation and consistent maintenance. If your project lacks clear system context or stakeholder engagement, ADRs alone cannot force alignment without reproducible templates and visual models.