davila7--claude-code-templates/cli-tool/components/skills/development/swarmvault/examples/research-workflow.md

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

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.