Add anti-desync handoff prompt norms to the orchestrator handoff: self-contained decisions, marked freedom, implementation advice, addendum echo confirmation

This commit is contained in:
Claude (backend session) 2026-07-25 01:22:16 +03:00
parent e241b9572c
commit 5f7ee834d1

View file

@ -66,3 +66,14 @@
- `/tmp` волатилен (скрипты воркфлоу переписывай при рестарте); артефакты — на диск стенда; книга и производные — ВНЕ git; `.env` не читать; PUML не рендерить; `.claude/settings.local.json` не коммитить.
- Промт-архивация: только отработанные, с баннером-исходом; residual-трекеры (POLYGON_PACKAGE4) держать активными.
- Эскалации сессий: настоящие развилки эскалируй быстро и решай сам (образцы эры №6: B-hybrid Q4a, вариант-2 расширения, оракул-поправка) — сессии приносят развилки вместо тихих девиаций, это норма, поощряй.
## Нормы хендофф-промтов (анти-рассинк; владелец 25.07: «lack of sync оркестратор↔бэкенд↔полигон порождает недопонимание и миссимплементацию»)
Промт — ЕДИНСТВЕННЫЙ контекст сессии: она не видит твоих разговоров, чужих отчётов и решений, принятых после её старта. Отсюда шесть правил:
1. **Самодостаточность несущей части.** Ратифицированные решения (алгоритм, дизайн, формат, инвариант) — В ТЕЛЕ промта с file:line-якорями, не «см. док». Карта чтения ≤5 позиций и только для глубины/подтверждения; если сессии придётся пере-выводить решение из доков — промт написан плохо.
2. **Явная разметка свободы.** Каждый пункт — либо «делай РОВНО так» (решение принято; отступление = пинг, не тихая девиация), либо «реши сам и аргументируй в отчёте». Неразмеченная середина — главный источник миссимплементации.
3. **Имплементационные советы давать**, когда они есть: алгоритм, структура данных, подводный камень, wire-квирк, порядок этапов. Сессия не обязана пере-открывать известное; тактический (кодинг/конфиг) промт несёт квирки, стратегический — направление (не смешивать).
4. **Mid-flight аддендумы доезжают ТОЛЬКО релеем** — бегущая сессия файл промта не перечитывает. Требуй эхо-подтверждение получения + отдельный пункт в отчёте; при приёмке проверяй каждый аддендум явной строкой (так пойман потерянный parsePalladius-аддендум пака-14).
5. **Канал вопросов в каждый промт:** «непонятно / конфликт промта с кодом или доками → пинг оркестратору через владельца, НЕ интерпретация».
6. **Мандат самопроверки исполнением** (CLAUDE.md, 12.07) + «дифф `^func Test` исполнением, не памятью» (урок паков 14/15: две завышенные тест-заявки подряд) — в каждый кодинг-промт.