explore-codebase

SKILL.md

| Structural patterns (functions, classes) | sg (ast-grep) | | Text/regex patterns (strings, names) | rg (ripgrep) | | File discovery by name/extension | fd |

Decision flow: Find files first? fd → pipe to rg/sg. Syntax-aware match needed? sg. Fast text search? rg. Uncertain? Start with rg, escalate to sg if structure matters.

ast-grep is the least familiar tool -- key syntax summarized here. See references/ast-grep.md for language-specific patterns and YAML rule files.

Use when navigating unfamiliar code or understanding architecture, tracing call flows or symbol definitions, answering where-is-this-defined or how-does-this-work questions, finding files by name or pattern, or doing pre-refactoring analysis to locate all references before changing code Source: vinta/hal-9000.

View raw