sysdesign-tradeoff-framing

Articulate architectural tradeoffs and record decisions in a structured ADR format.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/danilods/matilha-sysdesign-pack --skill sysdesign-tradeoff-framing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sysdesign-tradeoff-framing
Source: https://github.com/danilods/matilha-sysdesign-pack/tree/main/skills/sysdesign-tradeoff-framing
Command: npx skills add https://github.com/danilods/matilha-sysdesign-pack --skill sysdesign-tradeoff-framing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Articulates and records explicit architectural tradeoffs to prevent hand-waving decisions.

Core Features & Use Cases

  • Enforces a structured ADR workflow for two options and ties decisions to NFR priorities.
  • Documents the binding constraint and explicit reasoning to create a replayable decision.
  • Produces an ADR that preserves rejected options for future context and establishes a revisit trigger.

Quick Start

Draft an ADR that states the decision between two options, lists what each gives and costs, cites the relevant NFR priorities, and includes a revisit trigger.

Frequently Asked Questions about sysdesign-tradeoff-framing

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

FAQPage Schema
How do I document system design tradeoffs to prevent hand-waving architecture decisions?

To document system design tradeoffs, articulate explicit architectural options and record them using an Architecture Decision Record (ADR) format that captures per-option costs and benefits to prevent hand-waving decisions.

What is an ADR format that aligns architectural decisions with NFR priorities?

An ADR format aligned with NFR priorities includes a decision sentence, per-option gives and costs, a binding constraint, cited non-functional requirements, and a revisit trigger to ensure replayable architectural reasoning.

How to write an architecture decision record for scalability and availability tradeoffs?

Write an architecture decision record by framing two viable options across domains like scalability, availability, latency, and cost, then document the binding constraint and explicit reasoning to create a replayable decision.

When do I need to cite NFR priorities in a system design tradeoff decision?

You need to cite NFR priorities in a system design tradeoff decision whenever you are choosing between at least two viable options, ensuring the binding constraint reflects your non-functional requirement priorities.

Does this approach to architectural tradeoffs preserve rejected options for future context?

Yes, this approach to architectural tradeoffs produces an ADR that preserves rejected options for future context and establishes a revisit trigger to re-evaluate the decision when conditions change.

What should an architecture decision record include to make a replayable system design choice?

To make a replayable system design choice, an architecture decision record should include a decision sentence, per-option gives and costs, a binding constraint, cited NFR priorities, and a revisit trigger.