# Decision Capture

> Detect decisions in conversation and record them with rationale, alternatives, and outcome tracking.

- Skill: `suyoumo/decision-capture` (Agent Skill)
- Install (CLI): `npx skillmds@latest add suyoumo/decision-capture`
- Raw SKILL.md: https://api.skillmd.com/api/skills/suyoumo/decision-capture/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: suyoumo (https://skillmd.com/u/suyoumo)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/suyoumo/decision-capture

---


# Decision Capture

When a decision is detected in conversation, record it in the commitments workspace. Decisions are durable knowledge — they explain _why_ a path was chosen and enable outcome tracking over time.

## Detection

Look for explicit decision language:
- "We decided to..." / "I'm going with..." / "Let's do X"
- "The call is..." / "We settled on..."
- "I chose X over Y because..."

**Do NOT capture:**
- Brainstorming or hypotheticals: "maybe we should...", "what if we..."
- Preferences without commitment: "I think X is better"
- Questions: "should we go with X?"

When uncertain, ask: "Was that a decision, or still thinking it through?"

## Recording

This skill is only successful if the decision is actually persisted. Do not
just summarize or acknowledge the decision.

Execution order is mandatory:
1. Call `memory_write` for `projects/commitments/decisions/<date>-<slug>.md`
2. If applicable, call `memory_write` for a follow-on commitment in `projects/commitments/open/`
3. If applicable, call `memory_write` for `context/intel/<slug>.md`
4. Only then confirm to the user what was recorded

Never say a decision was "captured", "recorded", or "saved" unless the
corresponding `memory_write` call succeeded.

Write to `projects/commitments/decisions/<date>-<slug>.md` via `memory_write`:

```
---
type: decision
decided_at: <today YYYY-MM-DD>
context: <topic-slug>
participants: [<who was involved>]
confidence: <high if explicit, medium if inferred>
reversible: <true|false>
outcome: null
outcome_positive: null
tags: [<relevant tags>]
---
# <What was decided>

## Context
<Why this decision was needed — 1-2 sentences.>

## Options considered
1. **<Option A>** — <brief pros/cons>
2. **<Option B>** — <brief pros/cons>

## Rationale
<Why this option was chosen.>

## Outcome
<To be filled in later when outcome is known.>
```

## Follow-through

1. If the decision creates an obligation (e.g., "we decided to migrate by Q2"), also create a commitment in `projects/commitments/open/` following the commitment schema.
2. Write an intelligence MemoryDoc to `context/intel/<slug>.md` with a brief summary: "Decided X on <date>. Rationale: <reason>." This makes the decision searchable as durable knowledge.

For explicit requests like "record this decision", "log this decision", or
"note the decision", default to doing all required writes immediately rather
than asking a follow-up question unless the content is genuinely ambiguous.

## Outcome tracking

The triage mission checks for decisions older than 7 days without an outcome. It prompts: "You decided <X> <N> days ago. How did it turn out?" When the user provides an outcome, update the decision file's `outcome` and `outcome_positive` fields.

## Confirmation

After the write(s) succeed, briefly confirm:
- where the decision was written
- whether any follow-on commitment was created
- one-line summary of the rationale