Files
dotfiles/.scratch/handoffs/20260721-0343-xray-proxy-after-04.md
T
ddadminandClaude Fable 5 1e7b9d3f3d docs(xray-proxy): обновлён handoff конвейера после задачи 04
- Зачем:
  - следующая сессия должна стартовать задачу 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>
2026-07-21 03:43:37 -04:00

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 обновить этот документ (удалить, создать новый по той же схеме).