# Capture Workflow

1. Search first with `search` to avoid duplicates.
2. Use `list_tags` to align with existing vocabulary.
3. Choose the correct content type:
   - `create_note` for ideas, synthesis, and decisions.
   - `create_reference` for external sources with `subtype`.
   - `create_task` for actionable follow-up work.
   - `garden_seed` for quick capture.
   - `ingest_source` for raw text, markdown files, and provider-backed URL capture.
4. Prefer one-step creation with authored content:
   - `create_note` accepts `body`, `key_points`, `aliases`, and `links`.
   - `create_reference` accepts `subtype` in addition to `url`.
   - `ingest_source` creates structured references with provenance when the source needs to stay attached.
   - When an agent fetched or extracted a source outside ztlctl, read `ztlctl://capture/spec` first.
   - Prefer a nested `source_bundle` over loose ingest metadata for web pages, transcripts, OCR output, screenshots, and other multimodal captures.
   - `ingest_source` still accepts flat `source_kind`, `modalities`, `citations`, `excerpts`, and `artifacts` fields, but ztlctl will normalize them into the durable source bundle format internally.
5. Run `reweave` on important new content.
