From f19153556a5ac6a8f8c8ba70f3244f65c7097330 Mon Sep 17 00:00:00 2001 From: heaven Date: Tue, 1 Sep 2026 23:34:03 +0300 Subject: [PATCH] Correct three acceptance criteria that named findings from other batches, move the README fix into the batch that executes it, and split the unaudited corners three ways --- docs/DOC_CLEANUP_PLAN.md | 54 ++++++++++++++++++++++++++++++++++------ 1 file changed, 46 insertions(+), 8 deletions(-) diff --git a/docs/DOC_CLEANUP_PLAN.md b/docs/DOC_CLEANUP_PLAN.md index f8b0be99..3c1cfe73 100644 --- a/docs/DOC_CLEANUP_PLAN.md +++ b/docs/DOC_CLEANUP_PLAN.md @@ -81,14 +81,14 @@ |---|---|---|---|---| | **Б0** | СКВОЗНОЙ: «канон 0.9.0» одним касанием — требование контролёра 2.2 | 7 | 0/6/1 | ⬜ | | **Б1** | Блокеры бэклога + строка 240: ОДНА нота на четыре строки | 4 | 3/1/0 | ⬜ | -| **Б2** | Переезд ОТРАБОТАВШЕГО промта (git mv) — раньше Б4, т.к. N075 от него зависит | 1 | 0/0/1 | ⬜ | +| **Б2** | Переезд ОТРАБОТАВШЕГО промта (git mv) — раньше Б4, т.к. N075 от него зависит | 2 | 0/0/2 | ⬜ | | **Б3** | Денежный путь 15-money-path.md (+ парная правка 17:101 по N004) | 7 | 2/3/2 | ⬜ | | **Б4** | Шапка журнала и остальной бэклог | 14 | 0/7/7 | ⬜ | | **Б5** | Контракт API 14 | 8 | 0/4/4 | ⬜ | | **Б6** | Реестр загейченных триггеров 13 | 8 | 0/5/3 | ⬜ | | **Б7** | Шов и эмиттер 16, 17 | 11 | 0/8/3 | ⬜ | | **Б8** | Движковые арх-доки 03, 09, 10, 12 | 16 | 0/4/12 | ⬜ | -| **Б9** | Корневые и онбординг: CLAUDE.md, README, STACK, glossary, product-requirements | 15 | 0/4/11 | ⬜ | +| **Б9** | Корневые и онбординг: CLAUDE.md, README, STACK, glossary, product-requirements | 14 | 0/4/10 | ⬜ | | **Б10** | Ранние арх-доки 01/04/06 — ТОЛЬКО баннеры, архив СНЯТ (контролёр 4.2) | 6 | 0/1/5 | ⬜ | | **Б11** | ЧУЖАЯ ЗОНА: бэкенд-доки — баннеры, НЕ архив (N074 corrected) | 10 | 0/6/4 | ⬜ | | **Б12** | ЧУЖАЯ ЗОНА: фронт-доки (три неприкасаемых) | 15 | 0/8/7 | ⬜ | @@ -103,7 +103,7 @@ **Б0 — СКВОЗНОЙ: «канон 0.9.0» одним касанием — требование контролёра 2.2** Находки: N013, N022, N026, N034, N053, N056, N108 -**Приёмка:** `grep -rn '0\.8\.0' docs/ CLAUDE.md` вне исторических записей = 0; **`docs/README.md:29` НЕ тронута** (два опровергателя независимо: это корректная историческая запись о D39.169); `README:26` уже несёт 0.9.0 — не дублировать. +**Приёмка:** `grep -rn '0\.8\.0' docs/ CLAUDE.md --exclude-dir=archive` минус D-лог и реестр нот = 0, оставшиеся хиты предъявляются ПОИМЁННО с пометкой «историческое»; **`docs/README.md:29` НЕ тронута** (два опровергателя независимо: это корректная историческая запись о D39.169); `README:26` уже несёт 0.9.0 — не дублировать. **Б1 — Блокеры бэклога + строка 240: ОДНА нота на четыре строки** @@ -112,13 +112,13 @@ **Б2 — Переезд ОТРАБОТАВШЕГО промта (git mv) — раньше Б4, т.к. N075 от него зависит** -Находки: N075 +Находки: N075, **N084** (перенесена из Б9: критерий `README.md:25` — поправка опровергателя именно к ней) **Приёмка:** `git show --stat` = ровно rename + `docs/README.md`; после — `grep -rn 'docs/BACKEND_COLDRUN_V16'` даёт только исторические носители (архивный отчёт, D-лог, реестр нот), `COLDRUN_V16_REPORT:51` НЕ тронут (тело архивного отчёта); обе протухшие половины строки `README.md:25` поправлены («развилка НА ВЛАДЕЛЬЦЕ» → закрыта 31.08; «отчёт ждёт лендинга» → заленджен); ⚠ литерал «86 живых доков» в CURRENT-STATE уменьшится — `counts.py` его НЕ сторожит, править руками или снять. **Б3 — Денежный путь 15-money-path.md (+ парная правка 17:101 по N004)** Находки: N004, N005, N039, N040, N041, N113, N114 -**Приёмка:** N002/N003 — обе ветви `run abandon` описаны; провенанс чисел заменён с июльских на замер холодного прогона с явной датой; **N004 требует парной правки `17-seam-inbound-law.md:101` ТЕМ ЖЕ коммитом**, иначе класс E воспроизводится. +**Приёмка:** **N005** (не N002/N003 — те в Б1, испр. по замечанию контролёра) — обе ветви `run abandon` описаны; провенанс чисел заменён с июльских на замер холодного прогона с явной датой; **N004 требует парной правки `17-seam-inbound-law.md:101` ТЕМ ЖЕ коммитом**, иначе класс E воспроизводится. **Б4 — Шапка журнала и остальной бэклог** @@ -138,16 +138,16 @@ **Б7 — Шов и эмиттер 16, 17** Находки: N042, N043, N044, N045, N046, N047, N048, N049, N115, N116, N117 -**Приёмка:** N032 — гвоздь НЕ строить, он построен; §5–§6 дока 16 сам себя баннирует как отработанный хендофф, внешних ссылок ноль — кандидат на вынос в `archive/reports/` с указателем (решение объявить, не делать молча). +**Приёмка:** N046 — форма якоря `mining.go:243-244`=`re-seed the bank with the auto rows`; N047 — атрибуция D39.159 п.7 и пере-суд «строки 139»; N048 — ОБЕ строки таблицы (97 и 103); N049 — хвост с `PD-427`; N044/N115 — StreamVersion **1.2**; N045 — двенадцать якорей в токен-форме. (Прежний критерий про N032 снят: N032 живёт в Б6, испр. по замечанию контролёра.) §5–§6 дока 16 сам себя баннирует как отработанный хендофф, внешних ссылок ноль — кандидат на вынос в `archive/reports/` с указателем (решение объявить, не делать молча). **Б8 — Движковые арх-доки 03, 09, 10, 12** Находки: N023, N024, N027, N028, N092, N093, N095, N096, N097, N098, N099, N100, N101, N102, N103, N104 -**Приёмка:** 09 §1/§2/§4 — тела под ⚠-баннерами, анти-оверфлаг: не лезть, кроме случаев, где содержимое расходится с шапкой; N063 — §8 целиком НЕ сносить. +**Приёмка:** 09 §1/§2/§4 — тела под ⚠-баннерами, анти-оверфлаг: не лезть, кроме мест, где содержимое расходится с шапкой; N027 — буллет `09:144-145` сносится ЦЕЛИКОМ; N092 — отображение `dc6ea8e=7954325 · a32ec2e=e861541 · волна 2=214e005`; N098 — минимальная пометка, НЕ третий носитель; N104 — без списка восьми `file:line`. (Прежний критерий про N063 снят: N063 живёт в Б12, испр. по замечанию контролёра.) **Б9 — Корневые и онбординг: CLAUDE.md, README, STACK, glossary, product-requirements** -Находки: N050, N051, N052, N054, N068, N069, N070, N083, N084, N085, N086, N087, N118, N119, N120 +Находки: N050, N051, N052, N054, N068, N069, N070, N083, N085, N086, N087, N118, N119, N120 **Приёмка:** CLAUDE.md — правка канона владельца: каждая формулировка предъявляется владельцу до коммита; `docs/README.md:29` не трогать (см. Б0). @@ -171,6 +171,44 @@ **Приёмка:** N065 — абзац 251–253 снести, оставив ОДНУ отсылку вверх (не второй носитель); 255–258 не сносить, только зачин; N006 — формулировка «атомарно ПОФАЙЛОВО, пара не транзакционна»; N129 — координаты пере-грепнуть (6 из 7 в реестре промахиваются). Объявление = строка в `platform/docs/platform-PROGRESS.md` ТЕМ ЖЕ коммитом. +**Б14 — РАЗДЕЛЕНА НАТРОЕ по вердикту контролёра (сначала найденное, углы — по трём адресам)** + +Довод контролёра, принят: найденное — 130 утверждений с уликой в носителях, которые читает каждая +сессия; углы — мегабайт НЕИЗВЕСТНОГО состояния, и чинить неизвестное без ревизии значит править +«по впечатлению» — ровно та ошибка, ради которой воркфлоу и строился. + +- **Б14а → влито в Б4.** `docs/PROGRESS.md` строки 19–56 и 273–483 правятся ТЕМ ЖЕ касанием, что + шапка: запись пака 296–371 несёт пинги, которые нота Б1 обязана поглотить (N001 `:344`, + N002/N003 `:306`), а блок «ОТКРЫТО НА №21» (36–42) с исполненными п.1–3 и ложной строкой 42 + нельзя оставлять под только что починенной шапкой. + **Приёмка:** каждый буллет 19–56 сверен с D39.180/182/184; секция 273–371 уезжает в + `archive/PROGRESS-2026-08-backend.md` ТОЛЬКО ПОСЛЕ ноты Б1. +- **Б14б → ОТДЕЛЬНАЯ РЕВИЗИЯ, запущена параллельно, правки после Б9.** + `docs/ORCHESTRATOR_SESSION_PROMPT.md` (32 КБ, не аудирован никем) · статусы + `05-decisions-index.md` · шапка живого D-лога (карта актуальности + эрраты). Тот же протокол: + команда + положительный контроль. Правки идут вместе с корневыми доками, не раньше найденного. +- **Б14в → ПОСЛЕДНИМИ, после Б13.** `platform-PROGRESS.md` (415 КБ) · `DEFECT_REGISTER.md` + (782 КБ) · `platform/BACKLOG.md` · `docs/POLYGON_*`. Лечение — не правка, а НАРЕЗКА по зонной + конвенции слайсов (`archive/platform-PROGRESS-P*.md`): при верной нарезке потеря содержимого + невозможна. Писать 415 КБ чужого журнала ДО того, как зона увидела объявления Б13, — плохой + порядок. + +**Б15 — явный мусор.** **Приёмка (требование контролёра):** на КАЖДЫЙ переносимый файл — список +входящих ссылок и адрес каждой после переезда. Для `frontend/docs/API_CONTRACT_{DRAFT,INPUT}.md` +— пере-углубление относительных путей по D39.80. Для `14-README §6б/6в` две ссылки (D-лог:558 и +реестр:216) ОСТАЮТСЯ ⇒ на месте нужна заглушка-указатель, а не пустота. + +**Б16 — шапки статуса research/experiments.** Тела НЕ трогать (D23.3). **Приёмка — команда:** +``` +for f in docs/research/*.md docs/experiments/*.md; do head -12 "$f" \ + | grep -qiE 'ревью-шапка|ревю-шапка|⚠|статус|superseded|отработан|принят' || echo "$f"; done +``` +→ пусто. Отдельно: `12-failure-modes-ja.md` и `12-failure-modes-zh.md` не имеют ни одной входящей +ссылки во всём дереве — по норме НЕ архив, но шапка обязательна. + +**Б17 — пинги зонам по мёртвым указателям В КОДЕ.** **Приёмка:** пинг = строка зонного журнала, +называющая файл, символ и что именно неверно. **Кода не трогать вовсе.** + ## Карта ДЫР самой ревизии — записываю честно, а не молчу Ревизоры сами назвали, чего не проверили. План это НЕ закрывает; пункты числятся как