Skip to content

Project Configuration

Customize Agent Nine's behavior per project using configuration files.

agentnine.md

Create a agentnine.md file in your project root to give Agent Nine project-specific instructions:

markdown
# Project: My App

## Stack
- Your stack and frameworks
- Databases used

## Conventions
- Use functional components
- Tests go in __tests__/ directories
- Package manager preference

## Rules
- Never modify files in vendor/
- Always run tests before committing
- Use snake_case for database columns

Agent Nine reads this file at the start of every session and follows the instructions.

.agent-nine/

Agent Nine may create a .agent-nine/ directory in your project when using certain features:

text
.agent-nine/
├── plan.md          Created when using plan mode
├── hooks.json       Your custom hooks (you create this)
├── mailboxes/       Created when agents exchange messages
├── agents/          Created when using sub-agents
└── worktrees/       Created when using git worktree isolation

These files are created only when you use the corresponding feature. Add .agent-nine/ to your .gitignore:

text
# Agent Nine
.agent-nine/

Agent Nine — AI coding assistant