| name | distill-vault-sources |
| description | Transform owner-reviewed Loreloom Source or Daily notes into traceable atomic Knowledge drafts. Use when extracting durable concepts, comparing evidence, detecting duplicate concepts, or preparing human-reviewable notes from exact Source paths. Never rewrites Sources, fills gaps from model memory, or promotes drafts to evergreen. |
Distill Vault Sources
Workflow
- Read
AGENTS.md, .agents/policies/vault-policy.md, and .agents/workflows/source-to-knowledge.md.
- Confirm exact Source inputs and the allowed Knowledge output directory.
- For every Source input, require
status: captured, review_status: reviewed, and a non-null reviewed date. Stop before reading for distillation when the Source is still processing or needs review; Daily inputs are exempt from this Source-specific gate.
- Run
uv run python scripts/validate_vault.py before reading or extraction. On any unsafe, missing, unreadable, or hash-drifted bound Asset, report the exact failure and write no Knowledge, even if URL or Inbox provenance also exists.
- Read each Source completely. Record unavailable attachments or external material instead of guessing.
- Search related Knowledge titles, aliases, and likely synonyms, then let the root propose minimal atomic boundaries and reconcile duplicates or contradictions against the original evidence.
- Use
$orchestrate-vault-work only after explicit owner opt-in when disjoint Source extraction or consequential architecture review materially benefits from advanced delegation.
- Present the proposed drafts and citations before writing unless the request already authorizes draft creation.
- Let the root agent create or update only authorized
status: draft, reviewed: null Concept notes. Preserve Sources unchanged except an explicitly authorized append-only link.
- Run
uv run --locked python scripts/validate_vault.py. An owner-approved multi-agent mutation additionally uses the immutable-base change-validator protocol and optional independent reviewer; unavailable requested review requires direct owner review and an incomplete-coverage report.
Output
List revalidated Source paths, created, updated, skipped, duplicate, contradictory, and uncertain items; include every draft path and citation, conflicts and limitations, and the owner-only final claim/citation review and optional evergreen promotion. Every draft must have valid evidence links and a conservative confidence level.
