Project Understanding

Overview

Automated repository intelligence via Tree-sitter indexing and PUI commands. Core principle: index once, then use focused packs (repomap/find/zoom/impact) instead of manual grep.

When to Use

• Entering new codebase: Rapidly map structure and entry points
• Planning refactors or hotfixes: Find callers and assess blast radius
• Budgeting context: Fit repository summaries into LLM token limits
• Time pressure: Reduce risk of missing indirect dependencies
• Verification: Ensure changes don't violate architectural boundaries

When NOT to Use

• Tiny repos: Manual reading is faster than indexing
• Unsupported languages: Avoid relying on symbol graphs (see skills/project-understanding/references/LANG_SUPPORT.md)