You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 

1.2 KiB

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-triagewontfix). 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:
    $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.