TextMachine — контекст для Claude-сессий

Go-бэкенд издательского художественного перевода крупных текстов (ранобэ/вебновеллы, zh/ja/en→ru) через мультиагентный LLM-пайплайн: черновик (интерим DeepSeek; переводчик выбирает exp13) → БИЛИНГВАЛЬНЫЙ редактор (D30.1; кандидат glm-5) → судья Gemini (Ф2). Цели: победить translationese; низкий COGS (~$0.85/ранобэ после флипа D1 — D30.4); детерминированный банк памяти книги; 18+ с учётом цензуры; телеметрия денег с первого дня.

Роли сессий и зоны (НЕ править чужую зону)

Роль	Зона записи	Всё остальное
Бэкенд	`backend/`	читать можно; расхождения — пингом оркестратору в `docs/PROGRESS.md`
Полигон (eval)	`eval/` + `docs/experiments/`	то же
Оркестратор	`docs/` (architecture/research/PROGRESS), ревью чужого кода read-only	ратифицирует решения, пишет хендофф-промты

Координация — журнал docs/PROGRESS.md (секции «Бэкенд»/«Полигон»/«Память»/«Голос и состояние»/«Ридер-IDE»; сверху CURRENT-STATE). Записывай туда краткие итоги своей сессии. Закрытая хроника 04–10.07 вынесена в docs/archive/PROGRESS-2026-07-04-10.md (D31) — НЕ читать при онбординге, только по конкретной ссылке.

Источники истины (по убыванию)

