investigation

Unity Investigation Skills

Investigation agents use this layer for live Unity Editor evidence. CRG (code-review-graph) is always the primary tool. Unity-Skills REST provides supplementary runtime evidence.

Investigation Priority Order

1. Check workspace/repo-knowledge.md — prior architectural knowledge
2. Check workspace/ecs-registry.md — known component/system ownership
3. CRG investigation (code-review-graph) — code-level tracing
4. unity_diagnose — aggregated Unity Editor health snapshot (REST)
5. Specific REST skills — only when 1–4 leave gaps

Never skip to REST skills without first checking workspace files and CRG.

Aggregated Diagnostic (always first REST call)

GET /skills/unity_diagnose

Returns: compilation status, play mode state, active scene, error count, memory summary. Use this before any specific investigation skill — it often reveals the issue without further calls.

Compilation Diagnostics

Module: debug

debug_check_compilation    — check if project compiles cleanly
debug_get_errors           — get compile errors with file/line
debug_force_recompile      — trigger recompile (SemiAuto — check mode first)
debug_get_defines          — list scripting define symbols
debug_get_assembly_info    — list loaded assemblies

Use debug_check_compilation before any bug investigation. If compilation fails, fix it before investigating runtime behavior — most apparent bugs are actually compile errors.

Log Analysis

Module: console

console_get_logs           — get logs with optional filter
console_start_capture      — begin capturing (before play mode)
console_stop_capture       — end capturing
console_get_stats          — error/warning/log counts

For bug investigation: start capture before reproducing, stop after, filter by error type.

Scene State Reading

Module: perception

scene_analyze              — full scene structure analysis
scene_health_check         — check for common scene problems
scene_summarize            — brief scene summary
scene_context              — scene state for AI context
project_stack_detect       — detect project tech stack
script_dependency_graph    — dependency visualization