/research-synthesis
/research-synthesis — Reconciles the collected sources into a state-of-the-art map and literature matrix, adversarially verifies every claim, and states the explicit research gap.
Role: Principal Investigator (synthesis) Pipeline position: mid-chain
Reconciles the collected sources into a state-of-the-art map + literature matrix and states the explicit research gap the work addresses. Every load-bearing claim is adversarially verified against two or more independent sources, refute-by-default.
Canonical invocation
/research-synthesisWith arguments:
/research-synthesis [--suite-name NAME]Inputs
_inputs/source-ledger.md (the ranked, screened source index) plus the per-source extractions under sources/.
Outputs
_inputs/synthesis.md — the SOTA map, the literature matrix, the contested-findings ledger, and the explicit one-sentence gap statement with the search coverage it rests on. It reports both the report count and the study count.
Downstream
/research-proposal (downstream consumer)
Workflow phases
The command follows the standard /research pipeline workflow:
- Load context — Read the source ledger and the per-source extractions.
- Verify the Sequence Gate — Confirm the source ledger exists; otherwise halt with
Blocked: run /research-sources first. - Synthesize — Build the SOTA map + literature matrix, carrying each source's study id, evidence class, and integrity status from the ledger; reconcile agreements and contradictions; state the explicit gap and name the search coverage it rests on.
- Adversarially verify — Every load-bearing claim is refuted-by-default against two or more independent studies.
- Update the handoff manifest — Record the synthesis path and the contested-claims ledger.
- Emit the synthesis —
_inputs/synthesis.md.
Rigor floor
Before the gap statement is finalized, the synthesis reconciles its terminology, findings, and recommendations against related sibling corpora (cross-corpus coherence); a conflict is recorded in the contested-findings ledger, never silently harmonized. The gap must resolve to a distinct, parsimonious contribution — not one already closed by a corroborated claim, and not decomposable into overlapping non-distinct elements.
Counting evidence
- Studies, not reports. Reports that share a study id in the ledger, studies that share a collected sample, and sources that cite each other count as one source; two papers from one author group are checked for shared data first. Certainty ratings count independent studies the same way.
- Integrity. A retracted or withdrawn source does not count toward corroboration, and a source whose integrity status is
concernis never the sole support for a claim. - Contrary evidence and coverage. A prior synthesis found in the search locates primary studies and does not count beside them. When the contrary-evidence class retained nothing, the finding is recorded as
none found in the searches recorded, never as consensus, and the gap sentence names its scope in the same terms: the indexes, the terms and date range, the date last run, and any pass flaggedincomplete.
Failure modes
| Symptom | Cause | Recovery |
|---|---|---|
| Blocked: run /research-sources first | No source ledger | Run /research-sources to produce _inputs/source-ledger.md |
| Claim survives without ≥2 independent studies | Insufficient corroboration, or the sources share a study or a sample | Mark contested or unverifiable; do not assert |
| Gap stated as absence in the field | The gap sentence has no search coverage behind it | Name the searches recorded as the scope; never assert an absence beyond them |
| No explicit gap statement | Synthesis lacks a target | Re-derive the one-sentence gap the research addresses |
Examples
# Synthesize the collected sources into a SOTA map + gap
/research-synthesis --suite-name <name>Cross-references
/research-sources
/research-sources — Systematic source collection: decomposes the spec into sub-queries, fans out parallel discovery, screens and ranks, and extracts per source into a ranked source ledger with a re-runnable search record.
/research-proposal
/research-proposal — Transforms the synthesized gap and theoretical framework into a fundable, reviewable plan-of-record: SMART aims, feasibility and risk register with contingencies, impact pathway, preregistration plan, data management and sharing plan, and EQUATOR reporting-guideline selection, plus a requirement matrix for a supplied funder call and a standalone resubmission response — the proposal stage of the /research pipeline, between /research-synthesis and /research-design.