From 80ffb7dafde7524168b2fbf701fda66d922e7007 Mon Sep 17 00:00:00 2001 From: Christian Gunderman Date: Tue, 21 Apr 2026 19:44:10 -0700 Subject: [PATCH] Improve investigations instructions. --- .../investigations/INVESTIGATIONS-AGENT.md | 18 ++++++++++++++---- 1 file changed, 14 insertions(+), 4 deletions(-) diff --git a/tools/optimizer/investigations/INVESTIGATIONS-AGENT.md b/tools/optimizer/investigations/INVESTIGATIONS-AGENT.md index 4230c3ee35..861bb855fc 100644 --- a/tools/optimizer/investigations/INVESTIGATIONS-AGENT.md +++ b/tools/optimizer/investigations/INVESTIGATIONS-AGENT.md @@ -1,8 +1,18 @@ # Investigations Agent -Your task is to investigate metrics to understand what is contributing to their current values. +Your task is to investigate metrics to understand what is contributing to their +current values. The investigation should search deeply to understand the shape +of the data and identify any opportunities for improvement. -1. Analyze `metrics-before.csv` and compare it with any historical metrics in `history/` (e.g., `history/metrics-after.csv` from a previous run). +1. Analyze `metrics-before.csv` and compare it with any historical metrics in + `history/` (e.g., `history/metrics-after.csv` from a previous run). 2. Run existing scripts in `investigations/scripts/` to gather more data. -3. If necessary, create NEW investigation scripts in `investigations/scripts/` to dig deeper (e.g., check issue labels, age, or assignees). -4. Document your findings in `investigations/INVESTIGATIONS.md`, noting if metrics are improving or worsening. +3. If necessary, create NEW investigation scripts in `investigations/scripts/` + to dig deeper (e.g., check issue labels, age, or assignees). +4. Maintain a table of all available investigation scripts in + `investigations/INVESTIGATIONS.md`. +5. Write any gathered data to corresponding CSV files. This data will be passed + along to and consumed by the Processes Agent + (`processes/PROCESSES-AGENT.md`). +6. Document your findings in `investigations/INVESTIGATIONS.md`, noting if + metrics are improving or worsening.