Document Intelligence

This skill supports three modes: Create, Update, and Find.

Mode Detection

Signal	Mode	Confidence
"update", "revise", "modify" in input	UPDATE	100%
File path provided (`@path/to/decision.md`)	UPDATE	100%
Decision ID mentioned (`DR-2026-001`)	UPDATE	100%
"create", "new", "record" in input	CREATE	100%
"find", "search", "list decisions"	FIND	100%
"the decision", "that decision"	UPDATE	85%
Just decision topic	CREATE	60%

Threshold: ≥85% auto-proceed | 70-84% state assumption | <70% ask user

Mode Behaviors

CREATE: Generate complete new decision record using template below.

UPDATE:

•Read existing decision (search if path not provided)
•Preserve unchanged sections exactly
•Update status, add new context, modify rationale
•Show diff summary: "Updated: [sections]. Unchanged: [sections]."
•Consider: Should status change (e.g., Proposed → Accepted)?

FIND:

•Search paths below AND context registry for decisions
•Present results: ID, title, date, status, owner
•Ask: "Update one of these, or create new?"

Search Locations for Decision Records

•decisions/
•context/decisions/
•docs/decisions/
•adr/ (architecture decision records)

Create a Decision Record to document a specific decision.

V2V Phase

Phase 2: Strategic Decisions - Decision records document choices made during the commercial filter phase.

Prerequisites: Context understood, options identified Outputs used by: Phase 3 (roadmap, GTM commitments), context registry

Purpose

Decision records capture the context, options, and rationale for important decisions, enabling future teams to understand why decisions were made.

Output Structure

markdown

# Decision Record: [Decision Title]

**Decision ID**: DR-[YYYY]-[NNN]
**Date**: [Date decided]
**Status**: Proposed / Accepted / Superseded / Deprecated
**Accountable Owner**: [Single person/role who can say yes/no]
**Product**: [Product name - optional, for multi-product organizations]

## Context

[Why this decision is needed now. What problem or opportunity prompted this decision? What constraints exist?]

## Decision Drivers

- [Driver 1]: [Description]
- [Driver 2]: [Description]
- [Driver 3]: [Description]

## Options Considered

### Option A: [Name]
**Description**: [What this option entails]

| Pros | Cons |
|------|------|
| [Pro 1] | [Con 1] |
| [Pro 2] | [Con 2] |

**Effort**: Low / Medium / High
**Risk**: Low / Medium / High

### Option B: [Name]
**Description**: [What this option entails]

| Pros | Cons |
|------|------|
| [Pro 1] | [Con 1] |
| [Pro 2] | [Con 2] |

**Effort**: Low / Medium / High
**Risk**: Low / Medium / High

### Option C: [Name]
**Description**: [What this option entails]

| Pros | Cons |
|------|------|
| [Pro 1] | [Con 1] |
| [Pro 2] | [Con 2] |

**Effort**: Low / Medium / High
**Risk**: Low / Medium / High

## Decision Made

**Selected Option**: [Option name]

**Rationale**: [Why this option was chosen over others. What were the key factors that tipped the decision?]

## Customer Value Link (Principle #3)

**Customer Problem**: [What customer problem does this decision address?]
**Customer Benefit**: [How will customers benefit from this decision?]
**Evidence**: [What customer evidence supports this direction?]

*If this decision has no customer value link, document why (internal efficiency, technical debt, etc.)*

## Stakeholders Consulted (Principle #6)

| Stakeholder | Role | Input Provided | Input Incorporated? |
|-------------|------|----------------|---------------------|
| [Name] | [Role] | [Summary of input] | Yes/Partial/No |
| [Name] | [Role] | [Summary of input] | Yes/Partial/No |

**Who should have been consulted but wasn't?** [Names or "None"]
**Why?** [Reason if applicable]

## Key Assumptions

| Assumption | Confidence | Validation Method | If Wrong |
|------------|------------|-------------------|----------|
| [Assumption 1] | High/Med/Low | [How we'll know] | [Impact] |
| [Assumption 2] | High/Med/Low | [How we'll know] | [Impact] |

## Success Criteria

| Metric | Target | Timeframe | How Measured |
|--------|--------|-----------|--------------|
| [Metric 1] | [Target] | [When] | [Method] |
| [Metric 2] | [Target] | [When] | [Method] |

## Re-decision Trigger

This decision should be revisited if:
- [Condition 1]
- [Condition 2]
- [Condition 3]

## Implementation Notes

[Any specific guidance for implementing this decision]

## Contributors

| Name | Role | Contribution |
|------|------|--------------|
| [Name] | [Role] | Accountable |
| [Name] | [Role] | Input provided |
| [Name] | [Role] | Consulted |

## Related Decisions

- [Link to related decision record]

Instructions

•Ask clarifying questions about the decision if context is unclear
•Check prior context: Run /context-recall [topic] to find related past decisions
•Reference any relevant documents provided via @file syntax
•Ensure there's a single accountable owner
•Include measurable success criteria
•Define clear re-decision triggers
•Save in decisions/ folder
•Offer to create presentation version using /present

Context Integration

After generating the decision record:

•Offer to save: Ask "Should I save this to the context registry? (/context-save)"
•
If yes, extract and save:
- •Decision ID, title, date, owner, status to context/decisions/index.md
- •Tags (auto-generate 3-5 keywords from content)
- •Assumptions to context/assumptions/registry.md
- •Full record to context/decisions/[YYYY]/[DR-ID].md
•Link to related decisions if mentioned