| name | yolo-research |
| description | Use before planning a YOLO change, to understand the codebase and any cited intake before a plan is written. Read-only exploration that produces context for yolo-plan. Triggers on "understand how X works", "explore the code before we change it", or as the research step of yolo-feature. |
yolo-research
Read-only exploration. You gather the context a plan needs; you change nothing.
Inputs
- A brief (
workspace/features/<slug>/brief.md) — read goal, success_criteria, intake_refs.
Or, when invoked standalone, a plain question.
Procedure
- Identify the relevant surface:
Glob/Grep for the entities, modules, and routes named in the goal.
- Read the key files. Capture concrete
file:line references — never vague summaries.
- If the brief lists
intake_refs, read those files from the intake folder (intake.folder, default docs/) — search the docs engine first. Do not fetch live sources for intake; if referenced context is missing from the folder, surface the gap (a docs-engine / connector step must add it first).
- Note: existing patterns/conventions to follow, integration points, risks, and any open questions that would block planning.
Output
Write a concise note to workspace/features/<slug>/research.md (or return it inline when standalone) and commit it (yolo: research <slug>). Sections: Findings (with file:line), Patterns, Integration points, Risks, Open questions. Keep it tight — this feeds yolo-plan, not a human report.
Constraints
- Read-only: never edit code, never run mutating commands.
- No status files. You do not set or read any feature "status" — that is derived from git (
.claude/yolo/conventions.md).
- Cite
file:line; do not invent APIs.