Before you start
- The Kubit plugin installed in Claude Code or Cursor. See Kubit Skills.
- A workspace with agent traces.
- Your agent’s repo open locally, with full git history. A repo without git history isn’t supported, and a shallow clone gets a warning with an offer to run
git fetch --unshallow.
Steps
Ask why the metric changed
Run
/kubit with your question. It runs the investigation chain, starting at the step your question already covers.Chart the metric and pin the window
/kubit-report charts the metric and pins the time window. The chain carries the workspace, time window and report link to the next step.Pull the traces
/kubit-inspect pulls the traces in that window. It returns the total number of matches, up to 5 sample rows and a CSV export of every match.Find the commit
The chain asks before it runs
/kubit-blame. Confirm, and /kubit-blame maps agent names, tool names and prompts from the traces to files in your repo, asking you to confirm any match it isn’t sure of. It then ranks commits in the window by how close they are in time, how much of the mapped code they touch and how large the change is.Verify
The result lists up to 5 suspect commits, each with a short summary of how it changed behavior. If no commit touched the mapped code in the window, it suggests a wider window.If it fails
Next Steps
- Triggers: what Triggers compares in the app.
- Kubit Skills: the full investigation chain reference.