> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revolte.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira Workflow

> Set up and run your first Jira-connected autonomous development workflow, from integration setup to status transition mapping.

Launch your first AI-powered development workflow in minutes by connecting your Jira workspace and defining your automation rules.

> [!NOTE]
>
> **Prerequisite**: Ensure your repository is connected to a Revolte application. Learn how in the [Get Started](https://docs.revolte.ai/get-started/quickstart.md) guide.

**1. Initialize Workflow Automation**

Navigate to the **Chat** section and select **Autopilot**. Connect your Jira workspace by installing the Revolte app from the Atlassian Marketplace, accepting the requested permissions, and selecting the Atlassian site to install to.

> [!NOTE]
>
> For the full step-by-step walkthrough, see [Connect Jira](https://docs.revolte.ai/integrations/project-management/jira.md).

![Autonomous mode setup on the Jira Integration step, with an Integrate Jira Now button](https://mintcdn.com/poddle-54594c3d/PLWOUDjItrGa_UrT/image-v2/agent/dev-agent/autopilot/auto-pilot.png?fit=max\&auto=format\&n=PLWOUDjItrGa_UrT\&q=85\&s=4049836843ba173c3bfd02e5f42707d8)

**2. Complete Remaining Setup Steps**

Once your Jira integration is complete, carry on with the remaining steps in the setup flow: complete **Git Integration** to connect your repository, **Configure Application** to define your app's service details, and **Commit YAML** to save your `revolte.yml` configuration.

Once all four steps show a green checkmark and your configuration has been committed, you're ready to set up the workflow. Click **Configure workflow** to proceed.

![Configuration committed confirmation with all four setup steps complete and a Configure workflow button](https://mintcdn.com/poddle-54594c3d/a-IrWbKlpJE4bfvq/image-v2/agent/dev-agent/autopilot/ready-for-workflow.png?fit=max\&auto=format\&n=a-IrWbKlpJE4bfvq\&q=85\&s=98d3be83afc567b8585264a7da0d1a42)

**3. Access Automation Control**

Go to the **Automation Configurations** tab. If no workflows are active, you will see the initialization screen. Click **Configure Automation**.

![Automation Configurations tab with no workflow automation yet and the Configure Automation button highlighted](https://mintcdn.com/poddle-54594c3d/q0Rk3K5lGk3vHIWm/image-v2/agent/dev-agent/dev-agent-2.png?fit=max\&auto=format\&n=q0Rk3K5lGk3vHIWm\&q=85\&s=0af53aa5cbf04cb1db5b7932825d496c)

**4. Map Status Transitions**

Define how Revolte should interact with your Jira statuses.

* **Action**: Select `Developer workflow`.
* **Mapping**: Choose which statuses trigger development, such as *To Do* to *In Progress*, and completion, such as *Done*.
* **Target Branch**: Specify the branch where AI changes should be proposed, such as `qa` or `main`.
* **Model Mode**: Select based on your needs, such as `Claude Haiku - Fast & efficient`.

![Configure Workflow Automation dialog mapping Jira statuses To Do, In Progress, and Done, with Branch and Model mode fields](https://mintcdn.com/poddle-54594c3d/a-IrWbKlpJE4bfvq/image-v2/agent/dev-agent/autopilot/configure-workflow-automation.png?fit=max\&auto=format\&n=a-IrWbKlpJE4bfvq\&q=85\&s=d0fdd6fd67d4f1ac88c31512f803fd00)

**5. Confirm Workflow Creation**

Once saved, your new workflow will appear in the active configurations list, showing the branch mapping and status flow.

![Automation Configurations tab listing the new Developer workflow with its To Do, In Progress, and Done flow](https://mintcdn.com/poddle-54594c3d/q0Rk3K5lGk3vHIWm/image-v2/agent/dev-agent/dev-agent-4.png?fit=max\&auto=format\&n=q0Rk3K5lGk3vHIWm\&q=85\&s=030995be3c9d37e815a797f05aa5a9e2)

**6. Select Target Application**

To trigger the workflow for a specific task, open the ticket in Jira and locate the **Revolte** section in the right sidebar. Under **Select Application**, select your target application service from the dropdown menu.

> [!NOTE]
>
> See the [Jira Integration Guide](https://docs.revolte.ai/integrations/project-management/jira.md#triggering-workflows-from-jira) for detailed integration steps.

![Jira issue with the Revolte panel highlighted, showing the issue key, Revolte project, and Select Application menu](https://mintcdn.com/poddle-54594c3d/q0Rk3K5lGk3vHIWm/image-v2/integrations/jira-3.png?fit=max\&auto=format\&n=q0Rk3K5lGk3vHIWm\&q=85\&s=c2536f08c4cf0b6bc9eaa3b5092705ce)

**7. Trigger and Monitor Workflow**

Selecting the application instantly triggers the AI agent workflow. The sidebar updates to display a **Workflow Triggered** success status. Click **View Workflow Details** to jump directly into the live agent execution dashboard.

**8. Monitor Live Progress**

Switch back to the Revolte dashboard under **Agent runs** to see the real-time status of your workflow.

![Agent runs tab showing a developer workflow run for a Jira ticket with the Running status highlighted](https://mintcdn.com/poddle-54594c3d/q0Rk3K5lGk3vHIWm/image-v2/agent/dev-agent/dev-agent-7.png?fit=max\&auto=format\&n=q0Rk3K5lGk3vHIWm\&q=85\&s=0ea7ebbbfaac69f8ce8075c9c51e5953)

**9. Review Execution Summary**

Once complete, drill down into the run to see the execution stages, including Sandbox Provisioning, Code Setup, and Token Usage statistics.

![Completed workflow run summary with execution summary, stage history, and token usage highlighted](https://mintcdn.com/poddle-54594c3d/q0Rk3K5lGk3vHIWm/image-v2/agent/dev-agent/dev-agent-8.png?fit=max\&auto=format\&n=q0Rk3K5lGk3vHIWm\&q=85\&s=31c530f8d23ebd2b11de108cd3a98c0c)

**10. Inspect Implementation Plan**

Navigate to the **Artifacts** tab to review the AI-generated implementation plan, including sub-tasks and proposed file changes.

![Workflow run Artifacts view showing the implementation plan with background, sub-tasks, and proposed changes](https://mintcdn.com/poddle-54594c3d/q0Rk3K5lGk3vHIWm/image-v2/agent/dev-agent/dev-agent-9.png?fit=max\&auto=format\&n=q0Rk3K5lGk3vHIWm\&q=85\&s=db40cee4930b5a1caf850ed4b0d5f56b)

**11. Analyze Code Diffs**

Finally, use the **Diff Summary** tab to inspect every line of code modified or created by the agent before finalizing the delivery.

![Workflow run Artifacts view with the Diff Summary tab selected, listing modified, created, and deleted files](https://mintcdn.com/poddle-54594c3d/q0Rk3K5lGk3vHIWm/image-v2/agent/dev-agent/dev-agent-10.png?fit=max\&auto=format\&n=q0Rk3K5lGk3vHIWm\&q=85\&s=673f66842be3464bc4061b2ba8a4391b)

**12. Review and Merge**

Once the agent finishes, it automatically opens a pull request on GitHub, or your configured Git provider, so you can review and merge the proposed changes.

![GitHub pull requests page showing the open pull request created by Revolte AI for the Jira ticket](https://mintcdn.com/poddle-54594c3d/q0Rk3K5lGk3vHIWm/image-v2/agent/dev-agent/dev-agent-11.png?fit=max\&auto=format\&n=q0Rk3K5lGk3vHIWm\&q=85\&s=620db05cb25fbc9dd88e8bdb79d14ac3)

**13. Deploy to Preview**

After merging, you can deploy the changes to a preview environment. Click **View Preview** and confirm the deployment using your [`revolte.yml`](https://docs.revolte.ai/yaml/overview) configuration.

![Deploy in preview dialog over a completed workflow run, with the View Preview and Deploy buttons highlighted](https://mintcdn.com/poddle-54594c3d/q0Rk3K5lGk3vHIWm/image-v2/agent/dev-agent/dev-agent-12.png?fit=max\&auto=format\&n=q0Rk3K5lGk3vHIWm\&q=85\&s=cf40e29634e103099aba6f1ce48b8fb4)

## Next steps

* [Workflow Overview](https://docs.revolte.ai/workflows/overview.md)
* [Quality Assurance Gates](https://docs.revolte.ai/archive/ai-workflows/quality-assurance) Coming Soon
* [Product Strategy Automation](https://docs.revolte.ai/archive/ai-workflows/product-strategy) Coming Soon


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.