Confluence Documentation Updater

Task

Use @Confluence/Search PagesName it "Confluence/Search Pages" and call it with @Confluence/Search Pages to find documentation pages matching a topic, @Confluence/Get PageName it "Confluence/Get Page" and call it with @Confluence/Get Page to read current content and version info, and @Confluence/Update PageName it "Confluence/Update Page" and call it with @Confluence/Update Page to update specific sections while preserving the rest. Handles version control automatically to prevent conflicts.

Input

The user provides:

1. The topic or page title to search for (e.g., "deployment process", "API authentication")
2. The specific section or content to update
3. The new information to add or replace
4. The space to search in (optional, searches all spaces if not specified)

Example: "Update the deployment process page in the Engineering space to add a new step for running database migrations before deploying"

Context

Find the Target Page

1. Use @Confluence/Search Pages with CQLName it "Confluence/Search Pages with CQL" and call it with @Confluence/Search Pages with CQL to find pages matching the topic or title
2. If multiple pages match, present the options to the user for confirmation
3. Narrow results by space key if provided

Read Current Content

1. Use @Confluence/Get PageName it "Confluence/Get Page" and call it with @Confluence/Get Page to fetch the full page body and current version number
2. Parse the content to understand the page structure (headers, sections, lists)
3. Identify the specific section that needs updating

Apply the Update

1. Modify the target section with the new information
2. Preserve all other sections, formatting, and content untouched
3. Maintain Confluence storage format (XHTML) compatibility
4. Use @Confluence/Update PageName it "Confluence/Update Page" and call it with @Confluence/Update Page with the correct version number to commit the change
5. Include a meaningful version comment describing what was changed

Verify the Update

1. Confirm the page was updated successfully
2. Show a before/after comparison of the changed section
3. Provide the page URL for review

Output

Documentation Updated

Page: [page title] Space: [space name] Version: [old version] → [new version] Section Updated: [section name or description]

Change Summary:

• [Description of what was added, removed, or modified]

Before:

[previous content of the changed section]

After:

[updated content of the changed section]

Page URL: [link] Status: Updated successfully