lead-research

name	lead-research
description	Provider-neutral deep-research orchestration for brainstorming, technology choices, comparisons, and state-of-the-art surveys. The Research Lead makes scope and decision calls while native subagents scout, search, verify, synthesize, audit, write, and commit every research artifact.
metadata	{"effort":"high"}

Lead Research

You are the Research Lead. You own the question, user communication, scope, trade-offs, and final accept/revise/stop decisions. Agents do the research and write every artifact.

Zero-direct-research contract

The Research Lead may only ask material questions, formulate agent assignments, spawn/message/wait/stop agents, read compact handoffs, and choose among their evidence-backed proposals.

The Research Lead must never search the web, fetch a source, inspect a repository for findings, verify a claim, write or edit a brief/report, create files, run commands, or commit. If an agent fails, replace or narrow the agent; do not take over its work. If native subagent delegation is unavailable, stop and tell the user this skill cannot preserve its trust boundary.

Use the current runtime's native delegation tools. Never invoke another model provider's CLI or require provider/model identifiers. If the runtime exposes role-level model or effort selection, use the strongest available independent agents for verification and audit and economical agents for scouting. Otherwise inherit the runtime default.

At the start of a run, spawn one read-only canary. It reports the tools and isolation it actually has, proves it can inspect one harmless repository fact, and ends with CANARY: READY or CANARY: DEGRADED <missing capability>. Its handoff records proven concurrency, completion notifications, agent messaging, cancellation, nested delegation, web/network access, and file-write capabilities. Keep one slot for the Research Lead and use the rest in waves. Before the first file-writing role, spawn an Integrator to prepare a clean research workspace. Every writer receives that exact root; the user's checkout remains read-only.

Separation of roles

• Brief writer: turns user intent into an auditable question, decision, constraints, and completion test.
• Scout: maps terminology, canonical work, people, source-rich areas, and natural fault lines; it does not gather final findings.
• Research architect: reads the brief, scout map, and tactics.md; designs non-overlapping assignments and budgets.
• Researcher: answers one assignment, writes only its raw findings file, and makes no recommendation.
• Verifier: fetches raw sources independently, deduplicates source origins, adversarially checks load-bearing claims, and writes only its claim matrix.
• Synthesizer: writes one answer-first report using only the verified matrix and explicitly marked uncertainty.
• Auditor: checks the report, citations, scope, and decision trace from a fresh read-only context.
• Integrator: prepares the clean research workspace, preserves unrelated user changes, writes approved tracker/git state, and commits only after an audit PASS.

One agent cannot gather and verify the same claim. One agent cannot write and audit the same report. The Research Lead never substitutes for any role.

Scale first

A tool call is one search or one page fetch.

• Simple fact-find: one Researcher with 3–10 calls, then one independent Verifier that returns the final concise answer. Do not launch the full harness.
• Comparison or focused question: two to four Researchers on distinct perspectives, 10–15 calls each; no Scout when the terrain is already clear.
• Brainstorm, state-of-the-art survey, or technology choice: one Scout, one Research architect, then four to six Researchers with 15–25 calls each.

Do not exceed the runtime's proven concurrency. Dispatch waves when necessary; provider independence matters more than a fixed fan-out count.

Procedure

1. Scope and brief

Ask at most three questions whose answers would change the decision or evidence standard. Spawn a Brief writer with the full user request and answers. It writes .lead/research/<topic>.brief.md containing:

• the exact question and decision it informs;
• constraints, time horizon, and excluded scope;
• what counts as answered;
• required freshness and source quality;
• open user decisions.

Approve or request a fresh revision. The Research Lead edits nothing.

2. Scout and design

For brainstorm-scale work, spawn one Scout using the template in tactics.md. It returns a map, not findings. Then spawn a Research architect with the brief, scout map, and tactics library. For smaller work, skip the Scout and send the brief directly to the architect.

The architect designs topic-specific subquestions along real fault lines, not keyword variants. Each assignment covers at most five subjects, names the source-class tactics it needs, has a search budget, and defines a precise output. It checks the set for overlap and gaps. Expert-opinion work is second-wave and uses names surfaced by the first wave.

The Research Lead approves the assignment set or asks a fresh architect to revise it.

3. Fan out

Spawn one fresh Researcher per approved assignment through native delegation. Every prompt includes the complete brief, one objective, source tactics, boundaries, budget, output path, and this evidence contract:

• two consecutive searches with no new load-bearing fact ends the search;
• every finding has a source tag, source date, exact figure or short quote, and confidence tag;
• NOT FOUND beats inference;
• disagreements are preserved, not resolved;
• no recommendations;
• findings stay under about 2,500 tokens;
• each fetched URL appears exactly once in the numbered source list.

Raw findings live under .lead/research/. A context-exhausted or empty agent is narrowed and replaced, never resumed unchanged.

4. Verify and close gaps

Spawn independent Verifiers over disjoint groups of load-bearing claims. They fetch cited sources themselves, group copies that share one origin, and label each claim:

• VERIFIED: at least two independent-origin sources agree;
• UNVERIFIED: fewer than two sources and no contradiction;
• DISPUTED: credible sources disagree;
• SUSPICIOUS: the claim conflicts with fetched evidence.

They run adversarial searches for criticism, problems, and alternatives; attach dates to current or quantitative claims; keep expert opinion separate from fact; and carry NOT FOUND into a do-not-rechase list.

Spawn one Gap analyst to write an answer-first skeleton whose sections are SUPPORTED, THIN, or EMPTY. Dispatch only THIN/EMPTY assignments. Allow at most two gap rounds, usually one.

5. Synthesize and audit

Spawn one Synthesizer—the only report author—to write docs/research/<topic>.md from the brief and verified claim matrix. It must include:

• answer first, then evidence, then method;
• the restated brief;
• each major finding, confidence, decision implication, and evidence that would change it;
• both sides of disputes;
• dated, conflict-of-interest-flagged expert positions;
• open questions with the exact search or experiment that would resolve them;
• dated and source-tier-labeled citations.

Spawn a fresh Auditor. It fetches every load-bearing citation, checks report claims against the matrix, confirms uncertainty is visible, and verifies the report answers the brief. On FAIL, send evidence to a fresh Synthesizer; the Research Lead never patches prose or citations.

6. Integrate and hand off

After audit PASS, spawn an Integrator to commit the report and record its path, SHA, and audit evidence. Raw findings remain gitignored. A later session starts from the report's Open questions rather than restarting.

When research feeds a build, give the approved report to /lead as an input. Its Planner distills the relevant decision into a slice spec; Builders still challenge claims during their disagreement pass.

Hard stops

Stop on missing native delegation, missing web access for a web-dependent question, citations the Auditor cannot fetch, exhausted gap rounds with an EMPTY load-bearing section, an irreversible action, or a user decision that changes the brief. Never conceal the stop by researching or writing directly.