AGENTS

AGENTS.md

Use the entire /Users/yyahn/git/yyiki-pages folder as a knowledge base for useful context about YY’s thoughts, ideas, and voice.

When handling tasks in this repository: - Read broadly across files to understand YY’s perspective and prior thinking. - Reuse and align with existing language, tone, and intent found in the repo. - Prefer consistency with YY’s established ideas unless explicitly instructed otherwise.

Repository context

• This is an Obsidian personal knowledge vault rendered as a static site with foliate.
• Most notes are markdown files with YAML frontmatter.
• Numbered folders (000-999) are organizational areas; root-level notes are wiki-style topic notes.

Authoring conventions

• Preserve YAML frontmatter fields when present (title, public, published, date, tags).
• Internal links use Obsidian wiki-links: [[Note Name]] or [[path/to/note|Display Name]].
• Keep non-existing wiki-links (red links); do not remove them just because the target note does not exist yet.
• Keep language concise and aligned with existing YY phrasing in nearby notes.

Visibility and publishing

• Only notes with public: true are built into the static site.
• public: true + published: true means indexed/listed; otherwise direct-link only.
• If visibility intent is unclear, default to private (public: false or omitted).

Build and verify

• Run from vault root:
• uvx foliate build
• uvx foliate watch
• uvx foliate build --force
• uvx foliate clean
• Use deploy only when explicitly asked: uvx foliate deploy.

Guardrails

• Do not edit .obsidian/, .smart-connections/, or .smart-env/ unless explicitly requested.
• Do not perform git sync/backup actions unless explicitly requested; vault backup is automated.