Jira & Confluence
Connect an Atlassian site to link architectural decisions to the Jira tickets that motivated them, and publish your generated wiki to Confluence on a weekly schedule — updated in place, never duplicated.
A team owner or admin connects an Atlassian Cloud site once, under Settings → Team → Jira & Confluence. The connection is OAuth-based (read-only Jira scopes plus Confluence page write), team-scoped, and covers every repo shared into the team.
Connecting your site
- Go to Settings → Team and click Connect Atlassian.
- Approve the consent screen on Atlassian. If your account can access several sites, pick which one the team uses.
- The card shows the connected site and its status from then on. If Atlassian ever revokes the grant, the card flags Needs re-auth and a single reconnect heals every dependent feature.
Tokens are encrypted at rest and never leave the Repowise API. Repowise stores no Atlassian account data — no account ids, names, or emails.
Decisions ↔ Jira issues
Repowise's decision records carry evidence commits — the commits a decision was extracted from. Find Jira links (on the decisions page) mines those commit messages for issue keys and links the matches:
- Keys only count when their project prefix exists on your connected
site, so
SHA-256or a made-upFAKE-123never produce a link. - Each decision page gains a Linked Jira issues section showing the ticket, its title, and a live-ish status pill (refreshed on view, cached for an hour).
- Manual linking by key covers tickets that never appeared in a commit message; unlinking is one click.
- The
get_whyMCP tool carries the same links, so your editor's agent sees the originating ticket next to the decision rationale.
Publishing the wiki to Confluence
Per repo, under repo → Settings → Confluence publication:
- Pick a space (and optionally a parent page id) for the wiki to live under.
- Publish on demand with Publish now, or enable the weekly schedule.
Publication is idempotent and in-place:
- Every page carries a banner stating exactly which commit it was generated from, with a link back to the hosted wiki — and an explicit STALE warning when the repository has new commits since the last index.
- Unchanged pages are skipped (content-hash diff), changed pages are updated in place at the next version, and pages that disappear from the wiki are moved to Confluence's trash (reversible) — re-publishing never duplicates a page tree.
- Markdown that has no clean Confluence equivalent (e.g. embedded raw HTML) is rendered as a visible code block rather than dropped.
- The last run's outcome — created / updated / unchanged / removed and any per-page failures — is shown on the card.
The Jira & Confluence integration is available on the Teams plan. The connection is made by a team owner or admin; decision links and publication work for every member after that.
Alerts & notifications
HMAC-signed Slack-compatible webhooks, the in-product notification bell, and per-kind email preferences — for security events and engineering signals, designed to never spam.
Requirements
System and toolchain requirements for self-hosted repowise — Python, Git, disk, and an LLM provider key.