mini-lakehouse-lab/docs/agents/domain.md

Документация предметной области

Правила работы инженерных навыков с документацией предметной области при изучении кодовой базы.

Что прочитать перед изучением кодовой базы

• CONTEXT.md в корне репозитория
• CONTEXT-MAP.md в корне репозитория, если он существует: файл указывает на отдельные CONTEXT.md для разных контекстов
• docs/adr/: ADR, относящиеся к области предстоящих изменений

Если какого-либо файла или каталога нет, продолжай работу без предупреждения. Не отмечай его отсутствие и не предлагай создать его заранее. Навык /domain-modeling создаёт такие документы по мере необходимости, когда появляются новые термины или архитектурные решения.

Структура файлов

Этот репозиторий использует схему single-context:

/
├── CONTEXT.md
├── docs/adr/
│   ├── 0001-example-decision.md
│   └── 0002-another-decision.md
└── src/

Используй термины из глоссария

Когда в результате работы появляется понятие предметной области — например, в названии задачи, предложении по рефакторингу, гипотезе или названии теста, — используй термин из CONTEXT.md. Не заменяй его синонимами, которые глоссарий явно исключает.

Если нужного понятия в глоссарии нет, проверь, действительно ли оно относится к проекту. Если относится, зафиксируй пробел для последующей проработки через /domain-modeling.

Отмечай противоречия с ADR

Если предлагаемое изменение противоречит существующему ADR, явно укажи на конфликт, а не отменяй ранее принятое решение молча.