журнал решений: разложен по теме на файл, метки решений стали номерами

- DECISIONS.md (4040 строк, 65 тем) → decisions/, файл на тему плюс указатель;
- буквенные метки решений заменены сквозными Р1–Р234, следствия получили
  префикс С при прежних номерах: схема букв выродилась до пятибуквенных и
  сломалась — `АЕАКЛ` была занята и темой 53, и темой 65;
- 42 перекрёстные ссылки переписаны под новые номера и стали живыми; где номер
  означал тему, а слово стояло «решение», формулировка исправлена.
This commit is contained in:
av
2026-08-13 12:40:56 +03:00
parent b411d4edb8
commit bf6a173115
72 changed files with 4253 additions and 4053 deletions
+40
View File
@@ -0,0 +1,40 @@
# 41. Разметка задачи: одна величина, посчитанная один раз (2026-08-07)
Разметка была стадией 0 **ревью кода** и платилась на каждом прогоне. Перед ревью
дизайна ту же самую величину — «крупное или незнакомое?» — называл сам пайплайн
задачи, то есть оркестратор, который только что довёл предложение до `propose`.
Одно и то же измерялось дважды, и один из двух раз без разведённости с автором —
ровно в той точке, ради которой разметчик и заведён.
**Р166. Разметка идёт один раз на задачу, сразу после `propose`.** Её план
обслуживает обе стадии ревью: состав ревью дизайна и таблицу тем для ревью кода.
Диффа она не видит — кода ещё нет; размер оценивается по дельта-спекам и перечню
границ задачи.
**Р167. Осей две, ступень — максимум по ним.** **Размер** (малое, среднее,
крупное) — про объём; **сложность** (знакомое, незнакомое) — про то, известна ли
форма решения заранее. Раньше обе были склеены в один вопрос «крупное **или**
незнакомое?»: ответ получался тот же, но разметка не могла сказать «среднее, но
совершенно знакомое» — а это и есть рабочее умолчание.
**Р168. Ступень после кода не пересматривается.** Дифф может выйти крупнее
ожидания — ступень не двинется. Пересмотр означал бы либо второй запуск
разметчика (то, ради устранения чего он и переехал), либо машинный порог,
который на нетипичной задаче срабатывает не туда. Расхождение факта с разметкой
ловит журнал дефектов, постфактум, — так же, как и всякую другую ошибку выбора
ступени.
**Р169. План на диск не пишется.** Файл-план стал бы четвёртым артефактом рядом
с `proposal.md`, `tasks.md` и `design.md`, пережил бы задачу и разошёлся бы с
ней молча. Прервался пайплайн — разметка повторяется; это самый дешёвый его
проход.
## Что из этого следует
**С151. Величина, из которой выводится состав, считается один раз и одним
агентом.** Два места, считающие одно и то же, расходятся; расходятся они молча,
и побеждает то, у которого меньше разведённости с автором.
**С152. Разведённость — свойство момента, а не роли.** Тот же агент, спрошенный
до написания кода и после, даёт разные ответы; переезд по времени сделал больше,
чем сделал бы любой запрет.