1. 1

   Locate the run

   Find the most recent failed workflow run on the branch.

2. 2

   Assemble context

   First failing step, anchored log window, diff since the last green commit.

3. 3

   Investigate

   The agent decides which files, patches or log regions it needs.

4. 4

   Diagnose

   A typed root cause with quoted evidence and a confidence score.

TraceCI reads. It never writes to your repository, comments on a pull request, or re-runs a job. A wrong diagnosis costs you a paragraph of text.