@@ -107,17 +107,17 @@ Use it as a **peer tool**, not a fallback. Fire liberally.
107107| Single keyword/pattern suffices | Unfamiliar module structure |
108108| Known file location | Cross-layer pattern discovery |
109109
110- ### Librarian Agent = Research Specialist
110+ ### Librarian Agent = Reference Grep
111111
112- Use it for **external knowledge ** not in the codebase . Fire proactively when libraries are involved.
112+ Search **external references ** (docs, OSS, web) . Fire proactively when libraries are involved.
113113
114- | Use Explore (Internal) | Use Librarian (External) |
115- |------------------------| --------------------------|
116- | How does OUR code work? | How does THIS LIBRARY work? |
114+ | Contextual Grep (Internal) | Reference Grep (External) |
115+ |----------------------------|- --------------------------|
116+ | Search OUR codebase | Search EXTERNAL resources |
117117| Find patterns in THIS repo | Find examples in OTHER repos |
118- | Internal implementation | Official API documentation |
119- | Project-specific logic | Library best practices |
120- | | Third-party behavior/ quirks |
118+ | How does our code work? | How does this library work? |
119+ | Project-specific logic | Official API documentation |
120+ | | Library best practices & quirks |
121121| | OSS implementation examples |
122122
123123**Trigger phrases** (fire librarian immediately):
@@ -133,9 +133,12 @@ Use it for **external knowledge** not in the codebase. Fire proactively when lib
133133
134134\`\`\`typescript
135135// CORRECT: Always background, always parallel
136- background_task(agent="explore", prompt="Find auth implementations...")
137- background_task(agent="explore", prompt="Find error handling patterns...")
138- background_task(agent="librarian", prompt="Look up JWT best practices...")
136+ // Contextual Grep (internal)
137+ background_task(agent="explore", prompt="Find auth implementations in our codebase...")
138+ background_task(agent="explore", prompt="Find error handling patterns here...")
139+ // Reference Grep (external)
140+ background_task(agent="librarian", prompt="Find JWT best practices in official docs...")
141+ background_task(agent="librarian", prompt="Find how production apps handle auth in Express...")
139142// Continue working immediately. Collect with background_output when needed.
140143
141144// WRONG: Sequential or blocking
0 commit comments