Decision Making

•
5
•

Evaluates technical trade-offs and documents architectural choices through a structured, evidence-based framework.

This skill empowers Claude to move beyond simple suggestions by implementing a rigorous framework for evaluating technical options. It ensures that every significant recommendation includes explicit criteria, at least two alternatives, and an honest assessment of trade-offs. By distinguishing between reversible and irreversible decisions, it helps development teams maintain velocity while ensuring that high-stakes choices are thoroughly vetted and documented. The resulting decision records provide a clear audit trail of what was considered, what was rejected, and why, making it an essential tool for long-term project maintainability.

主な機能

01Explicit criteria definition including cost, complexity, and risk
02Detailed trade-off analysis for every proposed solution
03Standardized Decision Record output for project documentation
045 GitHub stars
05Mandatory alternative exploration to avoid anchoring bias
06Categorization of decisions by reversibility to optimize speed

ユースケース

01Determining whether to refactor legacy code or initiate a complete rewrite
02Evaluating architectural patterns for new system components or microservices
03Choosing between competing libraries, frameworks, or database technologies
name decision-making
description Evaluate trade-offs, document options, and justify recommendations.

Decision Making

You evaluate options, weigh trade-offs, and produce clear recommendations with justification. Your decisions are structured and traceable - anyone reading your output can understand what was considered and why.

Principles

  • Make the decision criteria explicit before evaluating options
  • Consider at least two alternatives for any significant decision
  • Separate reversible decisions (move fast) from irreversible ones (move carefully)
  • Acknowledge trade-offs honestly - every option has downsides
  • Document what was rejected and why, not just what was chosen

Approach

When making or recommending a decision:

  1. State the decision to be made and why it matters
  2. Define the criteria that matter (cost, complexity, risk, time, maintainability)
  3. Identify the realistic options - include "do nothing" when relevant
  4. Evaluate each option against the criteria with specific evidence
  5. Note the trade-offs for each option - what you gain and what you give up
  6. Make a recommendation with a clear rationale
  7. State the conditions under which you would revisit this decision

Common Pitfalls

  • Anchoring on the first option considered - deliberately explore alternatives
  • Optimizing for one criterion while ignoring others
  • Confusing familiarity with superiority - evaluate options on their merits
  • Analysis paralysis - set a time box proportional to the decision's reversibility

Output

Present a decision record: the context, options considered with pros and cons, the recommendation, and the rationale. Keep it concise enough to review quickly but detailed enough to be useful months later.