Axiom Refract + Jira

Link Axiom Refract architectural findings to Jira tickets for structured remediation tracking

How It Works

1

Configure Jira Connection

Provide your Jira instance URL and API token in the Axiom dashboard settings. Axiom uses the Jira REST API to create and update issues.

2

Map Finding Types to Issue Types

Configure which Axiom finding types (SPOFs, dead code, circular dependencies, compliance gaps) map to which Jira issue types (Bug, Task, Story, Epic).

3

Set Target Project

Select the Jira project where Axiom should create issues. Optionally configure per-zone or per-severity project routing.

4

Enable Automated Issue Creation

Turn on automated issue creation for scan findings above a configured severity threshold. Issues include finding details, affected files, and remediation guidance.

What You Can Do

Automated Issue Creation

Axiom creates Jira tickets automatically for architectural findings — SPOFs, critical dead code, circular dependencies, and compliance gaps. Each ticket includes structural context and remediation steps.

Severity-Based Routing

Route findings to different Jira projects or issue types based on severity. Critical SPOFs become high-priority bugs. Dead code becomes backlog cleanup tasks.

Scan-to-Sprint Workflow

After each scan, review new findings in Jira and add them to sprint backlogs. Track remediation progress through your existing Jira workflow.

Bidirectional Status Sync

When a Jira ticket is resolved, Axiom tracks which findings have been addressed. The next scan verifies whether the remediation was effective.

Setup

In the Axiom dashboard, navigate to Settings > Integrations > Jira. Enter your Jira instance URL (e.g., https://your-instance.atlassian.net), your email address, and a Jira API token (generated at id.atlassian.com). Select the target project and configure issue type mappings. Enable automated issue creation and set the severity threshold for automatic ticket generation.

# Create a Jira issue from an Axiom finding via REST API
curl -X POST https://your-instance.atlassian.net/rest/api/3/issue \
  -H "Authorization: Basic $(echo -n '[email protected]:your-api-token' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": {
      "project": { "key": "ARCH" },
      "summary": "SPOF Detected: auth_middleware.py (47 dependents)",
      "description": {
        "type": "doc",
        "version": 1,
        "content": [{
          "type": "paragraph",
          "content": [{
            "type": "text",
            "text": "Axiom Refract scan detected a single point of failure in auth_middleware.py with 47 direct dependents and 89 transitive dependents across 4 architectural zones."
          }]
        }]
      },
      "issuetype": { "name": "Bug" },
      "priority": { "name": "High" }
    }
  }'

Why This Matters

Architectural findings are only valuable if they are acted upon. Integrating Axiom with Jira ensures that structural risks are tracked in the same system where engineering work is planned and prioritized — making architectural remediation part of the sprint workflow rather than a separate, easily deferred activity.

Read the Docs →