diff --git a/docs/ORCHESTRATOR_SESSION_PROMPT.md b/docs/ORCHESTRATOR_SESSION_PROMPT.md index 463dde1e..174af991 100644 --- a/docs/ORCHESTRATOR_SESSION_PROMPT.md +++ b/docs/ORCHESTRATOR_SESSION_PROMPT.md @@ -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: две завышенные тест-заявки подряд) — в каждый кодинг-промт.