scout

scout

Research a topic, discover sources, score them with 6-signal confidence scoring, and produce a curated source list for human review.

Prerequisites

• A grimoire workspace must exist (SCHEMA.md present in working directory or a user-specified path)
• Read SCHEMA.md to extract topic, scope (in/out), and audience before searching
• Check for scout-queue.md — seed URLs from init should be included in the candidate pool
• Check for a prior scout-report.md — if one exists, ask the user whether to resume or start fresh

Step 1 — Locate the Grimoire

Find the grimoire workspace:

1. Look for SCHEMA.md in the current directory first
2. If not found, ask the user: "Where is your grimoire? (path to the directory containing SCHEMA.md)"
3. Parse SCHEMA.md for topic, scope.in, scope.out, and audience
4. If scout-queue.md exists, load all URLs with status pending — these are seeds from init
5. If scout-report.md already exists, show the existing report date and ask:
   • "A scout report already exists from {date}. Resume (add new angles), or start fresh?"

Do NOT proceed if SCHEMA.md is missing — scaffold the workspace first with init.

Step 2 — Plan Search Angles

Derive 4-8 search angles from the topic and scope. Cover all six source categories:

• Official documentation — primary docs, specifications, reference manuals
• Community tutorials and guides — how-tos, walkthroughs, blog posts
• Video resources — conference talks, screencasts, courses
• Social media threads — X/Twitter discussions, Reddit threads, HN posts
• GitHub repositories — reference implementations, example projects, libraries
• Academic and research sources — papers, benchmarks, formal analyses

Map each angle to a concrete search query. Use scope.out to exclude irrelevant directions.

Use AskUserQuestion to show the planned angles before searching:

I'll search these angles for "{topic}":

1. Official docs — "{query}"
2. Community tutorials — "{query}"
3. GitHub repos — "{query}"
4. X/Twitter threads — "{query}"
5. Video talks — "{query}"
6. Academic sources — "{query}"

Add angles, remove any, or adjust queries before I search?