Skill: Confluence Decision Log

Purpose

Record all significant decisions made during the project in a central, searchable log.

When to Use

• Stakeholder makes a business decision
• Technical decision is finalized
• Scope or priority decision is made
• Any decision that affects project direction

MCP Tools Used

Tool	Purpose
Atlassian:createConfluencePage	Create decision log page (if not exists)
Atlassian:updateConfluencePage	Add new decisions to existing log
Atlassian:getConfluencePage	Read current decision log
Atlassian:searchConfluenceUsingCql	Find decision log page

Configuration

{
  "cloudId": "{{confluence.cloudId}}",
  "spaceId": "{{confluence.spaceId}}",
  "spaceKey": "{{confluence.spaceKey}}"
}

Decision Log Format

Page Structure

# Decision Log - {{project.name}}

This page tracks all significant decisions made during the project.

---

## 2025-01-06 - [Decision Title]

**Decision:** [What was decided]

**Made By:** [Stakeholder / Agent name]

**Context:** [Why this decision was needed]

**Alternatives Considered:**
- [Option A] - [Why not chosen]
- [Option B] - [Why not chosen]

**Impact:** [What this affects]

**Related:**
- Jira: [PROJECT-XX]
- Confluence: [Link to spec]

---

## 2025-01-05 - [Previous Decision]

...

Decision Entry Template

When adding a new decision:

## {{date}} - {{title}}

**Decision:** {{decision}}

**Made By:** {{decisionMaker}}

**Context:** {{context}}

**Alternatives Considered:**
{{#each alternatives}}
- {{option}} - {{reason}}
{{/each}}

**Impact:** {{impact}}

**Related:**
- Jira: {{jiraTicket}}

Example: Log a Decision

// First, find or create the decision log page
const searchResult = await Atlassian:searchConfluenceUsingCql({
  cloudId: "{{confluence.cloudId}}",
  cql: "space = '{{confluence.spaceKey}}' AND title = 'Decision Log'"
});

// If exists, update it; if not, create it
if (searchResult.results.length > 0) {
  // Get current content and append
  const page = await Atlassian:getConfluencePage({
    cloudId: "{{confluence.cloudId}}",
    pageId: searchResult.results[0].id
  });

  const newEntry = `
## 2025-01-06 - Dark Mode Implementation Approach

**Decision:** Use CSS custom properties with prefers-color-scheme media query

**Made By:** Marcel (Stakeholder)

**Context:** Needed to decide on technical approach for dark mode feature

**Alternatives Considered:**
- Separate CSS files - More maintenance overhead
- JavaScript toggle only - Doesn't respect system preference

**Impact:** Affects all UI components, styling architecture

**Related:**
- Jira: MDDEV-123
- Confluence: [Dark Mode Technical Spec]

---

`;

  await Atlassian:updateConfluencePage({
    cloudId: "{{confluence.cloudId}}",
    pageId: page.id,
    body: newEntry + page.body
  });
}

Used By Agents

• Orchestrator - Logs stakeholder decisions
• Software Architect - Logs technical decisions (may also use ADR)
• Product Owner - Logs priority/scope decisions
• All Agents - Reference for decision history