Atlassian Confluence expert for creating and managing spaces, knowledge bases, and documentation. Configures space permissions and hierarchies, creates page templates with macros, sets up documentation taxonomies, designs page layouts, and manages content governance. Use when users need to build or restructure a Confluence space, design page hierarchies with permission structures, author or standardise documentation templates, embed Jira reports in pages, run knowledge base audits, or establish documentation standards and collaborative workflows.
Master-level expertise in Confluence space management, documentation architecture, content creation, macros, templates, and collaborative knowledge management.
Primary Tool: Confluence MCP Server
Key Operations:
// Create a new space
create_space({ key: "TEAM", name: "Engineering Team", description: "Engineering team knowledge base" })
// Create a page under a parent
create_page({ spaceKey: "TEAM", title: "Sprint 42 Notes", parentId: "123456", body: "<p>Meeting notes in storage-format HTML</p>" })
// Update an existing page (version must be incremented)
update_page({ pageId: "789012", version: 4, body: "<p>Updated content</p>" })
// Delete a page
delete_page({ pageId: "789012" })
// Search with CQL
search({ cql: 'space = "TEAM" AND label = "meeting-notes" ORDER BY lastModified DESC' })
// Retrieve child pages for hierarchy inspection
get_children({ pageId: "123456" })
// Apply a label to a page
add_label({ pageId: "789012", label: "archived" })
Integration Points:
See also:
MACROS.mdfor macro syntax reference,TEMPLATES.mdfor full template library,PERMISSIONS.mdfor permission scheme details.
Best Practices:
Recommended Structure:
Space Home
├── Overview & Getting Started
├── Team Information
│ ├── Team Members & Roles
│ ├── Communication Channels
│ └── Working Agreements
├── Projects
│ ├── Project A
│ │ ├── Overview
│ │ ├── Requirements
│ │ └── Meeting Notes
│ └── Project B
├── Processes & Workflows
├── Meeting Notes (Archive)
└── Resources & References
Article Types:
Quality Standards:
Full macro reference with all parameters: see
MACROS.md.
Info, Note, Warning, Tip:
{info}
Important information here
{info}
Expand:
{expand:title=Click to expand}
Hidden content here
{expand}
Table of Contents:
{toc:maxLevel=3}
Excerpt & Excerpt Include:
{excerpt}
Reusable content
{excerpt}
{excerpt-include:Page Name}
Jira Issues:
{jira:JQL=project = PROJ AND status = "In Progress"}
Jira Chart:
{jirachart:type=pie|jql=project = PROJ|statType=statuses}
Recently Updated:
{recently-updated:spaces=@all|max=10}
Content by Label:
{contentbylabel:label=meeting-notes|maxResults=20}
Status:
{status:colour=Green|title=Approved}
Task List:
{tasks}
- [ ] Task 1
- [x] Task 2 completed
{tasks}
User Mention:
@username
Date:
{date:format=dd MMM yyyy}
Two-Column Layout:
{section}
{column:width=50%}
Left content
{column}
{column:width=50%}
Right content
{column}
{section}
Panel:
{panel:title=Panel Title|borderColor=#ccc}
Panel content
{panel}
Code Block:
{code:javascript}
const example = "code here";
{code}
Full template library with complete markup: see
TEMPLATES.md. Key templates summarised below.
| Template | Purpose | Key Sections |
|---|---|---|
| Meeting Notes | Sprint/team meetings | Agenda, Discussion, Decisions, Action Items (tasks macro) |
| Project Overview | Project kickoff & status | Quick Facts panel, Objectives, Stakeholders table, Milestones (Jira macro), Risks |
| Decision Log | Architectural/strategic decisions | Context, Options Considered, Decision, Consequences, Next Steps |
| Sprint Retrospective | Agile ceremony docs | What Went Well (info), What Didn't (warning), Action Items (tasks), Metrics |
Full permission scheme details: see
PERMISSIONS.md.
Public Space:
Team Space:
Project Space:
Review Cycles:
Archiving Strategy:
Content Quality Checklist:
When to Escalate to Atlassian Admin:
When to Collaborate with Jira Expert:
When to Support Scrum Master:
When to Support Senior PM:
FROM Senior PM:
TO Senior PM:
FROM Scrum Master:
TO Scrum Master:
WITH Jira Expert:
Organization:
Maintenance:
Usage Metrics:
Health Indicators:
project-management/jira-expert/) — Jira issue macros and linking complement Confluence docsproject-management/atlassian-templates/) — Template patterns for Confluence content creation