# find_and_summarize

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.

- command · `type=command` · Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI · ★ 1573 repo stars
- Author: disler
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/disler/claude-code-hooks-multi-agent-observability/tree/HEAD/.claude/commands/bench/find_and_summarize.md
- Updated: 2026-02-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/find-and-summarize

## What it 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.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/find_and_summarize.md` — Call it with /find_and_summarize. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/find_and_summarize.md` — Call it with /prompts:find_and_summarize. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/find_and_summarize.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/find_and_summarize.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/disler/claude-code-hooks-multi-agent-observability/tree/HEAD/.claude/commands/bench/find_and_summarize.md

## When to use it
- 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
- 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

## Similar
- [summarize-meeting](https://affpapa.org/en/nevibecode/skills/summarize-meeting.md) — skill · 3300 installs
- [summarize-changes](https://affpapa.org/en/nevibecode/commands/summarize-changes.md) — command · ★ 1424 repo stars
- [documenting-legacy-codebases](https://affpapa.org/en/nevibecode/skills/documenting-legacy-codebases.md) — skill · 26600 installs
- [initref](https://affpapa.org/en/nevibecode/commands/initref.md) — command · 186 installs
- [acquire-codebase-knowledge](https://affpapa.org/en/nevibecode/skills/acquire-codebase-knowledge.md) — skill · 2200 installs
- [deepinit](https://affpapa.org/en/nevibecode/skills/deepinit.md) — skill · 1100 installs

From the same set: [disler/claude-code-hooks-multi-agent-observability](https://affpapa.org/en/nevibecode/by/disler/claude-code-hooks-multi-agent-observability.md) — 20 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
