Debug Issue

Testing & Quality

Systematically debug issues using graph-powered code navigation

QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

Open your project in Codex.
Copy and paste the prompt below.
Review files and risks before approving any action.

Prompt to paste

Inspect the Agent Skill at https://github.com/theexperiencecompany/gaia/blob/HEAD/.claude/skills/debug-issue/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/debug-issue, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Debug Issue

Use the knowledge graph to systematically trace and debug issues.

Steps

Use semantic_search_nodes to find code related to the issue.
Use query_graph with callers_of and callees_of to trace call chains.
Use get_flow to see full execution paths through suspected areas.
Run detect_changes to check if recent changes caused the issue.
Use get_impact_radius on suspected files to see what else is affected.

Tips

Check both callers and callees to understand the full context.
Look at affected flows to find the entry point that triggers the bug.
Recent changes are the most common source of new issues.