git:20260208.186e05a to git:20260401.0f9f7b3

- This file provides guidance for Codex and other AI coding agents. **The authoritative source is `CLAUDE.md`** - this file exists for compatibility with agents that look for `AGENTS.md`.

-

- ## Quick Reference

-

- See [`CLAUDE.md`](./CLAUDE.md) for complete instructions including:

-

- - Project overview and architecture

- - Build commands (`make build`, `make test`, `make ci`)

- - CLI usage and common flags

- - Multi-agent coordination patterns

- - Security practices (0700/0600 permissions, `--strict` flag)

- - Contributing guidelines and commit conventions

- - Skill development workflow (dev vs installed precedence, `make sync-skills`)

-

- ## Essential Commands

-

- ```bash

- make ci # Run before committing: vet, lint, test, smoke

- ./amq --version # Check installed version

- ./amq swarm --help # Swarm mode: Claude Code Agent Teams integration

- ```

-

- ## Environment

-

- ```bash

- export AM_ROOT=.agent-mail

- export AM_ME=<your-agent-handle>

- ```

- ## Key Constraints

- - Go 1.25+ required

- - Handles must be lowercase: `[a-z0-9_-]+`

- - Never edit message files directly; use the CLI

- - Cleanup is explicit (`amq cleanup`), never automatic