LumaWeb/AGENTS.md

Инструкции агенту Luma Web

Этот каталог — самостоятельная основа проекта. При работе внутри исходного репозитория также действуют родительские инструкции; Apple-исходники и сгенерированный Xcode project не изменять в задачах этой основы.

Начало и продолжение

1. Прочитать master_prompt.md и выполнить его порядок действий.
2. Источник требований — неизменяемые specs/tz_clear.md и specs/uikit_clear.md.
3. Источник задач — planning/tasks.json; источник статуса — state/tasks.json.
4. Для выбора/захвата/изменения статуса использовать python3 scripts/tasks.py. Матрицы и карточки генерируются; не исправлять их вместо источника.
5. Один агент выполняет одну атомарную задачу. Не брать невыполненные зависимости, не превращать задачу в реализацию всего этапа.
6. До реализации читать свою роль, карточку, context packet, зависимости и относящиеся contracts/ADR.
7. Работать только в scope карточки. Для нового интерфейса/общего файла оформить задачу изменения плана; не ломать соседние контракты.
8. Отправлять работу в review с evidence и handoff. Статус done устанавливает отдельный reviewer с результатом проверки. Это workflow, а не техническая аутентификация личности.
9. Не хранить secrets/реальные переписки в fixtures, evidence, логах или environment examples. Не писать собственные криптографические примитивы.
10. Неподтверждённый тест не объявлять пройденным. Недоступный сервер/браузер/secret отмечать как внешнюю проверку или blocker с причиной.
11. Не обходить encryption/сертификаты/CORS ради демо. Fixtures и production transports должны быть явно разделены.
12. Не менять stack самовольно после принятого ADR. Не добавлять зависимости без проверки лицензии, поддержки браузера и API.
13. До submit/approve/reject подготовить осмысленное сообщение commit по docs/GIT_WORKFLOW.md. Git add/commit выполняет runner после остановки процесса и проверки scope. Агент не делает commit/push/reset/stash/checkout и не меняет Git config/hooks. Следующая сессия начинается после успешного commit; done без commit не считается завершённым циклом автоматизации.

Проверка основы

make check проверяет план, ссылки, snapshots и инструмент. Это не проверка готовности Web-мессенджера. App build/tests появляются в отдельной задаче после выбора стека.

Управление изменениями

Новые/изменённые задачи в planning/tasks.json валидируются и проходят review. Добавление задач не разрешает автоматически менять spec snapshots. Новая редакция требований — отдельное решение с сохранением старой версии и traceability.

Никогда не проставлять done для задачи только потому, что создана её карточка или scaffold. Исходный план содержит будущую работу, а не отчёт о реализованном приложении.

Обязательное правило блокера и автоматизации

Для всех ролей scope — только текущая task card. Blocker требует отдельную атомарную remediation через scripts/tasks.py escalate: original blocked, reporter retired, текущий запуск немедленно окончен. Не решать remediation и не запускать новую модель из текущего агента. scripts/runner.py запускает новый процесс и новый master prompt; после reviewed done исправления original автоматически возвращается в очередь нового исполнителя/reviewer. Bare block/unblock и повторный claim retired id запрещены. После submit/approve/reject тоже закончить запуск. См. docs/AUTOMATION.md.