> ## 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.

# Create Your First Workflow

> Follow this guide to activate repository-connected automation for your project.

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

<Info>
  **Prerequisite**: Ensure your repository is connected to a Revolte application. Learn how in the [Get Started](/quick-start#onboarding-walkthrough) guide.
</Info>

<Steps>
  <Step title="Initialize Workflow Automation">
    Navigate to your application [integration settings](/integrations/project-management/jira). Under **Jira Configuration**, select **Configure Workflow Automation** to begin the setup process.

    <Frame>
      <img src="https://mintcdn.com/poddle-54594c3d/q0Rk3K5lGk3vHIWm/image-v2/agent/dev-agent/dev-agent-1.png?fit=max&auto=format&n=q0Rk3K5lGk3vHIWm&q=85&s=e69947efe27b6feab0544346c6cf2e99" width="600" data-path="image-v2/agent/dev-agent/dev-agent-1.png" />
    </Frame>
  </Step>

  <Step title="Access Automation Control">
    Go to the **Automation Configurations** tab. If no workflows are active, you will see the initialization screen. Click **Configure Automation**.

    <Frame>
      <img src="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" width="600" data-path="image-v2/agent/dev-agent/dev-agent-2.png" />
    </Frame>
  </Step>

  <Step title="Map Status Transitions">
    Define how Revolte should interact with your Jira statuses.

    * **Action**: Select `Developer workflow`.
    * **Mapping**: Choose which statuses trigger development (e.g., *To Do* to *In Progress*) and completion (e.g., *Done*).
    * **Target Branch**: Specify the branch where AI changes should be proposed (e.g., `qa` or `main`).

    <Frame>
      <img src="https://mintcdn.com/poddle-54594c3d/q0Rk3K5lGk3vHIWm/image-v2/agent/dev-agent/dev-agent-3.png?fit=max&auto=format&n=q0Rk3K5lGk3vHIWm&q=85&s=ccd81834f226c813a55747ae6dd6794d" width="600" data-path="image-v2/agent/dev-agent/dev-agent-3.png" />
    </Frame>
  </Step>

  <Step title="Confirm Workflow Creation">
    Once saved, your new workflow will appear in the active configurations list, showing the branch mapping and status flow.

    <Frame>
      <img src="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" width="600" data-path="image-v2/agent/dev-agent/dev-agent-4.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Info>
      See the [Jira Integration Guide](/integrations/project-management/jira#triggering-workflows-from-jira) for detailed integration steps.
    </Info>

    <Frame>
      <img src="https://mintcdn.com/poddle-54594c3d/q0Rk3K5lGk3vHIWm/image-v2/integrations/jira-3.png?fit=max&auto=format&n=q0Rk3K5lGk3vHIWm&q=85&s=c2536f08c4cf0b6bc9eaa3b5092705ce" width="600" data-path="image-v2/integrations/jira-3.png" />
    </Frame>
  </Step>

  <Step title="Trigger and Monitor Workflow">
    Selecting the application instantly triggers the AI agent workflow. The sidebar updates to display a **Workflow Triggered** success status. Click the **View Workflow Details** button to jump directly into the live agent execution dashboard.
  </Step>

  <Step title="Monitor Live Progress">
    Switch back to the Revolte dashboard under **Agent runs** to see the real-time status of your workflow.

    <Frame>
      <img src="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" width="600" data-path="image-v2/agent/dev-agent/dev-agent-7.png" />
    </Frame>
  </Step>

  <Step title="Review Execution Summary">
    Once complete, drill down into the run to see the execution stages, including Sandbox Provisioning, Code Setup, and Token Usage statistics.

    <Frame>
      <img src="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" width="600" data-path="image-v2/agent/dev-agent/dev-agent-8.png" />
    </Frame>
  </Step>

  <Step title="Inspect Implementation Plan">
    Navigate to the **Artifacts** tab to review the AI-generated implementation plan, including sub-tasks and proposed file changes.

    <Frame>
      <img src="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" width="600" data-path="image-v2/agent/dev-agent/dev-agent-9.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame>
      <img src="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" width="600" data-path="image-v2/agent/dev-agent/dev-agent-10.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame>
      <img src="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" width="600" data-path="image-v2/agent/dev-agent/dev-agent-11.png" />
    </Frame>
  </Step>

  <Step title="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`](/yaml/overview) configuration.

    <Frame>
      <img src="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" width="600" data-path="image-v2/agent/dev-agent/dev-agent-12.png" />
    </Frame>
  </Step>
</Steps>

## Next steps

* [Overview of Development Workflows](/ai-workflows/development-workflow/overview)
* [Quality Assurance Gates](/ai-workflows/quality-assurance) <span className="soon-pill">Coming Soon</span>
* [Product Strategy Automation](/ai-workflows/product-strategy) <span className="soon-pill">Coming Soon</span>