explore-codebaselisted

# /explore-codebase [path or project name] Structured onboarding for unfamiliar codebases. Produces a concise architecture summary. ## Usage ``` /explore-codebase # explore current directory /explore-codebase /path/to/project /explore-codebase MyProject # named project (searches known paths) ``` ## Exploration Sequence ### 1. Project Overview (~2 min) The commands below assume a Unix shell (Linux/macOS, or Git Bash on Windows). On native Windows shells, substitute `dir` for `ls -la` and `type` / `Get-Content` for `cat`; `git`, `head`, and the rest behave the same. ```bash ls -la # root structure (Windows: `dir` or PowerShell `Get-ChildItem`) cat README.md | head -80 # stated purpose (Windows: `Get-Content README.md -TotalCount 80`) cat pyproject.toml | head -40 # or package.json / Cargo.toml git log --oneline -10 # recent activity (cross-platform via git) git shortlog -sn --no-merges | head -5 # main contributors ``` ### 2. Directory Structure Map the top-level directories: - Where is the entry point? (main.py, app.py, index.ts, src/) - Where are tests? - Where is configuration? - Any generated code or build artifacts? ### 3. Architecture Patterns **Check KG first** (fastest if project is known): ``` search_knowledge_graph("project architecture [name]") search_code_graph("main entry point", collection="CodeModule") ``` **Then read**: - Entry point file (first 50