making-decisions

# Decision Ledger

This skill guides the creation of explicit decisions with full trade-off documentation.

## Prerequisites

- Synthesis complete (`/ledger-synthesize`)
- `03-synthesis/CROSS-SYNTHESIS.md` exists with decision candidates
- Per-pillar syntheses in `03-synthesis/SYN-*.md`

## Workflow

Use TodoWrite to track these mandatory steps:

<required>
1. Load decision candidates from cross-synthesis
2. For each candidate, gather evidence and options
3. Present trade-offs for user decision
4. Create decision entry with semantic ID
5. Identify risks created by each decision
6. Generate DECISIONS.yaml and RISKS.yaml
7. Validate decision quality gates
</required>

### Step 1: Load Decision Candidates

Read `03-synthesis/CROSS-SYNTHESIS.md` to extract:
- Decision topics needing resolution
- Supporting evidence from each pillar
- Identified options

### Step 2: Gather Evidence per Decision

For each decision candidate:
- Collect all relevant EV-* IDs
- Summarize what evidence supports each option
- Note confidence levels

```yaml
decision_candidate:
  topic: target-segment-priority
  options:
    - name: SMB-first
      evidence:
        - EV-users-smb-pain-points (0.80)
        - EV-economics-smb-unit-economics (0.75)
    - name: Enterprise-first
      evidence:
        - EV-market-enterprise-tam (0.85)
        - EV-competitors-enterprise-gap (0.70)
```

### Step 3: Present Trade-offs

For each decision, present:
- Options with evidence support
- What you win with each option
- What you lose with each option
- Risks created by each option

Use **AskUserQuestion** to get user's decision.

### Step 4: Create Decision Entry

Write entry to `04-decisions/DECISIONS.yaml` using schema from [references/decision-ledger-schema.md](references/decision-ledger-schema.md).

<good-example>
```yaml
- id: DEC-scope-smb-first
  decision: "Target SMB segment before enterprise"
  status: accepted
  owner: user
  created_at: 2026-01-21
  alternatives:
    - Enterprise-first
    - Mult