textmachine/docs
2026-08-02 03:43:51 +03:00
..
architecture Ratify D39.85: industry-standard engine-platform seam recorded in research 23, event stream plus materialization plus artifacts, anti-patterns banned, emitter row opened 2026-08-02 03:38:35 +03:00
archive Land smallpack tails as D39.82: eight checker review tails, bucket D cleanup, quality tails, tmctl backup with production preflight, register moved to book layer, DC7 regated on seed coverage 2026-08-02 01:50:20 +03:00
experiments Rework CLAUDE.md into a stable project map with lessons only, re-sync backend and eval READMEs to code facts, relocate stand and adult-content notes to zone docs 2026-08-01 03:44:25 +03:00
research Ratify D39.85: industry-standard engine-platform seam recorded in research 23, event stream plus materialization plus artifacts, anti-patterns banned, emitter row opened 2026-08-02 03:38:35 +03:00
BACKEND_COLDRUN_DEBUG_SESSION_PROMPT.md Ratify D39.83: flash reprobe and debug cold run sanctioned with ceilings, three-phase control prompt issued and cold-audited with three majors fixed before handoff 2026-08-02 02:33:04 +03:00
glossary.md Ratify D39.84: frontend and platform stacks pinned, eight owner decisions recorded, zone backlogs split out, four engine work rows opened, translation never indexable 2026-08-02 03:04:23 +03:00
ORCHESTRATOR_SESSION_PROMPT.md Close orchestrator nine handoff: role counter to ten, uncommitted coldrun report flagged in current state as successor acceptance task 2026-08-02 03:43:51 +03:00
POLYGON_PACKAGE4_SESSION_PROMPT.md Record completeness sweep as D39.66: pack-21 basket II recovered into checker package row, seven new backlog rows, carrier amendments and explicit closures 2026-08-01 04:27:27 +03:00
product-requirements.md Ratify D39.84: frontend and platform stacks pinned, eight owner decisions recorded, zone backlogs split out, four engine work rows opened, translation never indexable 2026-08-02 03:04:23 +03:00
PROGRESS.md Close orchestrator nine handoff: role counter to ten, uncommitted coldrun report flagged in current state as successor acceptance task 2026-08-02 03:43:51 +03:00
README.md Ratify D39.85: industry-standard engine-platform seam recorded in research 23, event stream plus materialization plus artifacts, anti-patterns banned, emitter row opened 2026-08-02 03:38:35 +03:00

TextMachine — документация

Проект: издательский художественный перевод крупных текстов (книги, ранобэ, вебновеллы; zh/ja/en→ru) мультиагентным пайплайном поверх LLM API. Go-бэкенд + веб-фронт ридер-IDE (Ф3). Цели и мерило — канон в ../CLAUDE.md; онбординг сессий — там же. Стартовый бриф владельца: ../START_PROMT.MDживой документ, его V-идеи разобраны в реестр требований (ниже).

Состояние проекта НЕ здесь. Очередь, курс, бэклог — CURRENT-STATE в шапке PROGRESS.md; решения — architecture/05-decisions-log.md (при конфликте с любым доком побеждает он). Эта страница — только карта «что где лежит».

Карта

  • glossary.md — жаргон и сокращения (D-номер, паки, банк, голден, K/DC/H/L…) одним экраном.
  • product-requirements.md — реестр «что продукт обязан уметь»: START_PROMT V0V5 + находки H6H18, статусы сверены кодом.
  • architecture/ — синтез и контракты:
  • experiments/ — эмпирика полигона: 00-provider-quirks.mdчитать перед любым вызовом провайдера; 08-cost-model-v2.md — денежная модель; 09-pilot-protocol.md — пилот Ф2.5; остальные 0116 — отчёты закрытых экспериментов (судьба — в баннерах/D-логе).
  • research/ — фактура ресёрчей 0122; у принятых — ревью-шапки, часть тел под ⚠ superseded: читай баннер прежде содержимого. Ключевые для навигации: 15 голос · 16 ридер-IDE · 17 внешняя критика · 18 рычаги качества · 19 нарезка · 20 банк-майнинг · 21 обзор транспорта · 22 доменные харнессы · 23 шов движок↔платформа (читать перед любым кодом стыка).
  • PROGRESS.md — журнал: CURRENT-STATE + ЕДИНЫЙ БЭКЛОГ (единственный трекер) + живой хвост хроники. НЕ источник решений.
  • Активные хендофф-промты сессий (состав обновляется при каждом лендинге — норма D39.80): ORCHESTRATOR_SESSION_PROMPT.md (роль/нормы; состояния не дублирует) · POLYGON_PACKAGE4_SESSION_PROMPT.md (полигон, отложен). · BACKEND_COLDRUN_DEBUG_SESSION_PROMPT.md (текущий бэкендный: ре-проба flash + отладочный холодный прогон coldrun-b). Фронт-промт — в чужой зоне frontend/docs/.
  • Зоны фронта (чужие, читать при касании стыка; каждая ведёт СВОЙ зонный бэклог — единый бэклог их строк не принимает, D39.84): ../frontend/ — веб-интерфейс: промт фронт-сессий S0S7 + STACK_DECISIONS.md (пины версий точными числами и ловушки, сверены с вебом 02.08) + BACKLOG.md · ../platform/ — SaaS control plane: README-заглушка + BACKLOG.md.
  • archive/ — история (правила архива): закрытые промты (prompts/) · отчёты с ревью-шапками (reports/ — на них ссылаются приёмки) · исполненные арх-доки (architecture/) · слайсы хроники PROGRESS-*.md. Инструкции оттуда не исполнять.
  • Диаграммы: ../backend/docs/components.puml · ../backend/docs/pipeline.puml — дом рядом с кодом (D39.80), правятся бэкендом одним коммитом с кодом; вручную НЕ рендерить (владелец смотрит PlantUML-расширением VS Code).

Доступные ключи от моделей

DEEPSEEK_API_KEY, ZAI_API_KEY, KIMI_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, XAI_API_KEY, MISTRAL_API_KEY