docs/architecture/05-decisions-log.md (D1–D39.11) — ратифицированный контракт; при конфликте с любым другим доком побеждает он; сверху файла — карта актуальности (что чем superseded).
docs/architecture/07-strategic-review.md — стратегический аудит 09.07 (вердикт, риски, курс-коррекции).
docs/experiments/00-provider-quirks.md — wire-квирки провайдеров (читать ПЕРЕД правкой адаптеров/вызовами провайдеров).
docs/architecture/01-decisions.md (Р1–Р10), 02-mvp-plan.md (фазы v3), 04-unhappy-paths.md, 06-memory-risk-registry.md.
docs/research/* — фактура; часть под ⚠ superseded-баннерами — читай баннер прежде содержимого.
docs/archive/ — закрытые промты, только история.

Гардрейлы (жёсткие)

НИКОГДА не читать .env (backend/.env, eval/.env) — там ключи. .env.example можно.
18+ уровень 3 (несовершеннолетние в сексуальном контексте) — не обрабатывать/не анализировать; eval/data/refusal_corpus/* не открывать без прямой задачи владельца.
PUML не рендерить в svg/png — владелец смотрит PlantUML-расширением VS Code.
Коммиты: английский, одно предложение ≤30 слов, без Co-Authored-By. .claude/settings.local.json НЕ коммитить (ломает пермишены).
Провайдерские ловушки: DeepSeek — НИКОГДА не отключать thinking (эхо-мина; гейт echoMineViolation это принуждает); grok-4.3 reasoning off — только ЯВНЫЙ reasoning_effort:"none" (дефолт low; wire-квирк в силе, но из РЕДАКТОРСКИХ ролей reasoning-off снят — no-op, D30.1); слаги моделей не менять без live-фактчека /models. Пробы/запросы падают или ведут себя странно (флейки, 404 живой модели, новый finish_reason, игнор параметров) → идём в официальную доку вендора (deprecations/changelog/status) и гуглим, НЕ гадаем — интерпретацию аномалии без вендор-сверки в доки/промты не абсорбировать (решение владельца 10.07; правило двух направлений — 00-provider-quirks.md шапка).
Дисциплина: не верь заголовкам — грунтуй выводы file:line/цитатой; спорное верифицируй адверсариально (author≠reviewer); эмпирика на PD-классике из претрейна считается предварительной до вебновелл-среза.
Общность движка (владелец 24.07): Go-логика НЕ ветвится по паре/книге; пара-данные → internal/lang+configs/langpacks/, книго-каноны → сид/brief (данные); книжный термин в общем пар-слое = утечка. Тест-данные пары легитимны. Норматив (только больные места): docs/architecture/12-go-style-notes.md. Ревью-вопрос по умолчанию: «заработает ли на паре, которой в репо ещё НЕТ, без правки Go?»
Мандат самопроверки в промтах сессий (обязателен, решение владельца 12.07): промты полигон-сессий — и вообще любых пишущих код / запросы к моделям — ДОЛЖНЫ явно требовать ревью ИСПОЛНЕНИЕМ: своего кода + сформированных запросов к моделям + полученных результатов. Полигон регулярно ошибается/багует, и это искажает эксперименты (D37: заявленные «0 ошибок» = 36 ошибок+биллинг, «13 катастроф» = ~5–6 при оверфлаге судьи; exp13 +10% бюджета). Бэкенд-промты — явный бэкенд-ревью после кода (обычно отрабатывает по опыту, но требовать явно). Пост-хок адверсариальная верификация оркестратора при лендинге — второй рубеж, НЕ замена самопроверки.
Git-координация мультисессий: НИКАКИХ reset --hard, перезаписей истории (amend/rebase несвежих коммитов) и checkout поверх грязного дерева, пока возможны незакоммиченные правки параллельных сессий — сначала git status и опознание ЧУЖИХ изменений; чужое не трогать; history-rewrite — только по согласованию через оркестратора при чистом дереве (урок 09.07: rewrite оркестратора стёр незакоммиченные правки полигона).

Онбординг новой сессии (порядок чтения)

Этот файл → docs/README.md (карта) → CURRENT-STATE в docs/PROGRESS.md.
docs/architecture/05-decisions-log.md целиком (контракт).
По роли: Бэкенд — backend/README.md + 03-implementation-notes.md; Полигон — eval/README.md + experiments/00 + 09-pilot-protocol.md; всем — 07-strategic-review.md §6–9 (вердикт/риски/курс).

Текущее состояние (2026-07-25, пост-пак-15 — эра «механизация выпускного качества»)

Фаза 0 ✅; Ф1-инфра ✅ (D20–D28; golden = инвариант детерминизма, №8 README = экспорт-контракт). Арка «качество-первым» D26→D38.5 ЗАКРЫТА; АРХ-РЕСЕТ D39 ИСПОЛНЕН ЦЕЛИКОМ: 7-слойная архитектура (09-*) → исследовательская программа (D39.1–D39.10) → план (D39.12) → стройка пака-11 завершена (D39.13–D39.19: волновой исполнитель + чанкер output-бюджет + src→dst-редактор + Go-майнер паритет-EXACT + банкнота + internal/lang+langpacks + reject-set + echo-сплит; хроника — D-лог). ПЕРЕ-ПРОГОН rerun2 ИСПОЛНЕН И ПРОЧИТАН (D39.20, 23.07, books/gu-zhenren/rerun2/): вся операционка подтверждена живьём — ОДИН resnapshot, $0-резюм драфта на всех 3 армах, echo 0, $6.63<$15; майнинг-стоп→подпись→reject-set отработали. Вердикт качества: планка ≤2 претензии НЕ пройдена (пилот не открыт); три независимых сигнала (судья dspro 0.679>glm 0.589>>mistral 0.232 при floor-шуме 0 · два слепых чтения) → анти-корреляция гладкость↔верность доказана трижды (чисто-художественные выборы обоих читателей идентичны = mistral 4/5 — арм с критическими смысловыми); mistral исключён как несущий редактор (голос = north-star промпта), dspro-vs-glm решает итерация №2 после механизации (драфт $0 → $0.08/арм + судья-lite). Эксп ЗАКРЫТ решением владельца (D39.22), итерация №2 отложена (её вопросы — довесок следующего платного прогона); редактор = deepseek-v4-pro ИНТЕРИМ (судья №1 · проза/глоссарий · дефекты чинибельны · ×2 дешевле; glm-5 резерв, отмена = один арм-конфиг); стайл-решения D39.21: меры → единицы читателя (时辰=2ч) · generic-«гу» средний род, именные по-термово · стихи смыслом · 资质=«талант». research/21: транспорт наш опережает/вровень, рефакторинг ОТВЕРГНУТ. Курс — разработка бэкенда: паки 12/13/14 ЗАЛЕНДЕНЫ 24.07 (транспорт-гигиена 7fe0a5b · выпускной QA 2f91b04 · генеральность-пасс: пара/книга-данные → langpack+internal/lang/data embedded, книго-overlay langpack_extend (古月 вон из общего zh-пака), пар-агностичный checkers.go, generic-Палладий; приёмка воркфлоу 11+4 линз, байт-сверка против HEAD, отчёт с ревью-шапкой в docs/archive/reports/) → пак-15 ЗАЛЕНДЁН 25.07 (движок разложен: internal/{text,seed,chunk,miner,checks,membank} + композит-корень pipeline, латеральных импортов 0; конфиг-слой пары configs/pairs/ + промпт-конвенция prompts/<пара>/<роль>.md; строгий KnownFields-декод pipeline-конфигов; golden пере-снят байт-в-байт, парити EXACT) → пак-16 (канал B вживую / слой-3 diff-редактор — прецедент AiNiee/LinguaGacha; в первое касание: строгий декод book.yaml [санкционирован] + pair/models-слои) → сид-дельта (元-корень · 赤城 · 学堂家老 · 春秋蝉) → канал B (18+) вживую · слой-3 diff-редактор (прецедент AiNiee/LinguaGacha, research/22) · Ф2-механизмы (голос/состояние D21 · native-Gemini судья) · ja→ru §B5 → пилот Ф2.5. Стек: draft flash thinking-ON → editor deepseek-v4-pro → судья gemini-preview + grok-фолбэк на 18+ ($0.85/ранобэ D30.4). Висит на владельце: мини-каноны сид-дельты (元-корень · 春秋蝉) · ja→ru-реплика (§B5) · старые (пилот Ф2.5: билингв-якорь D25.9-Q1, корпус, судья-дублёр D22.6). Ключ xAI: единый, data-sharing, off перед продом (D27). Книга на стенде /home/ubuntu/books/gu-zhenren/ (GB18030; текст и производные ВНЕ git). Ключи: DEEPSEEK, ZAI, KIMI, OPENAI, GEMINI, XAI, MISTRAL. Стенд: WSL2, GTX 1070 8GB (localhost из-под прокси = 403 — no-proxy транспорт для local).

13 KiB Raw Blame History Unescape Escape