CtrlK
BlogDocsLog inGet started
Tessl Logo

decision-capture

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

68

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

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 . Rationale: ." 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 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
Repository
nearai/ironclaw
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.