SE: Root Cause Analysis — Autonomous Agents Agentic Workflow

schema_version: 1
id: agent_se_rca
title: "SE: Root Cause Analysis"
description: "Investigate bug, trace root cause, report findings without fixing"
overview: |
  An investigation-only chain. The software engineer agent reads the bug ticket, reproduces the failure locally or against a reference environment, then works backward through logs, stack traces, git history, and code to identify the true root cause. The output is a written analysis posted back to the ticket — no code changes are made.

  Use this when the ticket's correct fix is unclear, when a suspected change set needs scoping before commitment, or when a human reviewer wants an independent opinion on cause before approving a fix path. A separate workflow applies the actual fix.

category:
  level: pipeline
  domain: engineering

metadata:
  agent: true
  role: se

params:
  ticket_url:
    type: string
    description: "Jira ticket URL"
  hint:
    type: string
    default: ""
    description: "Optional extra instructions for the agent"
  entry_path:
    type: string
    default: "~/workspace"
    description: "Working directory for the agent"

steps:
  - type: terminal.open
    title: "Agent: SE RCA"
    cwd: "{{entry_path}}"
  - type: terminal.run
    cmd: >-
      source ~/.agent-env && claude --dangerously-skip-permissions
      "read ticket with attachments and all comments - {{ticket_url}}. if it fails, stop and report the error.
      learn how to SE relevant parts. reproduce the issue in the browser, then trace through the code to identify root cause.
      {{hint}}
      write one comment to the ticket with: symptoms, root cause (file:line refs), suggested fix approach, and complexity estimate."