About tracer-research
tracer-research is a research skill for agents handling a focused question. It produces a cited Markdown note, prioritizing primary sources and recording confidence, gaps, and decision implications.
Key features
- 01Prioritize primary sources
- 02Write one Markdown research note
- 03Cite material claims
- 04Separate facts from inference
- 05Record confidence and open gaps
Use cases
- 01Answer a focused research question
- 02Support a decision with cited findings
- 03Research a Wayfinder ticket in an isolated checkout
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ scottwater/ skills --skill tracer-researchAfter installing, type/tracer-researchin Claude Code to confirm it loaded.
Bundled filesagents/openai.yaml
Details
From the project READMEResearch
The caller gives one focused question to one background worker so the parent session can continue. If you are that worker, perform the research directly; do not delegate again.
The worker must:
- Start with primary sources — official documentation, specifications, source code, first-party APIs, or the local resource that owns the fact. Do not cite a secondary summary when its underlying source is available.
- Write the findings to one Markdown note. Match the repo's existing research-note convention; if none exists, use
docs/research/<question-slug>.md. - Cite the source for every material claim and distinguish sourced facts from inference. Include confidence, unresolved gaps, and the implications for the decision waiting on the research.
- Return the note's path plus a concise answer. Do not modify product code.
For a /tracer-wayfinder research ticket, follow the map's capture protocol: work in an isolated checkout, commit the note to the assigned unique research/<map-slug>/<ticket-slug> branch, and return the answer plus a branch or commit pointer. Also return a ## Map delta that states the one-line decision gist, fog entries this answer makes precise or obsolete, proposed new decision tickets and blockers, and any scope change. Do not edit the map or local .tracer/ ticket state; the Wayfinder coordinator records the resolution and applies the delta.