Маршрут одной книги

Сверху вниз — последовательность: блок начинается, когда готов предыдущий.

Шапка с пометкой «5 агентов-рецензентов одновременно» — работа делится на 5 независимых сессий, каждая со своим куском книги; блок с толстой верхней границей сводит их результаты.

Ромб — контрольная точка: «ДА» ведёт дальше, «НЕТ» возвращает по оранжевому пунктиру на исправление, после которого снова идёт проверка.

Строка над названием — кто выполняет шаг. Строка внизу — след в проекте: номер проверки из QA_LOG.md, файл или сессия (run).

Оркестратор и автор — главный агент в двух ролях. Рецензенты — отдельные агенты со свежим контекстом, только чтение.

Наведите курсор на блок или нажмите на него, чтобы подсветить его связи.

Top to bottom is sequence: a block starts once the one before it is done.

A header marked “5 reviewer agents at once” splits work into 5 independent sessions, each with its own part of the book; a block with a thick top edge merges their results.

A diamond is a gate: PASS leads on, FAIL returns along the orange dashed line to a fix, followed by another check.

The line above a title says who performs the step. The bottom line is its trace in the project: a check number from QA_LOG.md, a file or a session (run).

Orchestrator and author are one main agent in two roles. Reviewers are separate agents with a fresh context and read-only access.

Hover over a block or tap it to highlight its connections.

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.