crm-backend-matt/AGENTS.md

# Agents

Guidance for AI agents working in this repo.

## Agent skills

### Issue tracker

Issues and specs live as markdown files under `.scratch/`. See `docs/agents/issue-tracker.md`.

### Triage labels

Five canonical roles, each label string equal to its name (`needs-triage` … `wontfix`). See `docs/agents/triage-labels.md`.

### Domain docs

Multi-context: root `CONTEXT-MAP.md` points at one `CONTEXT.md` per `crm-{域}` module. See `docs/agents/domain.md`.

## Coding standards

### Source file encoding

All `.java` source files **must be UTF-8 without BOM** (no `EF BB BF` byte prefix).

- Maven's `javac` fails on BOM with `illegal character: '\uFEFF'`; IntelliJ IDEA tolerates BOM, so IDE-only compilation masks the problem until `mvn compile`.
- If `mvn compile` reports `illegal character: '\uFEFF'`, a tool has written the file with BOM. Strip it before retrying:
  ```powershell
  $b = [IO.File]::ReadAllBytes('path/to/File.java')
  if ($b[0] -eq 0xEF -and $b[1] -eq 0xBB -and $b[2] -eq 0xBF) {
      [IO.File]::WriteAllBytes('path/to/File.java', $b[3..($b.Length-1)])
  }
  ```
- Run a full BOM scan across all `*.java` files after bulk edits (Write/SearchReplace) and before `mvn compile`.