2.0 KiB
2.0 KiB
description, args, section, topLevelCli
| description | args | section | topLevelCli |
|---|---|---|---|
| Run a literature review on a topic using paper search and primary-source synthesis. | <topic> | Research Workflows | true |
Investigate the following topic as a literature review: $@
Derive a short slug from the topic (lowercase, hyphens, no filler words, ≤5 words). Use this slug for all files in this run.
Workflow
- Plan — Outline the scope: key questions, source types to search (papers, web, repos), time period, expected sections, and a small task ledger plus verification log. Write the plan to
outputs/.plans/<slug>.md. Present the plan to the user and confirm before proceeding. - Gather — Use the
researchersubagent when the sweep is wide enough to benefit from delegated paper triage before synthesis. For narrow topics, search directly. Researcher outputs go to<slug>-research-*.md. Do not silently skip assigned questions; mark themdone,blocked, orsuperseded. - Synthesize — Separate consensus, disagreements, and open questions. When useful, propose concrete next experiments or follow-up reading. Generate charts with
pi-chartsfor quantitative comparisons across papers and Mermaid diagrams for taxonomies or method pipelines. Before finishing the draft, sweep every strong claim against the verification log and downgrade anything that is inferred or single-source critical. - Cite — Spawn the
verifieragent to add inline citations and verify every source URL in the draft. - Verify — Spawn the
revieweragent to check the cited draft for unsupported claims, logical gaps, zombie sections, and single-source critical findings. Fix FATAL issues before delivering. Note MAJOR issues in Open Questions. If FATAL issues were found, run one more verification pass after the fixes. - Deliver — Save the final literature review to
outputs/<slug>.md. Write a provenance record alongside it asoutputs/<slug>.provenance.mdlisting: date, sources consulted vs. accepted vs. rejected, verification status, and intermediate research files used.