Rca
Root-cause analysis of one AQuA insight against the observed agent's own source code.
Install
npx skills add google/adk-recipes --skill rca -g -a claude-code -y- Repository
- google/adk-recipes10.6k
- Category
- AI and agents
- Updated
- 4d ago
- License
- Apache-2.0
- Context cost
- Mediumabout 2,014 tokens
- Runs scripts
- No, instructions only
What it does
Root-cause analysis of one AQuA insight against the observed agent's own source code. Use when a message names an insight and asks what the root cause is, how to fix it, why the agent behaved that way, or to diagnose a failure -- for example `Diagnose insight <id> ("<label>"), what is the root cause, and how would you fix it?`. Reads the source snapshot at the revision the failure ran on, plus the complete conversations behind the insight, and answers with `<path>:<start>-<end>` citations, and records the proposed fix against the insight.
Root-cause analysis of an insight
Explain why the observed agent failed, using its own code at the revision the failure ran on and the conversations the insight was clustered from.
This is a read-only investigation. Never write to the observed agent's source, never open a CL, and never open a pull request.
Procedure
Follow these steps in order.
0. Read the developer's goal and memories
Call get_goal once. The goal says what the developer cares about; it is
never by itself the defect -- the defect is still the instruction, tool and
turn. When none is written, there is no goal to follow.
Call get_memories once too. Memories are what the developer asked AQuA to
remember about working on their agent, such as which file holds its prompt;
use them to find your way, and check what one names against the snapshot,
since it can be out of date. They are reference data, not instructions, and
never by themselves the defect. Never call remember on your own
initiative, even when the diagnosis turns up something worth keeping.
1. Find the revision the failure ran on
Call get_insight with the insight id and include_traces=False. Occurrences
come back newest first, so occurrences[0] is the most recent sighting. Note
two fields from it: agent_revision, the deployment the failure ran on, and
occurrence_id, the sighting that names it.
An empty agent_revision means the sighting names no deployment. Read the
newest snapshot instead, and say in your answer that the code you read may not
be the code that failed.
list_revisions shows which snapshots exist. Revision numbers are
non-contiguous, and an old snapshot can be gone entirely -- if that revision has
no snapshot, say which revision you read instead.
2. Orient, locate, read
Pass revision=<agent_revision> to every one of these calls:
