- Зачем:
- следующая сессия должна стартовать задачу 05 без восстановления
контекста из транскриптов.
- Что:
- создан handoff после 04: состояние конвейера, решения по эффорту от
2026-07-21, план задачи 05 с ручными приёмками, грабли механики;
- удалён отработанный handoff после 03.
- Проверка:
- cat .scratch/handoffs/20260721-0343-xray-proxy-after-04.md.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
5.3 KiB
Handoff: headless-xray-proxy — после задачи 04, перед 05
Дата: 2026-07-21. Одноразовый документ (правило AGENTS.md): следующая сессия читает, продолжает, по завершении вехи удаляет и пишет новый.
Состояние конвейера
- Порядок прогона: 06 (done, baseline high) → 03 (done) → 04 (done) → следующая — 05.
- 04 закрыта полным конвейером и закоммичена:
0432c4a feat(xray-proxy): добавлена проверяемая установка Xray командой install. Резолюция и детали — в.scratch/headless-xray-proxy/issues/04-verified-xray-installation.md(Status: done). Тесты после 04: 79 OK + 8 PASS (PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s tests,bash tests/test_proxy_launchers.sh). - Эксперимент «реализация на medium» завершён и зафиксирован (см. ниже);
затраты по этапам —
.scratch/headless-xray-proxy/token-ledger.md(итоги 03/04, сводка 06/03/04, наблюдения).
Решения пользователя 2026-07-21 (обязательны для 05)
Зафиксированы в ~/.claude/skills/claude-subagent-playbook/
(SKILL.md — эффорт-карта Claude-субагентов; references/codex-exec.md —
уточнение к правилу эффорта 2026-07-19; references/lessons.md — эмпирика
прогонов 03/04) и в памяти codex-effort-calibration.md. Кратко:
- Codex: реализация по отревьюированному тикету → medium допустима; экономию эффорта считать по конвейеру целиком.
- Claude-субагентам effort задавать ЯВНО при спавне: xhigh — ревью постановок/планов; high — слепое TASK-ревью (ниже не опускать); medium/default — узкие перепроверки. Внутри одного агента effort между резюмами не менять.
- Высокий effort не страхует от выдумки внешних фактов (казус
.dgstв 04) — форматы артефактов/версии проверять первоисточником или фикстурой.
Следующий шаг: задача 05
.scratch/headless-xray-proxy/issues/05-package-delivery-and-acceptance.md
— доставка пакета и приёмка. Особенность: включает РУЧНЫЕ приёмочные
прогоны пользователя на Ubuntu / РЕД ОС / Astra / Alt (по доступности) —
планируй конвейер с точками ожидания пользователя. Старт — по команде
пользователя («поехали по 5»): постановка → Codex spec-review (high) →
переписывание тикета оркестратором → реализация (medium, если типовая) →
саморевью (resume, medium) → два слепых ревью (Opus TASK high + Codex
CODE high свежим тредом) → триаж (resume) → узкие перепроверки (medium) →
приёмка → conventional commit (русский, Зачем/Что/Проверка).
Механика и грабли (проверено в 03/04)
- Codex-вызовы, шаблоны промптов, правила resume — playbook
references/codex-exec.md. Критично:
codex exec resume <id>принимает ТОЛЬКО-c-оверрайды; thread_id забирать из первой строки stdout-JSONL сразу после старта; usage убитого хода теряется (нетturn.completed). - Смена
model_reasoning_effortпри resume кэш Codex-треда не сбрасывает. - Леджер: Codex —
grep '"usage"' stdout*.jsonl(последняя строка хода), Claude-субагенты —subagent_tokensиз task-notification; сравнивать по «свежий input + output». - Scratch прогонов 03/04:
/tmp/xray-lifecycle-OZHc,/tmp/xray-04-H156(архив, для 05 создать свой каталог). - Секреты: реальные VLESS/UUID/ключи — никогда в репо/выводы; чужие
untracked-артефакты (
zed/.config/*,agents/.agents/skills/*,scripts/setup-xray-proxy.sh) не трогать и не коммитить; git add — только адресно или-u.
Suggested skills
codex-subagent-playbook— оптика делегирования; конвейер и механика Codex — в~/.claude/skills/claude-subagent-playbook/(SKILL.md + references), читать перед стартом 05.conventional-commits— для коммитов (русский, совершенный вид, Зачем/Что/Проверка).handoff— по завершении 05 обновить этот документ (удалить, создать новый по той же схеме).