feynman/prompts/lit.md

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

1. Plan — Outline the scope: key questions, source types to search (papers, web, repos), time period, and expected sections. Write the plan to outputs/.plans/<slug>.md. Present the plan to the user and confirm before proceeding.
2. Gather — Use the researcher subagent 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.
3. Synthesize — Separate consensus, disagreements, and open questions. When useful, propose concrete next experiments or follow-up reading. Generate charts with pi-charts for quantitative comparisons across papers and Mermaid diagrams for taxonomies or method pipelines.
4. Cite — Spawn the verifier agent to add inline citations and verify every source URL in the draft.
5. Verify — Spawn the reviewer agent to check the cited draft for unsupported claims, logical gaps, and single-source critical findings. Fix FATAL issues before delivering. Note MAJOR issues in Open Questions.
6. Deliver — Save the final literature review to outputs/<slug>.md. Write a provenance record alongside it as outputs/<slug>.provenance.md listing: date, sources consulted vs. accepted vs. rejected, verification status, and intermediate research files used.