# Working with Lyt in this vault (for AI agents)

<!-- @AGENT_TEMPLATE version=${version} -->

This vault is a Lyt Vault, part of a federated mesh. Read this file before editing.

## What this vault is

`${vaultName}` — see [lyt-overview.md](./lyt-overview.md) for identity + mesh context.

## Commands you can run

- `lyt vault info <name>` — show this vault's metadata
- `lyt vault list` — show every registered vault on this machine
- `lyt mesh status` — show the federation graph
- `lyt mesh init --from <manifest>` — bulk-init a mesh from a YON manifest
- `lyt vault regen-context <name>` — rewrite `.lyt/mesh-context.md` from current edge state
- `lyt vault sync-metadata --vault <name> [--apply]` — push vault.yon metadata to GitHub (dry-run default)
- `lyt primer --scope vault --target <name>` — regenerate the vault primer (hot keywords + arcs + recent activity)
- `lyt federation canvas` / `lyt mesh canvas --mesh <name>` — emit Obsidian Canvas visualisations
- `lyt pattern list` / `lyt pattern verbs <name>` / `lyt pattern run <p> <v> ...` — manage operational patterns
- `lyt help <topic>` — full help surface (try `lyt help patterns` or `lyt help skills`)

## How to read this vault

- `.lyt/vault.yon` — this vault's identity + mesh edges (parent, share_with, topics)
- `.lyt/mesh-context.md` — auto-regenerated mesh context (transcluded into `lyt-overview.md`)
- `.lyt/primers/` — agent-priming markdown (committed by default; regenerated by `lyt primer`)
- `.lyt/canvases/` — Obsidian Canvas visualisations of federation + mesh graphs (committed; regenerated by `lyt federation canvas` + `lyt mesh canvas`)
- `.obsidian/` — optional Obsidian config, created only with `lyt vault init --template obsidian-default`
- `notes/` — Figments (markdown notes) live here
- `.lyt/patterns/` — symlinks to installed Lyt patterns (machine-local; gitignored)

## Etiquette

- Tag new Figments with `tags:` frontmatter — the federated index uses them.
- Use `[[wikilinks]]` for cross-Figment + cross-vault references.
- Never edit `.lyt/indexes/*.db` (libSQL derived state at `.lyt/indexes/{lyt,audit,provenance}.db`, regenerated by `lyt vault rebuild-index` from YON ledger SoT in `.lyt/ledgers/`).
- Never `git add -A` — name the paths.

## Vault primer

<!-- LYT_PRIMER_BEGIN -->
${primerBlock}
<!-- LYT_PRIMER_END -->

## Installed patterns + skills

<!-- LYT_PATTERNS_BEGIN -->
${patternsBlock}
<!-- LYT_PATTERNS_END -->