# Инструкции агенту 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.

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

`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.