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