Read wiki/governance/ before acting. Capture changes sources/ only; never
create or update wiki concepts.
Workflow
-
Read
wiki/governance/policy.md; honor its sensitivity levels and provider restrictions. -
Classify the input, then run
scripts/capture_source.pywith the input and--vault <path>. Add--convertonly when a Markdown extraction adds value:python3 scripts/capture_source.py <input-or-url> --vault <path> \ --source-kind original --sensitivity private python3 scripts/capture_source.py <input-or-url> --vault <path> \ --convert --verification partial
- If the command reports
duplicateand exits 2, stop. Report the existing source; do not write a second copy or ingest it. - For converted documents, compare the capture with the original for section
coverage, tables, images, attachments and OCR quality. Use
partialuntil those checks pass; rerun capture as an erratum rather than editing an immutable source. - For an AI-assisted conclusion, use
--origin ai-assisted --source-kind knowledge-note; preserve context, references and open questions in the input. Do not present it as primary evidence or preserve a full chat unless the user explicitly requests that. - Report the manifest identity, original path, derived capture path when present, canonical URL and verification status. Do not ingest automatically.
Boundaries
- Read
wiki/governance/policy.mdbefore processing content; honor itsdefault_sensitivity,sensitivity_levels, andauthorized_providers. - Do not ingest automatically. Tell the user what was captured and wait for an explicit ingest request.
- Do not preserve full AI chat transcripts unless the user explicitly requests it.
Read references/source-metadata.md when choosing metadata or handling an
AI-assisted session.