Distill documents into vault pages using Ark folder structure and frontmatter
Ingest documents (markdown, text, PDF, images) into the project's Obsidian vault by distilling knowledge into interconnected pages.
{vault_path}/_meta/vault-schema.md to understand folder structure and content placement{vault_path}/index.md to know what's already documentedAccept source material in any format:
.md), plain text (.txt).pdf) — use Read tool with pages parameter.png, .jpg, .webp) — use Read tool for visual contentIdentify:
Use _meta/vault-schema.md to decide where pages belong. Ark vaults use domain-specific folders, not generic categories:
| Content Type | Placement |
|---|---|
| Architecture decisions | {project_area}/Architecture/ |
| Research findings | {project_area}/Research/ |
| Operational guides | {project_area}/Operations/ |
| Cross-cutting insights | {project_area}/Research/Compiled-Insights/ |
| Infrastructure docs | Infrastructure/ (if applicable) |
Do NOT create concepts/, entities/, skills/, references/, or synthesis/ folders — these are obsidian-wiki conventions, not Ark conventions.
For each piece of knowledge:
index.md for existing pages on this topiclast-updated: and summary:---
title: "Page Title"
type: research|reference|guide|compiled-insight|architecture
tags: [use canonical tags from _meta/taxonomy.md]
summary: "<=200 char description of what this page contains"
source-sessions: []
source-tasks: []
created: YYYY-MM-DD
last-updated: YYYY-MM-DD
---
provenance: markers — Ark vaults don't use themcd {vault_path}
python3 _meta/generate-index.py
cd {vault_path}
git add -A
git commit -m "docs: ingest {source_description} — {N} pages created/updated"
git push