Research Workflow

# Research Workflow Example Use this when the user is collecting papers, articles, books, datasets, slide decks, screenshots, or other mixed research sources into one vault. ## Commands ```bash swarmvault init swarmvault add https://arxiv.org/abs/2401.12345 swarmvault add 10.1145/1234567.1234568 swarmvault ingest ./paper.pdf swarmvault ingest ./interview.mp3 swarmvault ingest https://www.youtube.com/watch?v=dQw4w9WgXcQ swarmvault ingest ./book.epub swarmvault ingest ./results.csv swarmvault ingest ./analysis.xlsx swarmvault ingest ./deck.pptx swarmvault inbox import ./capture-bundle swarmvault compile swarmvault query "What are the main claims and conflicts?" swarmvault explore "What should I read next?" --steps 3 ``` ## What To Check - `raw/sources/` contains normalized markdown captures for `add` - `state/extracts/` contains PDF, DOCX, EPUB, CSV/TSV, XLSX, PPTX, audio, YouTube, or image extraction sidecars when relevant - `wiki/graph/report.md` surfaces contradictions, surprise links, and benchmark data - `wiki/outputs/` contains saved query and explore outputs ## Guidance - Use `swarmvault add` for research URLs and `swarmvault ingest` for direct local files. - If image extraction is weak, verify that a real `visionProvider` is configured. - If audio extraction is missing, verify that `tasks.audioProvider` points at a provider with `audio` capability. - Use `lint --conflicts` when the user specifically wants contradiction review.