RomaGrach/prepare-web-handoff

Prepare Web Handoff

Ставь экономию локальных токенов и времени выше локальной инженерной работы. Не решай передаваемую веб-агенту задачу, не проектируй архитектуру и не исправляй код проекта. Выполняй только короткие фактические проверки, упаковку, безопасную интеграцию и проверку результата.

Выбери режим

• outbound: сними подтверждённое состояние и создай пакет для веб-агента.
• inbound: безопасно распакуй, сравни и при явном разрешении интегрируй возвращённый архив.
• iteration: после неуспешной проверки собери минимальный повторный пакет с ошибкой, логом, текущим diff и нужными файлами.

Общие правила

1. Сначала читай пользовательское задание, AGENTS.md, README/assignment, манифесты, lock-файлы, конфигурацию, Git status/diff, недавние логи и уже существующие результаты тестов.
2. Отделяй подтверждённые факты, предположения и непроверенные пункты.
3. Не используй браузер, Computer Use или GUI без прямой просьбы либо доказанной блокировки.
4. Не задавай вопросы, которые веб-агент сможет разрешить по приложенным данным.
5. Не запускай долгие сборки. Выполняй только короткие релевантные проверки, обязательные для качественной передачи или безопасной интеграции.
6. Не сбрасывай Git, не удаляй пользовательские изменения и не применяй разрушительные команды.
7. Никогда не включай секреты. Передавай только имена нужных переменных или обезличенный шаблон без значений.

Outbound

1. Быстро установи корень проекта и фактическое состояние.
2. Не исправляй проект. Сформулируй веб-агенту самодостаточную задачу с целью, требованиями пользователя, воспроизведением, ограничениями, ожидаемыми изменениями и проверками.
3. Запусти:

python "<skill>/scripts/build_handoff.py" <project-root> \
  --output-dir <output-dir> \
  --mode outbound \
  --task-file <task.md>

4. При необходимости добавь --include, --exclude, --state-note, --constraint, --expected-change, --check-command и --unverified.
5. Убедись, что каждая ZIP-часть меньше 10 000 000 байт, частей не больше 20, CRC проверен, а первая часть содержит пять контрактных документов.
6. Если проект не помещается, не называй пакет полным. Кратко перечисли критичные исключения и файлы, которые могут потребоваться отдельно.

Inbound

1. Не распаковывай архив поверх проекта.
2. Сначала построй staging и план без применения:

python "<skill>/scripts/integrate_return.py" <returned.zip> \
  --project-root <project-root>

3. Проверь WEB_AGENT_RESULT.md, INTEGRATION_PLAN.md и INTEGRATION_DIFF.patch в staging.
4. Применяй только после явного решения пользователя или однозначного поручения интегрировать:

python "<skill>/scripts/integrate_return.py" <returned.zip> \
  --project-root <project-root> \
  --apply

5. Сохраняй относительные пути. Перед перезаписью создавай резервную копию конфликтующих файлов.
6. Запусти только доступные короткие проверки. Сообщай фактический результат; не заявляй об успешных тестах, если они не запускались.
7. При ошибке не отлаживай проект локально. Переходи в iteration.

Iteration

1. Зафиксируй точную команду проверки, полный текст ошибки, релевантный лог и текущий diff.
2. Включи только файлы, необходимые веб-агенту для исправления, плюс изменённые пользовательские файлы, которые нельзя потерять.
3. Запусти build_handoff.py с --mode iteration, --error-file или --error-text, --log-file, --check-command и узкими --include.
4. Не пытайся исправлять код локально.

Формат короткого ответа

После outbound отвечай:

Пакет для сайта: <абсолютный путь или список частей>
Части: N, каждая меньше 10 МБ
Включено: <кратко>
Не включено: <кратко или «ничего критичного»>
Скопируйте сайту этот текст: <короткий запускной промпт>

После inbound отвечай:

Результат интегрирован: <путь проекта>
Проверки: <фактический итог>
Если есть ошибка: новый пакет для сайта — <путь>

Не публикуй длинный локальный анализ, если пользователь отдельно его не запросил.