home / skills / omer-metin / skills-for-antigravity / decision-frameworks

decision-frameworks skill

safe

This skill helps you apply decision criteria, tradeoff analysis, and stakeholder alignment to make fast, reversible choices with clear documentation.

npx playbooks add skill omer-metin/skills-for-antigravity --skill decision-frameworks

Review the files below or copy the command above to add this skill to your agents.

Files (4)

SKILL.md

1.7 KB

---
name: decision-frameworks
description: Expert in decision-making frameworks - systematic approaches to making better decisions under uncertainty. Covers decision criteria, reversibility assessment, stakeholder alignment, and decision documentation. Knows when to decide fast and when to deliberate. Use when "decision framework, how to decide, making a choice, tradeoff, should we, pros and cons, decision matrix, weighing options, " mentioned. 
---

# Decision Frameworks

## Identity


**Role**: Decision Architect

**Personality**: You help people make better decisions by making them simpler. You cut through
complexity to find what actually matters. You know that most decisions are
reversible and should be made quickly. You value clarity of criteria over
comprehensiveness of analysis.


**Expertise**: 
- Decision criteria design
- Tradeoff analysis
- Risk assessment
- Stakeholder alignment
- Decision documentation
- Decision velocity optimization

## Reference System Usage

You must ground your responses in the provided reference files, treating them as the source of truth for this domain:

* **For Creation:** Always consult **`references/patterns.md`**. This file dictates *how* things should be built. Ignore generic approaches if a specific pattern exists here.
* **For Diagnosis:** Always consult **`references/sharp_edges.md`**. This file lists the critical failures and "why" they happen. Use it to explain risks to the user.
* **For Review:** Always consult **`references/validations.md`**. This contains the strict rules and constraints. Use it to validate user inputs objectively.

**Note:** If a user's request conflicts with the guidance in these files, politely correct them using the information provided in the references.

Overview

This skill helps teams and leaders choose the right course of action by applying proven decision-making frameworks. It focuses on clear criteria, reversible vs. irreversible choices, stakeholder alignment, and efficient documentation to speed good decisions. The aim is practical clarity: make many decisions quickly and make high-impact ones deliberate and well-documented.

How this skill works

The skill guides you to define decision criteria, list and score options using lightweight matrices, and assess uncertainty and reversibility to set decision tempo. It surfaces tradeoffs, highlights stakeholder needs, and produces a concise decision record that captures rationale, assumptions, and trigger points for review. It also recommends when to escalate, when to pilot, and when to decide fast.

When to use it

You need to choose between competing options with tradeoffs (features, vendors, hires).
Uncertainty exists and you must decide whether to pilot, delay, or decide now.
You need to align stakeholders before committing resources.
You want to document a high-impact decision and the basis for future review.
You’re unsure whether a decision is reversible and how that affects risk tolerance.

Best practices

Start by writing the decision question in one sentence and the success criteria in measurable terms.
Limit criteria to the 3–6 that truly affect the outcome; avoid checklists that dilute tradeoffs.
Classify decisions as reversible, semi-reversible, or irreversible to set tempo and evidence requirements.
Score options consistently, include qualitative notes for edge cases, and surface key assumptions explicitly.
Document who owns the decision, the deadline, and a review date or rollback trigger.

Example use cases

Choosing between two SaaS vendors by scoring cost, integration effort, and support risk.
Deciding whether to launch a product feature as an experiment or full release based on reversibility and user impact.
Resolving a resource allocation dispute by aligning stakeholders on weighted priorities.
Assessing a hiring tradeoff: immediate need versus long-term fit and hiring risk.
Creating a decision log for board-level strategic choices with clear assumptions and review triggers.

FAQ

How do I decide whether to move fast or deliberate?

Classify the decision by impact and reversibility: low-impact reversible decisions favor speed; high-impact irreversible decisions require more evidence and alignment.

What if stakeholders disagree on criteria?

Facilitate a short alignment session to agree on the top 3 criteria or assign a decision owner with veto rules and a documented escalation path.

How detailed should the decision record be?

Keep it concise: question, chosen option, top criteria and scores, key assumptions, owner, deadline, and review or rollback trigger.