tradeoff-analysis
Use when work must frame the real problem, expose assumptions, compare meaningful options, and explain decisions in beginner-clear language.
SKILL.md.apt/skills/thinking/tradeoff-analysis/SKILL.md
GitHubTradeoff Analysis
Purpose
Produce a reviewable tradeoff analysis outcome that is grounded in repository evidence and explicit about uncertainty.
When to Use
Use for planning, design, implementation review, migration, troubleshooting, or documentation where the task must frame the real problem, expose assumptions, compare meaningful options, and explain decisions in beginner-clear language.
Inputs
- Goal, audience, scope, constraints, and success criteria.
- Relevant source files, contracts, examples, logs, and decisions.
- Known risks, assumptions, dependencies, and approval boundaries.
Process
- Restate the intended outcome and affected audiences.
- Inventory exact current behavior and source-backed constraints.
- Apply the relevant APT principles and identify missing evidence.
- Compare viable options, including compatibility and operational effects.
- Produce the required artifacts: problem statement, desired outcome, constraints, assumptions, options, tradeoffs, decision, and unresolved questions.
- Review solution-first framing, false certainty, hidden constraints, and decisions without measurable outcomes; separate blockers, recommendations, and open questions.
Outputs
A concise recommendation, evidence map, required changes, risks, validation plan, support/documentation impact, and approval status.
Quality Bar
The output is practical, source-backed, audience-aware, testable, reversible where possible, and does not state assumptions as facts.
Domain Checklist
- Treat Tradeoff Analysis as an explicit decision with defined scope, evidence, owner, and validation.
- Compare meaningful alternatives across outcomes, complexity, risk, support, migration, and reversibility.
- State what is verified, what is assumed, and what requires specialist or human approval.
Required Reading
Read the canonical Thinking principle hub, the closest enforceable standard, the applicable checklist, and exact target-repository evidence.