design-decision-framework

Evaluates multiple technical design options through structured scoring and risk analysis.

1|Updated Oct 17, 2025
One-click install
npx skills add https://github.com/tarrragon/claude --skill design-decision-framework
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-decision-framework
Source: https://github.com/tarrragon/claude/tree/main/skills/design-decision-framework
Command: npx skills add https://github.com/tarrragon/claude --skill design-decision-framework

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The design-decision-framework provides a structured approach to evaluate multiple technical options to avoid impulsive or biased decisions.

Core Features & Use Cases

  • Structured evaluation: Systematically collect, score, and compare 3+ design options for architecture or system changes.
  • Risk-aware decisioning: Incorporates risk assessment and trade-off analysis to support governance.
  • Decision artifact: Outputs a formal decision record with rationale, owners, and next steps that teams can adopt.

Quick Start

  • Gather all viable design options and context.
  • Define evaluation dimensions and weights, then score each option.
  • Produce a formal decision record with rationale, risks, and a chosen path.

Frequently Asked Questions about design-decision-framework

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

FAQPage Schema
How do I evaluate multiple architecture options to avoid biased design decisions?

To evaluate multiple architecture options and avoid biased design decisions, use a structured framework to systematically collect, score, and compare options against weighted evaluation dimensions. This ensures objective technology choices and mitigates decision paralysis.

What is a structured framework for technology selection and architecture governance?

A structured framework for technology selection is a systematic reference workflow guiding teams through option collection, scoring, and risk analysis. It outputs a formal decision artifact with rationale and owners to support project governance.

How do I create a formal decision record for system architecture changes?

Create a formal decision record for system architecture changes by scoring multiple design options using defined evaluation dimensions. The resulting artifact documents the chosen path, rationale, identified risks, owners, and next steps for team adoption.

Can I use this design decision process without external tools or dependencies?

Yes, you can use this design decision process without external tools or dependencies. It requires no specific environment setup and can be utilized as a standalone reference workflow or embedded directly into existing project governance processes.

What is the best way to incorporate risk analysis into architecture choices?

The best way to incorporate risk analysis into architecture choices is to apply a risk-aware decisioning framework. This involves assessing trade-offs and evaluating specific risks alongside scores for each design option before finalizing a recorded decision.