P1
Контур производства единицы
Unit production loop
Каждая глава и каждое приложение проходят один и тот же замкнутый контур. Дальше идёт только то, что прошло гейт.
Every chapter and appendix goes through the same closed loop. Only what passes the gate moves on.
→∥→→→→↺
C1 · C2 ×14 · D · E · F · 06 · §47, §74
Настраивается: какие проверки идут параллельно, критерии CRITICAL / QUALITY / MINOR, условие PASS (ни одного CRITICAL).
Configure: which reviews run in parallel, CRITICAL / QUALITY / MINOR criteria, the PASS rule (no CRITICAL left).
P2
Волна проверок по участкам
Sharded review wave
Книга режется на участки; на каждый участок — отдельный рецензент с узким вопросом. Оркестратор сводит отчёты, правки вносятся до следующей волны. Порядок волн: математика → источники → терминология → подача → связность → перед сборкой.
The book is cut into zones; each zone gets its own reviewer with a narrow question. The orchestrator merges the reports and fixes land before the next wave. Wave order: mathematics → sources → terminology → presentation → continuity → pre-build.
→×N→→
E ∥4 · F·01 ∥5 · 02 ∥3 · 03 ∥2 · 04 ∥3 · 05 ∥6 · 06 ∥3 · §79–87
Настраивается: границы участков (с зонами перекрытия для сравнения мнений), вопрос каждой волны, число рецензентов.
Configure: zone boundaries (with overlap zones to compare verdicts), the question of each wave, the number of reviewers.
P3
Решение → правка → регрессия
Adjudicate → fix → regression
Замечания не правятся сразу. Оркестратор сначала записывает решение по каждому (принять, отклонить, переоценить), затем правит канонические исходники, затем свежий рецензент проверяет только diff этих правок. Нашёл CRITICAL — ещё круг.
Findings are not patched on sight. The orchestrator first records a decision on each one (accept, reject, re-grade), then edits the canonical sources, then a fresh reviewer checks only the diff of those edits. A CRITICAL means another round.
→→↺ CRITICAL
QA-111 → 112 · QA-119 → 124 · QA-134 → 137 · QA-140 → 142 · §76
Настраивается: где хранить решения (reviews/QA-NNN_adjudication.md), граница diff для регрессии.
Configure: where decisions live (reviews/QA-NNN_adjudication.md), the diff boundary for regression.
P4
Человек решает спорное
Human in the loop for disputed calls
Агент не выбирает спорный термин сам. Он ставит маркер [[термин?:TP-NN]], готовит вопрос (варианты с источниками и рекомендацию) и продолжает работу. Пользователь решает, решение заносится в реестр, применяется и проверяется. Сборка не пройдёт, пока в тексте остался маркер.
The agent never picks a disputed term on its own. It leaves a [[термин?:TP-NN]] marker, prepares a question (sourced variants plus a recommendation) and keeps working. The user decides; the decision is registered, applied and checked. The build refuses to run while a marker remains.
→→→
B · F · TP-24…28 · F · TP-29…32 · TERMINOLOGY_POLICY.md
Настраивается: что считается спорным, формат вопроса, где реестр решений.
Configure: what counts as disputed, the question format, where the decision register lives.
P5
Память и возобновление между сессиями
Memory and resumption across sessions
Проект прошёл за 20 сессий (run). Каждая начинается со сверки STATE.md с репозиторием. Перед запуском рецензентов делается «барьерный» коммит — общая база для проверки. Рецензенты пишут промежуточные чекпойнты; отчёт без строки «END OF REPORT» считается пустым и перезапускается.
The project ran over 20 sessions (runs). Each starts by reconciling STATE.md with the repository. Before reviewers launch, a “barrier” commit fixes the common review base. Reviewers write interim checkpoints; a report without “END OF REPORT” counts as no result and is rerun.
→→∥→→
B · COURSE_READER/_BUILD/ · §15–16
Настраивается: набор файлов состояния, правило «что считать завершённым отчётом», частота чекпойнтов.
Configure: the set of state files, the “finished report” rule, checkpoint frequency.
P6
Однонаправленная воспроизводимая сборка
One-way reproducible build
Править можно только канонические модульные исходники. FULL_READER.md и PDF — производные: их никогда не правят руками, а пересобирают. Проверки после сборки сверяют оглавление, якоря, рисунки и то, что PDF собран из текущего Markdown (sha256); повторная сборка даёт тот же результат.
Only the canonical modular sources are edited. FULL_READER.md and the PDF are derived: never hand-patched, always rebuilt. Post-build checks verify the TOC, anchors, figures and that the PDF was built from the current Markdown (sha256); a rebuild gives the same result.
→build.py→FULL_READER.md→build_pdf.mjs→postbuild_check.py↺
G · §7, §9, §104–105
Настраивается: единственный манифест порядка (BOOK_STRUCTURE.md), список проверок после сборки, закреплённые версии зависимостей.
Configure: the single order manifest (BOOK_STRUCTURE.md), the post-build check list, pinned dependency versions.
P7
Гейты по доказательствам
Evidence-based gates
Статус ставится только PASS, REVISE или BLOCKED и только при наличии доказательств. Проблема возвращает работу на тот этап, где она возникла. Таблица глав в STATE.md машиночитаема: build.py --final откажется собирать книгу, если хоть одна глава не PASS.
A status is only PASS, REVISE or BLOCKED, and only with evidence. A problem sends the work back to the stage where it arose. The chapter table in STATE.md is machine-readable: build.py --final refuses to build if any chapter is not PASS.
→PASS · REVISE · BLOCKED→STATE.md→build.py --final
· §2, §19–20
Настраивается: какие доказательства нужны для каждого гейта (контракты фаз, §20).
Configure: which evidence each gate needs (phase contracts, §20).
ОркестраторГлавный агент. Сверяет состояние, запускает рецензентов, сводит отчёты, записывает решения, вносит правки, ставит гейты. Сильнейшее рассуждение — сюда и на математику (§13).
АвторТот же главный агент: проектирует книгу и пишет главы и приложения по блюпринтам.
РецензентыОтдельные агенты со свежим контекстом, только чтение: математика и источники, язык и подача, терминология, связность, сборка и целостность, полнота (§100), зависимости (§101), регрессия правок. Каждый пишет отчёт в reviews/.
ПользовательРешает спорные термины и правила оформления (TP-01…TP-32, PRE-01…PRE-04).
Скриптыvalidate_workspace.py, build.py, build_pdf.mjs, postbuild_check.py, скрипты проверки примеров в главах.
OrchestratorThe main agent. Reconciles state, launches reviewers, merges reports, records decisions, applies fixes, sets gates. The strongest reasoning goes here and to the mathematics (§13).
AuthorThe same main agent: designs the book and writes chapters and appendices from blueprints.
ReviewersSeparate agents with a fresh context, read-only: mathematics and sources, language and presentation, terminology, continuity, build and integrity, completeness (§100), dependencies (§101), regression of fixes. Each writes a report to reviews/.
UserDecides disputed terms and presentation rules (TP-01…TP-32, PRE-01…PRE-04).
Scriptsvalidate_workspace.py, build.py, build_pdf.mjs, postbuild_check.py, per-chapter example-check scripts.
STATE.mdГде мы, что сделано, что дальше; таблицы гейтов. Новая сессия продолжает только по нему.
BOOK_STRUCTURE.mdЕдинственный источник порядка книги для сборки.
COVERAGE_MATRIX.mdКаждый пункт дорожной карты и его место в книге.
CHAPTER_BLUEPRINTS.mdПлан главы до написания.
SOURCE_LEDGER.mdВажные утверждения и вопросы к источникам.
TERMINOLOGY_LEDGER.mdРешения по терминам и реестр решений пользователя.
QA_LOG.mdКаждое замечание: кто нашёл, тяжесть, решение, статус.
DECISIONS.mdРешения по архитектуре и методу, включая отмены.
reviews/Отчёты рецензентов (до «END OF REPORT») и файлы решений.
STATE.mdWhere we are, what is done, what comes next; gate tables. A new session resumes from it alone.
BOOK_STRUCTURE.mdThe single authority on book order for the build.
COVERAGE_MATRIX.mdEvery roadmap item and where it lands in the book.
CHAPTER_BLUEPRINTS.mdA chapter plan before drafting.
SOURCE_LEDGER.mdKey claims and open questions about sources.
TERMINOLOGY_LEDGER.mdTerminology decisions and the register of user decisions.
QA_LOG.mdEvery finding: who found it, severity, resolution, status.
DECISIONS.mdArchitecture and method decisions, including reversals.
reviews/Reviewer reports (up to “END OF REPORT”) and adjudication files.