AGENTS.md

Этот репозиторий заточен под долгие сессии работы coding-агентов. Держите этот файл коротким. Используйте его как маршрутизирующий слой к документам — системе записи, а не как огромный сброс инструкций.

Стартовый рабочий процесс

Перед изменением кода:

1. Подтвердите корень репозитория через pwd.
2. Прочитайте ARCHITECTURE.md для текущей карты системы и жёстких правил зависимостей.
3. Прочитайте docs/QUALITY_SCORE.md, чтобы увидеть, какие домены или слои самые слабые.
4. Прочитайте docs/PLANS.md, затем откройте активный план, по которому работаете.
5. Прочитайте релевантную продуктовую спецификацию в docs/product-specs/.
6. Запустите стандартный путь bootstrap и верификации для этого репозитория.
7. Если базовая верификация падает, почините её до расширения скоупа.

Карта маршрутизации

• ARCHITECTURE.md: карта доменов, модель слоёв, правила зависимостей
• docs/design-docs/index.md: дизайн-решения и базовые убеждения
• docs/product-specs/index.md: текущее продуктовое поведение и критерии приёмки
• docs/PLANS.md: жизненный цикл планов и политика exec plans
• docs/QUALITY_SCORE.md: здоровье продуктовых доменов и слоёв
• docs/RELIABILITY.md: рантайм-сигналы, бенчмарки и ожидания по перезапуску
• docs/SECURITY.md: правила по секретам, песочнице, данным и внешним действиям
• docs/FRONTEND.md: ограничения UI, правила дизайн-системы, проверки доступности

Рабочий контракт

• Работайте по одному ограниченному плану или фиче-срезу за раз.
• Не помечайте работу как готовую только по результатам инспекции кода; нужны запускаемые доказательства.
• Если вы меняете поведение, обновите соответствующие продуктовые, плановые или reliability-документы в той же сессии.
• Если вы видите повторяющийся фидбек на ревью, превратите его в механическое правило, проверку или линтер вместо повторного объяснения в чате.
• Храните сгенерированные материалы в docs/generated/, а исходные ссылки — в docs/references/.
• Предпочитайте добавлять небольшие актуальные документы вместо разрастания этого файла.

Definition Of Done

Изменение считается готовым только когда выполнено всё:

• целевое поведение реализовано
• требуемая верификация действительно прошла
• доказательство приложено в соответствующем плане или документе по качеству
• затронутые документы остаются актуальными
• репозиторий чисто перезапускается со стандартного стартового пути

Конец сессии

Перед завершением сессии:

1. Обновите активный exec plan.
2. Обновите docs/QUALITY_SCORE.md, если какой-либо домен или слой существенно изменился.
3. Запишите новый техдолг в docs/exec-plans/tech-debt-tracker.md, если вы его отложили.
4. Перенесите завершённые планы в docs/exec-plans/completed/, когда уместно.
5. Оставьте репозиторий в перезапускаемом состоянии с чётким следующим шагом.