# AGENTS.md

## OVERVIEW
Obsidian vault for homelab infrastructure documentation using Dataview and Tasks plugins.

## STRUCTURE
- `homelab/` - Infrastructure architecture, host configs, runbooks
- `ai-assistant/` - OpenCode agent configuration and workflows
- `automation/` - Script documentation and deployment workflows
- `platform-config/` - Docker, Traefik, and container orchestration
- `tools/` - Tool guides and documentation
- `Templates/` - Project and task templates
- `Dashboard/` - Project status tracking

## WHERE TO LOOK
- Start: `vault-readme.md` for vault overview
- Infrastructure: `homelab/architecture.md` for full architecture
- Tasks: Use `project.md` in each subdirectory with Dataview queries
- Templates: Reference `Templates/project-template.md` for structure

## CONVENTIONS
- **YAML Frontmatter**: Use `project:` metadata in all project.md files
- **Links**: Standard Obsidian wiki-links: `[[filename.md|Display Text]]`
- **Dataview**: Embed queries in ```dataview blocks for task tracking
- **Tasks**: Use `[ ]` for incomplete, `[x]` for completed
- **Dates**: ISO 8601 format in YAML

## ANTI-PATTERNS
- DON'T create tasks without Dataview query in project.md
- DON'T use hardcoded file paths in links - use Obsidian wiki-links
- DON'T duplicate templates - inherit from Templates/ directory
- DON'T mix project content in vault root - use subdirectories
- DON'T store credentials, API tokens, or secrets in vault files