atlassian — guides¶

Jira, Jira Align, and Confluence over their REST APIs — plus the flow metrics and intake workflows you build on top of them. The pack ships jira and jira-align for issue and portfolio data, confluence-crawler and confluence-publisher for wiki content, jira-defect-flow for end-to-end defect handling, jira-brief-intake to turn a Jira epic into a product brief, jira-align-brief-intake to turn a Jira Align Feature into a product brief, and flow-metrics + ai-adoption-report for DORA / Flow Framework measurement. The four API-touching skills are credentialed: the secret resolves in-process and never reaches the model.

New here? Read The atlassian pack as a system first — it's the map. Then work with Jira to search and mutate issues.

Delivery leads looking to measure AI adoption: start with Measuring AI adoption with flow metrics for the model, then Report AI adoption as a delivery lead for the step-by-step guide.

How-to¶

Task-oriented recipes for a problem you already have.

• Work with Jira — JQL search with auto-pagination, plus fetch, create, and update issues through the jira skill.
• Measure flow and DORA metrics — compute cycle time, throughput, and the rest over a Jira scope, then compare runs into a report.
• Report AI adoption as a delivery lead — set up the labeling convention, run team-level and program-level adoption reports, and convert to a shareable format.
• Crawl and publish Confluence — mirror a space to Markdown and push Markdown back to a page.
• Authenticate Jira and Confluence with SSO cookies — for Data Center instances that block API tokens.

Reference¶

Information-oriented, dry and complete.

• atlassian skills — every skill in the pack: purpose, primary inputs, outputs, and required credentials.

Explanation¶

Understanding-oriented — the why behind the design.

• The atlassian pack as a system — how the skills compose over the Atlassian REST APIs and the credentialed-skill auth model.
• Measuring AI adoption with flow metrics — the self-certification model, what the metrics tell you, and the limits of Jira-based AI adoption measurement.

Cross-cutting topics — installing the catalogue, upgrading packs, the adapter support matrix — live in ../_shared/. The auth model the credentialed skills share lives in ../credential-brokers/.