Ratify the documentation revision and cleanup: 731 KB removed across all zones, entry cost down a fifth, and three norms turned into gates
This commit is contained in:
parent
418633a012
commit
68e8629eb2
4 changed files with 102 additions and 13 deletions
|
|
@ -86,17 +86,17 @@
|
|||
| **Б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 | 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 | ⬜ |
|
||||
| **Б13** | ЧУЖАЯ ЗОНА: платформенные доки | 8 | 1/4/3 | ⬜ |
|
||||
| **Б14** | Углы вне ОБЕИХ сеток: `PROGRESS` 19–56 и 273–483 · `ORCHESTRATOR_SESSION_PROMPT.md` (32 КБ, не аудирован никем) · `05-decisions-index.md` статусы · шапка D-лога · `platform/BACKLOG.md` · `platform-PROGRESS.md` (415 КБ) · `DEFECT_REGISTER.md` (782 КБ) · `docs/POLYGON_*` | — | — | ⬜ |
|
||||
| **Б15** | Явный мусор: байт-дубль промта P0 в двух архивах · `frontend/docs/API_CONTRACT_{DRAFT,INPUT}.md` (78 КБ с баннером «не читать» в ЖИВОМ каталоге) · `16-events-emitter` §5–§6 · `14-README` §6б/6в | — | — | ⬜ |
|
||||
| **Б16** | Шапки статуса у `research/**` и `experiments/**` (60 файлов): тела НЕ трогать (D23.3), только датированная строка статуса там, где её нет | — | — | ⬜ |
|
||||
| **Б17** | Пинги зонам по МЁРТВЫМ УКАЗАТЕЛЯМ В КОДЕ (не доки, правит зона): `artifact.go:11` · `backup.go:28` · `pgstore/books.go:776` · `languages.ts:3-8` · `tmctl/main.go:72` · `store/ledger.go:172` · `cheapgates.go:34` · `pipeline.puml:72` | — | — | ⬜ |
|
||||
| **Б7** | Шов и эмиттер 16, 17 | 11 | 0/8/3 | ◐ закрыт РЕЗОМ частично |
|
||||
| **Б8** | Движковые арх-доки 03, 09, 10, 12 | 16 | 0/4/12 | ◐ закрыт РЕЗОМ частично |
|
||||
| **Б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 | ◐ закрыт РЕЗОМ частично |
|
||||
| **Б13** | ЧУЖАЯ ЗОНА: платформенные доки | 8 | 1/4/3 | ◐ закрыт РЕЗОМ частично |
|
||||
| **Б14** | Углы вне ОБЕИХ сеток: `PROGRESS` 19–56 и 273–483 · `ORCHESTRATOR_SESSION_PROMPT.md` (32 КБ, не аудирован никем) · `05-decisions-index.md` статусы · шапка D-лога · `platform/BACKLOG.md` · `platform-PROGRESS.md` (415 КБ) · `DEFECT_REGISTER.md` (782 КБ) · `docs/POLYGON_*` | — | — | ⬜ следующей смене |
|
||||
| **Б15** | Явный мусор: байт-дубль промта P0 в двух архивах · `frontend/docs/API_CONTRACT_{DRAFT,INPUT}.md` (78 КБ с баннером «не читать» в ЖИВОМ каталоге) · `16-events-emitter` §5–§6 · `14-README` §6б/6в | — | — | ⬜ следующей смене |
|
||||
| **Б16** | Шапки статуса у `research/**` и `experiments/**` (60 файлов): тела НЕ трогать (D23.3), только датированная строка статуса там, где её нет | — | — | ✅ ЗАКРЫТ |
|
||||
| **Б17** | Пинги зонам по МЁРТВЫМ УКАЗАТЕЛЯМ В КОДЕ (не доки, правит зона): `artifact.go:11` · `backup.go:28` · `pgstore/books.go:776` · `languages.ts:3-8` · `tmctl/main.go:72` · `store/ledger.go:172` · `cheapgates.go:34` · `pipeline.puml:72` | — | — | ⬜ следующей смене |
|
||||
|
||||
### Критерии приёмки по батчам
|
||||
|
||||
|
|
@ -236,3 +236,35 @@ for f in docs/research/*.md docs/experiments/*.md; do head -12 "$f" \
|
|||
**Хвост лендинга ресёрча.** Очередь п.5 велит новой смене лендить файл, лендинг которого владелец
|
||||
01.09 откатил (`162ab9b`). Пока формулировка стоит, следующая смена повторит откат.
|
||||
**Формулировку задаёт владелец — сам не переписываю.**
|
||||
|
||||
---
|
||||
|
||||
## ⟶ СОСТОЯНИЕ НА ЗАКРЫТИЕ СМЕНЫ №22 (02.09.2026)
|
||||
|
||||
**Что случилось сверх плана.** Владелец 02.09 расширил заказ с «починить протухшее» до «спилить всё
|
||||
лишнее во ВСЕХ зонах». Отработали три прохода агентами (рез → сверка → дофикс) плюс финальный:
|
||||
**живые доки 4.41 → 3.68 МБ, снято 731 КБ**; вход бэкенд-сессии **347 → ~270 КБ**.
|
||||
|
||||
**Батчи Б7–Б13 закрыты РЕЗОМ частично, а не по реестру находок.** Контролёр свёл два потока:
|
||||
29 находок закрываются уликой реза (`N042 N043 N045 N116 N117 N024 N092 N093 N027 N028 N098 N099
|
||||
N101 N050 N051 N088 N094 N010 N074 N055 N121 N057 N059 N061 N062 N124 N126 N065 N128`), 11 остатков
|
||||
(`N044/N115` строка 243 · `N048` · `N097` · `N095` · `N025` · `N008` · `N073` · `N060` · `N066` ·
|
||||
`N129`), 2 открыты (`N007` backend/README · `N100` 10-prompt).
|
||||
|
||||
**Седьмой слайс журнала — ВЫЧЕРКНУТ**, не отложен. Довод замером: журнал на маршруте чтения не лежит
|
||||
(канон велит «целиком не читать», номер грепается), а греп ходит и в слайсы ⇒ вынос не экономит ни
|
||||
байта входа, ни шума поиска. Только выглядел бы работой.
|
||||
|
||||
**Гейты, построенные вместо норм-пожеланий** (`docs/scripts/counts.py`, проверены посадкой мутаций):
|
||||
вес бэклога судится ПРЕФИКСОМ ячейки (девять известных рядов — дедовщиной, гейт краснеет на десятом) ·
|
||||
токен якоря короче 12 знаков не считается сверкой по содержимому · временные доки разбора в
|
||||
`LINT_SKIP_DOCS`. Линтер: **52 предупреждения → 0**; сверяемых по содержимому **16% → 22%**.
|
||||
|
||||
**Что НЕ построено и передаётся:** гейт «удалена строка защищённого класса без адреса в том же
|
||||
коммите» — идея контролёра, выведенная из корпуса: все 18 признанных потерь смены несли маркер
|
||||
защищённого класса. Это перевод протокола удаления из дисциплины в механику, и он стоит больше
|
||||
остальных вместе взятых.
|
||||
|
||||
**Сжатие реестра нот под кап 400 Б/ряд — следующей смене.** Замер: реестр 132 КБ, **47% входа**;
|
||||
медиана ряда первых 60 нот — 277 Б, последних 60 — **566 Б** (норма «одна строка на ноту» сгнила вдвое
|
||||
за месяц). Гейт формы родится КРАСНЫМ на ~100 рядах — это и есть наряд.
|
||||
|
|
|
|||
File diff suppressed because one or more lines are too long
|
|
@ -244,3 +244,4 @@
|
|||
| D39.183 | 31.08 | **Слово владельца: запрет «не подгонять тесты под зелень» — про МОТИВ.** Правка *чтобы прошло* запрещена; правка от ЗАКАЗАННОЙ или ратифицированной смены поведения — обслуживание, протухший тест не держим. ⚠ Заказанность решает ЗАКАЗ, а не сессия. Условие — объявление в отчёте | жив | ЖИВОЕ: полноту объявления не проверяет ничто — строка бэклога 248 | тесты канон процесс |
|
||||
| D39.184 | 01.09 | **Передача роли оркестратора №21 → №22.** Смена приняла P12 + минор 0.9.0, холодный прогон, закон раскрытия и одиннадцать экземпляров — D39.179–D39.182; `arch-3` закрыт. Девять названных ошибок оркестратора. ⚠ Класс смены: **отсутствие в своей области видимости принято за отсутствие вообще — четырежды у трёх участников**; норма — отрицательный результат с ПОЛОЖИТЕЛЬНЫМ КОНТРОЛЕМ | жив | ЖИВОЕ: заказ владельца 01.09 — ревизия доков на протухшее, планы бэкенда и платформы, вынос в архив | передача процесс |
|
||||
| D39.185 | 01.09 | **Четыре строки бэклога закрыты лендингами 31.08, а в таблице стояли открытыми:** 194 (деньги банк-ролей в проекции, A10) · 238 (деньги слепы к правке исходника на месте, A6) · 239 (`checkWave` не видел исчезнувшую стадию, A7+A12) · 240 (оплаченный стоп подписи мог исчезнуть молча, P12). ⚠ 238 и 239 стояли в шапке секции «Бэкенд» как СВОБОДНАЯ РАБОТА ЗОНЫ. Два опровержения текста 194 и честная граница: проекция денег стала НИЖНЕЙ | жив |
|
||||
| D39.186 | 02.09 | **Ревизия и чистка документации ВСЕХ зон по заказу владельца.** 1432 утверждения проверены исполнением, 130 живых находок (6 блокеров); три прохода агентами + финальный: живые доки 4.41 → 3.68 МБ (снято 731 КБ), вход сессии 347 → ~270 КБ. Контроль — агент Fable 5.1 сквозным контекстом: 18 потерь защищённых классов и ~27 дефектов реза найдены и починены. Нормы переведены в гейты: префикс веса бэклога · минимум токена якоря 12 знаков; линтер 52 → 0, сверяемых 16% → 22%. Строки бэклога 194/238/239/240 закрыты D39.185. | жив |
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
# Журнал решений оркестратора — контракт D1–D39.185 (живой файл: карта · эрраты · живые тела · голова D39.124+ (подрезка D39.139); тела закрытых эр — в слайсах `docs/archive/architecture/`, указатель ниже; реестр всех нот — `05-decisions-index.md`)
|
||||
# Журнал решений оркестратора — контракт D1–D39.186 (живой файл: карта · эрраты · живые тела · голова D39.124+ (подрезка D39.139); тела закрытых эр — в слайсах `docs/archive/architecture/`, указатель ниже; реестр всех нот — `05-decisions-index.md`)
|
||||
|
||||
> **⟶ КАРТА АКТУАЛЬНОСТИ (ревизия D31, продлена до D38.2 [12.07]; исторические записи ниже НЕ переписываются — дисциплина D23.3).** Работая с контрактом (греп номера: живой файл → слайсы, целиком НЕ читать — D39.125), держи под рукой, что чем перекрыто:
|
||||
> ⚠ **Эррата 09.08 (D39.125):** D39.111 п.1 предписывал промту S3 «максимум = баланс МИНУС открытые холды» — формула ОШИБОЧНА (вычитание дважды), исправлена D39.115 п.2(а): максимум = Balance КАК ЕСТЬ; тело D39.111 живёт ниже в этом файле (голова D39.106+).
|
||||
|
|
@ -1899,3 +1899,59 @@ content-hash строки.
|
|||
**Провенанс находок:** ревизия документации 01.09 (воркфлоу `docs-staleness-revision-A`, 15 срезов ×
|
||||
ревизор+опровергатель, 1432 утверждения проверены исполнением); реестр — `docs/DOC_REVISION_FINDINGS.md`,
|
||||
контроль исполнения — отдельный агент Fable 5.1 (решение владельца 01.09).
|
||||
|
||||
## D39.186 — РЕВИЗИЯ И ЧИСТКА ДОКУМЕНТАЦИИ ВСЕХ ЗОН: снято 731 КБ, вход сессии упал на пятую часть, нормы переведены в гейты (02.09). ✅
|
||||
|
||||
**Заказ владельца 01–02.09,** расширявшийся трижды: ревизия на протухшее → планы доработок и архив →
|
||||
**«спилить мусор из документации и дать лёгкий путь новым сессиям, но не потерять важное»** → «убрать
|
||||
всё лишнее», с прямой санкцией на документацию ЧУЖИХ зон (платформа, фронт, бэкенд).
|
||||
|
||||
### Что сделано
|
||||
|
||||
**Ревизия исполнением** (воркфлоу, 15 срезов × ревизор+опровергатель, 30 агентов): **1432 утверждения
|
||||
проверены командой**, 115 положительных контролей, 137 находок → адверсариальный пере-суд снял 7 →
|
||||
**130 живых**, из них 6 блокеров. Реестр — `docs/DOC_REVISION_FINDINGS.md`.
|
||||
|
||||
**Чистка тремя проходами** (рез → сверка → дофикс) плюс финальный: **живые доки 4.41 → 3.68 МБ**,
|
||||
снято **731 КБ**; вход бэкенд-сессии **347 → ~270 КБ**. Контроль исполнения — отдельный агент модели
|
||||
Fable 5.1 со сквозным контекстом (решение владельца): он отсудил ~430 кандидатов, нашёл **18 потерь
|
||||
защищённых классов (4 весомых)** и **~27 дефектов, внесённых самим резом** — все возвращены и починены.
|
||||
|
||||
**Нормы переведены в ГЕЙТЫ** (`docs/scripts/counts.py`, каждый проверен посадкой мутации):
|
||||
- вес бэклога судится **ПРЕФИКСОМ** ячейки; девять рядов, потерявших вес до гейта, — дедовщиной,
|
||||
гейт краснеет на десятом. Прежний счёт подстрокой давал ложное срабатывание от слова «скоро» в прозе;
|
||||
- **токен якоря короче 12 знаков** не считается сверкой по содержимому: долю сверяемых можно было
|
||||
накрутить пустышкой;
|
||||
- временные артефакты разбора — в `LINT_SKIP_DOCS` (52 предупреждения из 52 были в них одних).
|
||||
Итог: **линтер 52 → 0**, сверяемых по содержимому **16% → 22%**.
|
||||
|
||||
**Две строки канона, заработанные сменой:** греп живого дерева с исключением `prompts`/`reports`
|
||||
(но НЕ `archive/architecture` — там тела закрытых эр) · сообщение коммита о ДЕРЕВЕ, не о процессе.
|
||||
|
||||
### Что записано против себя
|
||||
|
||||
- **Блокеры бэклога:** строки **194 · 238 · 239 · 240** закрыты лендингами 31.08, а в таблице стояли
|
||||
открытыми, и **238/239 шапка предлагала следующей сессии как свободную работу** — её отправили бы
|
||||
строить построенное. Закрыты нотой D39.185.
|
||||
- **Шапка очереди учила выдуманному числу:** «редактор съел 73% захода» — в отчёте холодного прогона
|
||||
числа 73% НЕТ НИ РАЗУ (греп = 0), реальные 49.3% и 81.3%.
|
||||
- **Денежный док занижал цену главы в 5–8 раз:** числа мерены до пере-пина DeepSeek (×4.47, D39.179),
|
||||
и знак вывода перевёрнут — константа $0.03 не завышена, а ЗАНИЖЕНА.
|
||||
- **Реестр нот — 47% входа сессии** при собственной норме «одна строка на ноту»: медиана ряда первых
|
||||
60 нот 277 Б, последних 60 — **566 Б**. Норма сгнила вдвое за месяц; сжатие — следующей смене.
|
||||
- **Тела нот тронуты девять раз** (D39.124 · D39.128 · D39.153 · D39.155). Проверено перед решением:
|
||||
отличительный токен каждой снятой строки живёт ещё в 4–61 файле, уникально не потеряно ничего;
|
||||
**владелец 02.09 велел не откатывать** — заказ был вырезать мусор. Запись выправлена эрратой 02.09-в.
|
||||
- **Ошибки оркестратора:** наряд второго прохода сопоставлен срезам ПО ПОРЯДКУ в журнале без проверки
|
||||
порядка — агенты поймали и нашли свои наряды сами · трижды подряд исполнялся первый пункт поправки
|
||||
контролёра при брошенном нумерованном остатке · дважды греп по форме принят за проверку смысла
|
||||
(регистр, разметка ячейки) · сообщения коммитов несли механику сессии (24 из 47).
|
||||
- **Контролёр ошибся четырежды** и записал это на себя: метод счёта якорей («93 новых» → **девять**,
|
||||
при этом рез снял 260 чистыми), артефакт «за концом файла», неверный операнд, промах по носителю.
|
||||
|
||||
### Открыто на следующей смене
|
||||
|
||||
Сжатие реестра нот под кап 400 Б/ряд (гейт формы родится красным — это и есть наряд) · гейт «удалена
|
||||
строка защищённого класса без адреса в том же коммите» (все 18 потерь смены несли такой маркер) ·
|
||||
батчи Б14/Б15/Б17 · 11 остатков и 2 открытых находки реестра · норма письма доков — черновик разобран
|
||||
контролёром, владельцу не вносилась. Седьмой слайс журнала **вычеркнут** замером, не отложен.
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue