# Conventions

## Commit messages

Format: `[AO] <type>: <summary>` where type is feat, fix, refactor, test, docs, chore.

## Branch naming

Pattern: `agent/<issue-id>-<short-desc>` (when using feature branches).

## Issue IDs

Always full form: `TYPE-NNNN@HHHHHH` (e.g., `FEAT-0042@abc123`).

## CLI flags

Global flags go **before** the subcommand:

```bash
ao add "Title" --type feat              # no flags needed for most commands
ao --yes compact                        # --yes only for interactive commands (auto-sets json+none)
ao <subcommand> --yes                  # wrong
```
