navigation-review

What problem does it solve?

Prevents broken or misleading Godot navigation behavior by identifying common implementation pitfalls after navigation code is written, so agents don’t fail silently at runtime.

Core Features & Use Cases

• Gotcha-based post-implementation review: Checks navigation code against a known set of stable Godot 4.x pitfalls for agents, regions, links, obstacles, and key APIs.
• Actionable fixes with evidence: For each detected issue, it cites the gotcha ID, highlights the offending code, and recommends the correction pattern.
• Automated/static and runtime verification guidance: Optionally uses the checklist and provides concrete tests to validate path sync, arrival correctness, rebake behavior, and multi-size/navmesh setup.
• Use Case: When a new enemy/character navigation controller is added (e.g., NavigationAgent3D with target_position updates and avoidance), this skill helps ensure it won’t get stuck, query too early, snap to off-navmesh targets, or fail to re-path after rebakes.

Quick Start

Run the navigation-review after you implement or modify navigation-related code, then compare it against gotchas.md and confirm with the checklist checks in checklist.md.