AGENTS

Agent Guidelines for Obsidian Brain Vault

Project Type

This is an Obsidian knowledge vault containing personal notes, research, and documentation published as a static site using Quartz.

Commands

• Validation: npx linkinator --recurse --silent https://brain.ansonbiggs.com
• No build/test commands - Content is managed through Obsidian and published via GitLab CI pipeline
• Publishing: Changes trigger GitLab CI which builds and deploys via brain-quartz project

Content Guidelines

• Format: All files are Markdown (.md) with YAML frontmatter
• Frontmatter structure:

  ---
  categories: ["[[Category]]"]
  tags: [tag-one, tag-two] 
  publish: true/false
  ---

• Links: Use Obsidian double-bracket syntax [[Page Name]] for internal links
• Categories: Reference other pages using bracket syntax "[[Category Name]]"
• Privacy: Content in private/ folder should not be made public or referenced in published content
• Templates: Use existing templates in Templates/ folder for consistency

File Organization

• Root level: Main topic pages and indexes
• Daily/: Daily notes and time-based content
• Templates/: Page templates with standard frontmatter
• private/: Personal/sensitive content (never publish)
• Archive/, Clippings/: Historical and reference content