AGENTS.md
AGENTS.md allows developers to encode architectural decisions, testing requirements, and styling conventions directly into version control so Plannix Build adheres to them unconditionally.
What is AGENTS.md?
Instead of repeating guidelines in every prompt, AGENTS.md is ingested by Plannix before execution starts. Any rule defined here takes precedence over the model's default training habits.
Discovery and loading priority
| Priority | File Location | Scope |
|---|---|---|
| 1 (Highest) | ./AGENTS.md | Current directory & subdirectories |
| 2 | ./.plannix/rules/*.md | Modular topic-specific rules |
| 3 | /repo-root/AGENTS.md | Workspace-wide root rules |
| 4 | ~/.plannix/global-rules.md | Developer machine global preferences |
Structuring persistent rules
Keep rules concise, specific, and actionable. Numbered lists or clear markdown headings help the model index constraints efficiently:
# Project Rules
## 1. Strictly No Emojis
Do NOT use emojis anywhere in UI, code, components, or documentation. Use Lucide icons instead.
## 2. VS Code-Style Syntax Highlighting
Whenever code snippets are displayed in UI, format them with realistic VS Code-style token coloring.
## 3. Continuous Verification
Every time code is modified, run verification (e.g. npm run build) and fix issues before completing tasks.