Skip to main content

AGENTS.md

Defines the rules, constraints, and boundaries that the agent operates within. Think of it as the project-level rulebook.

Purpose​

The agent uses AGENTS.md to understand what it can and cannot do — file access rules, tool usage restrictions, safety red lines, and project-specific conventions.

Example​

# Project Rules

## Workspace
- The project root is the default working directory
- Do not modify files outside the project directory without explicit permission

## Safety
- Never delete files without confirmation
- Never run destructive commands (rm -rf, format, etc.) without asking
- Limit exec commands to the tools.exec.allowlist

## Conventions
- Use Python type hints in all new code
- Follow PEP 8 style guide
- Commit messages follow conventional commits format

## Channels
- On Discord, keep replies concise and use thread replies when available
- On Feishu, respect the message card format

Notes​

  • This file is loaded at session startup
  • Keep it focused on rules and constraints — persona goes in SOUL.md
  • Content exceeding 4000 characters is truncated automatically