Visualizing codebases as spectrograms to find bugs efficiently. Encodes code structure and anomalies as a deterministic heatmap image for visual analysis.
Three tools with complete schemas and descriptions, but significant quality gaps. Tool names lack clear action verbs (resolve_sonic_coordinates is vague; should be map_spectrogram_to_code or similar). Descriptions are verbose and use ALL-CAPS urgency language ('CRITICAL', 'NEVER', 'Mandatory') that reads as prompt injection rather than professional documentation. Parameter descriptions are sparse: 'x' and 'y' in resolve_sonic_coordinates lack units, range, or format guidance. No output schemas documented, LLMs cannot predict what these tools return. Error handling present but generic. No tool annotations (readOnlyHint, idempotentHint). Composition is reasonable (three-step workflow), but descriptions do not explain prerequisites or when to call each tool in sequence.
CRITICAL: Use this ONLY after identifying an anomaly via spectrogram. It fetches the exact 20-line context window. DO NOT use standard read_file for large projects to avoid token overflow.
CRITICAL: Call this tool FIRST for any project-wide analysis. It visualizes the entire codebase as a spectrogram to find bugs efficiently.
Mandatory step to translate visual spectrogram anomalies (X, Y) into a precise file and line number. NEVER guess the file from the mapping table manually.
Parameter descriptions incomplete. 'x' and 'y' in resolve_sonic_coordinates lack units, valid range, or format. 'directoryPath' repeated across tools without explaining whether it must be absolute or relative.
No output schemas documented. LLMs cannot predict return types, fields, or structure. get_project_spectrogram returns base64 PNG and anomaly summary, but this is inferred from code, not declared in tool definition.
Tool names lack clear action verbs. 'resolve_sonic_coordinates' is domain-jargon and vague; LLMs cannot infer intent without reading description. Should be 'map_spectrogram_to_code' or 'locate_anomaly_in_file'.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 40 | 2026-07-28+ | v2 |
Descriptions use ALL-CAPS urgency ('CRITICAL', 'NEVER', 'Mandatory') that reads as prompt injection. Professional descriptions state WHAT, WHEN, and WHY without imperative language. Rewrite to: 'Call this first to scan the entire codebase and identify anomalies as a visual spectrogram.'
No tool annotations (readOnlyHint, idempotentHint). All three tools are read-only and idempotent, but this is not declared. Agents cannot optimize caching or retry logic without explicit hints.