find_and_summarize — Claude Code command: what it does, how to install
find_and_summarize locates source files across target directories and creates concise two-sentence summaries in a YAML file. Useful for documenting modules without subagents.
no license ★ 1,573 updated 2026-02-08
.claude/commands/find_and_summarize.mdWhat find_and_summarize does
This command inspects project directories recursively to catalog files matching designated extensions. When arguments are omitted, it defaults to scanning '*.vue, *.ts' files in the './apps' directory. The workflow runs directly in the primary session rather than delegating tasks to subagents.
File inspection proceeds in growing chunks. The agent inspects 50 lines first, stepping up to 100 and 200 lines until it understands the purpose of the code. Each entry gets exactly two sentences: one outlining its core functionality, and another detailing where other parts of the project use it.
Summaries are written to app_docs/find_and_summarize_<RUN_NAME>.yaml under a top-level summary key. The app_docs folder must be present beforehand because the command will not create missing folders. Files outside the specified extension patterns remain untouched.
What it helps with
- catalog file responsibilities across a codebase
- generate structured YAML documentation for source files
- trace where specific modules get imported or invoked
- summarize code without launching secondary subagents
Example prompts for the agent
- Generate an overview of frontend components: /find_and_summarize web_ui '*.vue' ./apps
- Summarize all backend endpoints into a documentation file: /find_and_summarize api_audit '*.ts' ./apps
- Run the file inventory with default settings using /find_and_summarize full_scan
How to install find_and_summarize
Manually: put the files in place
.claude/commands/find_and_summarize.mdCall it with /find_and_summarize. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/find_and_summarize.mdCall it with /prompts:find_and_summarize. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/find_and_summarize.prompt.mdManually: put the files in place
.gemini/commands/find_and_summarize.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about find_and_summarize
How do I install find_and_summarize in Claude Code?
Place the command file at .claude/commands/find_and_summarize.md in your repository root.
What does the find_and_summarize command do?
It reads matching codebase files in progressive line chunks and generates a two-sentence summary for each file into a YAML report.
Where does find_and_summarize store the output?
Results are saved to app_docs/find_and_summarize_<RUN_NAME>.yaml, requiring the app_docs directory to already exist in your workspace.