jmb-research

Installation
SKILL.md

Spin up a background agent to do the research, so you keep working while it reads. Start it with a fresh context window.

Its job:

  1. Investigate the question against primary sources (official docs, source code, specs, first-party APIs), not a secondary write-up of them. Follow every claim back to the source that owns it.

  2. Write the research report: a single Markdown file citing each claim's source, in the language of the "Documentation" scope of the Languages table in AGENTS.md. Name it <YYYY-MM-DD>-<slug>.md, with today's date. When it cites numbers that helper scripts produced, make it a folder <YYYY-MM-DD>-<slug>/ instead, with the report as README.md and the scripts beside it, written in the language of code.

  3. Open it with its snapshot line, the first line of the file:

    Snapshot of for . Not updated: later research supersedes it.

    Without a ticket, the line drops the ticket: "Snapshot of . Not updated: later research supersedes it."

  4. Save it where the repo already keeps such notes, matching the existing convention; if it keeps none, in docs/research/.

  5. If an earlier report answers the same question, this one supersedes it: add Superseded by <relative link to the new report>. right after that report's snapshot line. Once a report is on main, that line is the only edit it ever takes.

  6. Return the report's path, a one-line gist of its answer, and the path of the report it supersedes, if any.

The agent reads anything in the checkout and runs read-only commands, and leaves the report in place, uncommitted, for the session that launched it: it writes nothing to git, no branch, commit or push.

Landing the report

Installs
2
First Seen
3 days ago