tomevault-io Managing Agents Context
Configure the AGENTS.md file that orients AI agents to your project.
When to use
- Setting up AI agent context for a new project
- Updating agent instructions
- Adding new knowledge sources for agents
- Changing how agents should behave in your project
AGENTS.md Purpose
The AGENTS.md file is the entry point for AI agents. It tells them:
- What the project does
- Where to find critical information
- How to behave and what rules to follow
Standard Template
# AI Agent Context
You are a senior developer joining this project.
Your goal is to help build, refactor, and maintain code following our architecture.
## Knowledge Index
Before writing code, load context from:
- **Architecture:** `.context/architecture.md`
- **Rules:** `.context/rules/coding-standards.md`
- **Skills:** `.context/skills/`
## Current State
Check `.context/project_state.md` for current work status.
Best Practices
✅ Do
- Keep AGENTS.md concise (under 50 lines)
- Point to detailed files instead of duplicating content
- Update when project structure changes
- Include path to rules and conventions
❌ Avoid
- Putting detailed documentation in AGENTS.md
- Outdated file paths
- Generic instructions without project specifics
- Conflicting information between files
Placement
AGENTS.md should be at the project root:
project/
├── AGENTS.md # AI agent entry point
├── .context/ # Detailed context
│ ├── architecture.md
│ ├── project_state.md
│ ├── rules/
│ └── skills/
└── src/
Converted and distributed by TomeVault — claim your Tome and manage your conversions.