Jira
Jira is supported and optional.
Jira (supported, optional)
Configure it only if you want to sync with a Jira project. Settings (Claude Desktop extension settings, or environment variables): PRAXIS_JIRA_BASE_URL, PRAXIS_JIRA_EMAIL, PRAXIS_JIRA_PROJECT_KEY, PRAXIS_JIRA_TOKEN. Never paste the token into chat. praxis_doctor shows which are present, not their values.
Read-only tools: praxis_jira_smoke (connection check), praxis_jira_discover (issue types, numeric bugTypeId), praxis_jira_epic, praxis_jira_status, praxis_ba_status, praxis_architect_status.
Write path, each a preview then an approved apply (preview fingerprint required):
| Role | Preview | Apply |
|---|---|---|
| BA | praxis_ba_preview (CREATE, UPDATE, UNCHANGED, SUPERSEDED plan for an Epic) | praxis_ba_apply |
| Architect | praxis_architect_preview (one Work Package per canonical local WP; workPackageId scopes it) | praxis_architect_apply |
| Developer | praxis_developer_claim, praxis_developer_release, praxis_developer_complete (+ recovery preview and apply) | |
| Quality | praxis_quality_apply_preview | praxis_quality_apply (Done or Bugs, only from the approved plan) |
| Developer Git | praxis_developer_git_link_jira_preview | praxis_developer_git_link_jira_apply (PR/MR comment) |
Skills for the Epic path: praxis-ba:jira-epic-analysis, praxis-ba:resume-ba-work, praxis-architect:plan-jira-epic, praxis-architect:materialize-work-package, praxis-developer:implement-work-package, praxis-quality:review-work-package. Example: "Inspect Epic PRX-1 and show BA status. Do not create anything in Jira automatically."
If Jira changed between preview and apply, generate a new preview. If an apply was partial, retry the same fingerprint.
A local work item can carry an optional jiraIssueKey. The Praxis work item id stays its identity.
If something goes wrong
JIRA_CONFIG_UNAVAILABLE: a Jira setting is missing;praxis_doctorlists which.EXTERNAL_SERVICE_ERROR,JIRA_READ_TIMEOUT: Jira did not answer; retry.JIRA_TRANSITION_NOT_AVAILABLE,JIRA_TRANSITION_ID_INVALID: the workflow does not offer that transition; preview again to see live transitions.WORK_PACKAGE_SCOPE_AMBIGUOUS: passworkPackageIdto the Architect preview.WORK_PACKAGE_ALREADY_CLAIMED,PREMATURE_JIRA_DONE: see Developer.FINGERPRINT_MISMATCH/APPROVAL_FINGERPRINT_MISMATCH: Jira or local state changed; preview again.QUALITY_APPLY_INCOMPLETE,QUALITY_RECONCILIATION_REQUIRED: runpraxis_quality_apply_statusand retry the same plan.