AGENTS.md

The main instructions file that provides context and guidelines to AI coding tools.

Location

.ai/AGENTS.md

Purpose

AGENTS.md contains project-specific instructions that help AI tools understand:

Project structure and architecture
Coding conventions and style guidelines
Technology stack and dependencies
Domain-specific knowledge

Format

Standard Markdown with no required frontmatter.

Example

# Project Guidelines

This is a TypeScript monorepo using pnpm workspaces.

## Code Style

- Use ESM imports
- Prefer `const` over `let`
- Use async/await over callbacks

## Architecture

- `apps/` - Application packages
- `packages/` - Shared libraries

## Commands

| Command      | Description              |
| ------------ | ------------------------ |
| `pnpm dev`   | Start development server |
| `pnpm build` | Build for production     |
| `pnpm test`  | Run tests                |

Export Mapping

Tool	Output File
Claude Code	`.claude/CLAUDE.md` (symlink)
OpenCode	`.opencode/AGENTS.md` (symlink)