Atlassian Confluence Expert

Master-level expertise in Confluence space management, documentation architecture, content creation, macros, templates, and collaborative knowledge management.

Atlassian MCP Integration

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: " Meeting notes in storage-format HTML " })

// Update an existing page (version must be incremented)

update_page({ pageId: "789012", version: 4, body: " Updated content " })

// 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

:

Create documentation for Senior PM projects

Support Scrum Master with ceremony templates

Link to Jira issues for Jira Expert

Provide templates for Template Creator

See also

:

MACROS.md

for macro syntax reference,

TEMPLATES.md

for full template library,

PERMISSIONS.md

for permission scheme details.

Workflows

Space Creation

Determine space type (Team, Project, Knowledge Base, Personal)

Create space with clear name and description

Set space homepage with overview

Configure space permissions:

View, Edit, Create, Delete

Admin privileges

Create initial page tree structure

Add space shortcuts for navigation

Verify

Navigate to the space URL and confirm the homepage loads; check that a non-admin test user sees the correct permission level

HANDOFF TO

Teams for content population

Page Architecture

Best Practices

:

Use page hierarchy (parent-child relationships)

Maximum 3 levels deep for navigation

Consistent naming conventions

Date-stamp meeting notes

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

Template Creation

Identify repeatable content pattern

Create page with structure and placeholders

Add instructions in placeholders

Format with appropriate macros

Save as template

Share with space or make global

Verify

Create a test page from the template and confirm all placeholders render correctly before sharing with the team

USE

References for advanced template patterns
Documentation Strategy
Assess
current documentation state
Define
documentation goals and audience
Organize
content taxonomy and structure
Create
templates and guidelines
Migrate
existing documentation
Train
teams on best practices
Monitor
usage and adoption
REPORT TO: Senior PM on documentation health Knowledge Base Management Article Types : How-to guides Troubleshooting docs FAQs Reference documentation Process documentation Quality Standards : Clear title and description Structured with headings Updated date visible Owner identified Reviewed quarterly Essential Macros Full macro reference with all parameters: see MACROS.md . Content Macros 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} Dynamic Content 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} Collaboration Macros 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} Page Layouts & Formatting 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} Templates Library 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 Space Permissions Full permission scheme details: see PERMISSIONS.md . Permission Schemes Public Space : All users: View Team members: Edit, Create Space admins: Admin Team Space : Team members: View, Edit, Create Team leads: Admin Others: No access Project Space : Stakeholders: View Project team: Edit, Create PM: Admin Content Governance Review Cycles : Critical docs: Monthly Standard docs: Quarterly Archive docs: Annually Archiving Strategy : Move outdated content to Archive space Label with "archived" and date Maintain for 2 years, then delete Keep audit trail Content Quality Checklist : Clear, descriptive title Owner/author identified Last updated date visible Appropriate labels applied Links functional Formatting consistent No sensitive data exposed Decision Framework When to Escalate to Atlassian Admin : Need org-wide template Require cross-space permissions Blueprint configuration Global automation rules Space export/import When to Collaborate with Jira Expert : Embed Jira queries and charts Link pages to Jira issues Create Jira-based reports Sync documentation with tickets When to Support Scrum Master : Sprint documentation templates Retrospective pages Team working agreements Process documentation When to Support Senior PM : Executive report pages Portfolio documentation Stakeholder communication Strategic planning docs Handoff Protocols FROM Senior PM : Documentation requirements Space structure needs Template requirements Knowledge management strategy TO Senior PM : Documentation coverage reports Content usage analytics Knowledge gaps identified Template adoption metrics FROM Scrum Master : Sprint ceremony templates Team documentation needs Meeting notes structure Retrospective format TO Scrum Master : Configured templates Space for team docs Training on best practices Documentation guidelines WITH Jira Expert : Jira-Confluence linking Embedded Jira reports Issue-to-page connections Cross-tool workflow Best Practices Organization : Consistent naming conventions Meaningful labels Logical page hierarchy Related pages linked Clear navigation Maintenance : Regular content audits Remove duplication Update outdated information Archive obsolete content Monitor page analytics Analytics & Metrics Usage Metrics : Page views per space Most visited pages Search queries Contributor activity Orphaned pages Health Indicators : Pages without recent updates Pages without owners Duplicate content Broken links Empty spaces

confluence-expert

安装