agy_delegate_research
Delegate deep read-only codebase research, cross-module architecture analysis, bug root-cause tracing, or security verification to Antigravity CLI; get cited Markdown analysis.
Instructions
Delegate deep read-only codebase research, cross-module architectural analysis, bug root-cause tracing, or security verification to Google Antigravity CLI (agy) using verified Gemini 3.8 Flash or Gemini 4 Argon models in --mode=plan. SERIALIZATION & ASYNC BUDGET: Calls are serialized (one at a time, AGY_MAX_CONCURRENCY = 1); a prompt that needs more than ~8 minutes of agent time should be split into one bounded question per call, or launched expecting to fetch the result by job_id via agy_job_result (soft handoff at 540s, hard watchdog at AGY_RUN_MAX_MS, cancellable via agy_cancel). WHEN TO USE: Complex multi-file reasoning or architectural audits across 5–30+ files after initial scouting. DO NOT USE FOR: Simple signature, import, or line-number extraction on known files (use local_file_scout instead at 0x quota) or parallel disjoint directory scans (use agy_spawn_swarm instead). RETURNS: Markdown analysis with : citations (or an async job_id handle if still running at soft budget) and telemetry footer.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prompt": "<prompt>",
"tier": "<tier>"
},
"name": "agy_delegate_research"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Optional working directory path (defaults to workspace root). | |
| tier | Yes | Gemini routing tier: flash-low/flash-medium (1x triage), flash-high (2x module summary), argon-low/argon-medium (4x cross-module reasoning), argon-high (6x apex architecture/security). | flash-medium |
| prompt | Yes | Detailed research or analysis prompt for Antigravity. Name the specific files to inspect. Keep to one bounded question (<~8 min agent time) or use agy_job_result if handed a job_id. | |
| files_to_follow | No | Optional list of <file>:<line> targets (e.g. ["src/index.ts:42"]) to jump to in the Antigravity IDE HUD. | |
| soft_timeout_ms | No | Optional soft budget in milliseconds before returning an async job_id handle (default 540000 = 540s, below the 600s client timeout). | |
| html_artifact_name | No | Optional filename (e.g. "arch-overview.html") to instruct agy to write a self-contained visual HTML report. |