explore-codebase

Installation
SKILL.md

User request: $ARGUMENTS

Thoroughness Level

FIRST: Determine level before exploring. Parse from natural language (e.g., "quick", "do a quick search", "thorough exploration", "very thorough") or auto-select if not specified: single entity lookup → quick; single bounded subsystem (per Definitions) → medium; query spanning 2+ bounded subsystems OR explicit interaction queries ("how do X and Y interact") → thorough; "comprehensive"/"all"/"architecture"/"audit" keywords → very-thorough.

Trigger conflicts: When a query contains triggers from multiple levels, use the highest thoroughness level indicated (very-thorough > thorough > medium > quick). Example: "where is the comprehensive auth?" → very-thorough ("comprehensive" overrides "where is").

Level Behavior Triggers
quick No research file, no todos, 1-2 search calls (Glob or Grep, not counting Read); if first search returns no results, try one alternative (if Glob failed, use Grep with same keyword; if Grep failed, use broader Glob like **/*keyword*). If search returns >5 files matching the pattern (before filtering by relevance), note "Query broader than expected for quick mode. Consider re-running with medium thoroughness." and return top 5 files. "where is", "find the", "locate", single entity lookup
medium Research file, 3-5 todos, core implementation + files in import/export statements within core (first-level only) + up to 3 callers; skip tests/config specific bug, single feature, query about one bounded subsystem
thorough Full logging, trace all imports + all direct callers + test files + config multi-area feature, "how do X and Y interact", cross-cutting concerns
very-thorough Unbounded exploration up to 100 files; if >100 files match, prioritize by dependency centrality (files with more direct import statements from other files, counting each importing file once) and note "N additional files exist" in overview "comprehensive", "all", "architecture", "security audit", onboarding
Installs
22
GitHub Stars
3
First Seen
Jan 23, 2026
explore-codebase — doodledood/codex-workflow