Skill: Decision Trail

Purpose

Track and document all decisions made by agents, providing transparency into what was decided, why, and what alternatives were considered.

When to Use

• Decision documentation
• Audit requirements
• Stakeholder visibility
• Post-mortem analysis
• Knowledge capture
• Onboarding context

---

Decision Categories

Decision Types

Category	Authority	Examples
Requirements	BA, PO	Story scope, acceptance criteria
Priority	PO	Sprint inclusion, MoSCoW
Technical	Architect, Sr Dev	Architecture, patterns, tools
Process	Orchestrator, EM	Workflow routing, ceremonies
Quality	QA	Test strategy, coverage targets
Deployment	DevOps	Environment, timing, rollback
Escalated	Stakeholder	Scope, budget, timeline

Decision Significance

Level	Criteria	Retention
Critical	Irreversible, high impact	Permanent
Major	Significant scope/direction	2 years
Standard	Normal workflow decisions	1 year
Minor	Low impact, easily changed	90 days

---

Decision Record Structure

Full Decision Record

interface DecisionRecord {
  // Identity
  id: string;                    // DEC-XXX format
  timestamp: string;             // When decided
  session_id: string;            // Workflow session

  // Classification
  category: DecisionCategory;    // requirements, technical, etc.
  significance: Significance;    // critical, major, standard, minor

  // Decision Maker
  agent: string;                 // Agent that made decision
  delegated_by?: string;         // If authority was delegated
  stakeholder_input?: boolean;   // Required stakeholder input

  // Decision Content
  decision_point: string;        // What needed to be decided
  context: string;               // Background and constraints

  options: Array<{
    name: string;
    description: string;
    pros: string[];
    cons: string[];
    rejected_reason?: string;
  }>;

  selected_option: string;       // Which option was chosen
  rationale: string;             // Why this option

  // Impact
  impact: {
    artifacts_created?: string[];
    artifacts_modified?: string[];
    constraints_added?: string[];
    dependencies?: string[];
  };

  // Traceability
  related_tickets: string[];     // Jira tickets
  related_decisions: string[];   // Other decisions
  related_docs: string[];        // Confluence pages

  // Reversibility
  reversible: boolean;
  reversal_cost?: string;        // If reversible, what's the cost
}

---

Decision Documentation

Quick Decision Format

## Decision: {{id}}

**Date:** {{date}}
**Agent:** {{agent}}
**Category:** {{category}}

**Question:** {{decision_point}}

**Decision:** {{selected_option}}

**Why:** {{rationale}}

**Impact:** {{impact_summary}}

Full Decision Format

## Decision Record: {{id}}

### Metadata
| Field | Value |
|-------|-------|
| Date | {{timestamp}} |
| Agent | {{agent}} |
| Category | {{category}} |
| Significance | {{significance}} |
| Workflow | {{workflow}} |

### Context

{{context_description}}

**Constraints:**
{{constraints}}

**Stakeholders:**
{{stakeholders}}

---

### Decision Point

{{decision_point}}

---

### Options Considered

#### Option 1: {{option_1_name}}
{{option_1_description}}

| Pros | Cons |
|------|------|
{{option_1_pros_cons}}

#### Option 2: {{option_2_name}}
{{option_2_description}}

| Pros | Cons |
|------|------|
{{option_2_pros_cons}}

#### Option 3: {{option_3_name}}
{{option_3_description}}

| Pros | Cons |
|------|------|
{{option_3_pros_cons}}

---

### Decision

**Selected:** {{selected_option}}

**Rationale:**
{{rationale}}

**Trade-offs Accepted:**
{{tradeoffs}}

---

### Impact

**Artifacts Created:**
{{created_artifacts}}

**Artifacts Modified:**
{{modified_artifacts}}

**Constraints Added:**
{{new_constraints}}

**Dependencies:**
{{dependencies}}

---

### Reversibility

**Reversible:** {{reversible}}
**Reversal Cost:** {{reversal_cost}}
**Point of No Return:** {{point_of_no_return}}

---

### Related

**Tickets:** {{related_tickets}}
**Decisions:** {{related_decisions}}
**Documentation:** {{related_docs}}

---

Decision Queries

Pending Decisions

## Pending Decisions

Decisions awaiting stakeholder input:

| ID | Question | Agent | Waiting Since | Blocker |
|----|----------|-------|---------------|---------|
{{pending_decisions}}

### Actions Needed
{{action_items}}

Recent Decisions

## Recent Decisions

### Last 24 Hours

| ID | Decision | Agent | Category | Impact |
|----|----------|-------|----------|--------|
{{recent_decisions}}

### Decision Statistics
- Total: {{total}}
- By Agent: {{by_agent}}
- By Category: {{by_category}}

Decision History for Ticket

## Decisions for {{ticket_id}}

### Decision Trail

{{decision_timeline}}

### Key Decisions

1. **{{decision_1}}** - {{agent_1}} - {{date_1}}
   {{summary_1}}

2. **{{decision_2}}** - {{agent_2}} - {{date_2}}
   {{summary_2}}

### Impact Summary
{{total_impact}}

---

Confluence Integration

Decision Log Page

# Decision Log - {{project_name}}

## {{current_month}}

### Week of {{week_start}}

| ID | Date | Decision | Agent | Category | Impact |
|----|------|----------|-------|----------|--------|
{{weekly_decisions}}

---

## Decision Index

### By Category
- [Requirements Decisions](#requirements)
- [Technical Decisions](#technical)
- [Priority Decisions](#priority)

### By Significance
- [Critical Decisions](#critical)
- [Major Decisions](#major)

---

Agents Using This Skill

• All Agents - Log their decisions
• Orchestrator - Decision aggregation
• Software Architect - Technical decisions (ADRs)
• Product Owner - Priority decisions

Related Skills

• observability-activity-log - Activity tracking
• confluence-decision-log - Decision documentation
• generation-adr - Architecture decisions

MCP Tools Used

• Atlassian:createConfluencePage - Decision log pages
• Atlassian:updateConfluencePage - Update logs
• Atlassian:addCommentToJiraIssue - Decision on tickets