find-examples

/find-examples

Find usage examples for a function, class, pattern, or concept in the codebase.

Trigger

Use when the developer asks: "Show me examples of X", "How is Y used?", "Where is Z called?"

Steps

1. Parse the developer's message to identify what to search for: a function name, class name, pattern, or concept.
2. Search for it across the codebase using text search. Look for:
   • Direct calls: foo(, foo.bar(, new Foo(
   • Imports: from x import foo, import foo, require('foo')
   • Type annotations: : Foo, -> Foo
3. Find 3-5 representative examples from different parts of the codebase (not 5 examples from the same file).
4. For each example, show the relevant code snippet with 3-5 lines of context.
5. After the examples, briefly explain the common usage pattern you observed.

Output Format

Found N usages of `[name]`. Here are representative examples:

**Example 1** — `path/to/file.py:42`
```[language]
[code snippet with context]

[1-line explanation of what's notable about this usage]

Example 2 — ...

---

Common pattern: [2-3 sentence summary of how this is typically used]

## Rules

- Always show the file path and line number
- If there are more than 10 usages, show the most diverse 3-5 (different callers, different patterns)
- If there are fewer than 3 usages, show all of them and note "this is used sparingly"
- If nothing is found, say so clearly and suggest alternative search terms