# AGENTS.md (Obsidian Skill)

## OVERVIEW
Core control plane for Obsidian vault operations. Manages routing to specialized reference files for reading, writing, organization, and ingestion.

## CORE RULES
- **Grounded Answers**: Answer only from notes actually read.
- **Plan Before Action**: Create read/write plans before execution.
- **Minimal Changes**: Patch smallest relevant sections.
- **Conservative Routing**: Ask if PARA placement or identity is ambiguous.
- **Idempotency**: Ensure repeated runs produce the same result.

## READ DISCIPLINE
- **Search First**: Use search tools before loading specific notes.
- **Incremental Loading**: Read notes in stages; don't ingest the whole vault.
- **Verification**: Confirm note content matches expectations before summarizing.
- **Reference**: [[references/read-workflow.md]]

## WRITE DISCIPLINE
- **Write Plan**: Define exactly what will be changed and where.
- **Small Patches**: Use `Edit` tool for surgical updates; avoid full-file rewrites.
- **Markdown Specialist**: Delegate formatting to `obsidian-markdown` skill.
- **Reference**: [[references/write-routing.md]]

## PARA ROUTING
- **Projects**: Active tasks with a deadline.
- **Areas**: Ongoing responsibilities.
- **Resources**: Interests and reference material.
- **Archive**: Completed or inactive items.
- **Inbox**: Default for new, unclassified notes.
- **Dashboards**: High-level overviews and MOCs.
- **Reference**: [[references/para-routing.md]]

## INTEGRITY
- **Link Repair**: Fix broken wikilinks after moves or renames.
- **Alias-First**: Keep old titles as aliases when renaming to preserve inbound links.
- **Deduplication**: Check for existing notes before creating new ones.
- **Reference**: [[references/integrity-sweep.md]]

## TRANSCRIPT INGESTION
- **Intake**: Process from `Inbox/Transcripts` or `Inbox/Transcriptions`.
- **Speaker ID**: Map speakers to person notes; ask if ambiguous.
- **Archiving**: Move processed files to archive after successful ingestion.
- **Reference**: [[references/transcript-ingestion.md]]

## LINK DISCOVERY
- **New Note Suggestions**: Suggest 3-5 related notes when creating manually
- **Explicit Only**: Auto-link only explicit connections (project, person, direct mentions)
- **Conservative**: Suggest thematic links, let user decide
- **Reference**: [[references/link-discovery.md]]

## REFERENCES
- [[SKILL.md]]: Main skill router.
- [[references/read-workflow.md]]: Grounded reading discipline.
- [[references/write-routing.md]]: Note creation/editing rules.
- [[references/para-routing.md]]: Note placement rules.
- [[references/integrity-sweep.md]]: Post-change safety.
- [[references/transcript-ingestion.md]]: Transcript processing.
- [[references/task-conventions.md]]: Task extraction/formatting.
- [[references/people-style-profile.md]]: Communication profiles.