Compare commits

..
2 Commits
Author SHA1 Message Date
ddadminandClaude Opus 5 13f196d1a9 docs(agents): закрывать issue английским Closes в теле PR
Зачем.
В заметке было сказано, что Gitea не понимает русские ключевые слова, но не
было сказано, что делать вместо этого. На тех же граблях наступили снова:
PR #19 слился, issue #18 остался открытым.

Что.
Правило: писать в теле PR английское `Closes #NN`; ручное закрытие остаётся
запасным путём, если ключевого слова не было.

Проверка.
make config-test — пройдено 3, 3 и 6, ошибок 0.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-31 15:31:16 +03:00
ddadminandClaude Opus 5 903b483eb1 docs(agents): контракт — кому поручать вкусовую работу, кому техническую
Зачем.
Учебная ценность записана как базовая, но вывода о выборе исполнителя из
неё не делалось. Прогон #18 показал цену пропуска: код технически
безупречен и при этом неправильной формы — монолитная задача в DAG, ручная
машинерия там, где у Airflow есть свой механизм, ноль комментариев к самому
неочевидному решению.

Что.
Новый раздел «Кому что поручать»: то, что человек будет читать и разбирать,
пишет модель с чувством меры; техническая работа без вкусовых решений — за
Codex; делить работу по подзадачам при планировании, вкусовая часть первой.
Про ревью сказано прямо: когда вкусовую линию ведёт та же родословная, что
писала код, независимость частично теряется — это плата за вкус, и гасится
она свежей сессией и другой линзой.

Проверка.
make config-test — пройдено 3, 3 и 6, ошибок 0.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-31 15:31:16 +03:00
2 changed files with 23 additions and 19 deletions
+16 -16
View File
@@ -8,24 +8,24 @@
Стенд строится по спеке
[«Боевой реализм стенда (v2)»](docs/specs/2026-07-30-stand-v2-realism.md).
Отсюда следует, кому что поручать. Читатель здесь — не побочный потребитель,
а тот, ради кого стенд существует: код, комментарии и документы и есть
продукт. Поэтому всё, что человек будет читать и разбирать, пишет модель с
чувством меры — по умолчанию Opus. Кодексу остаётся техническая работа без
вкусовых решений: миграции, разбор журналов и объёмного вывода, обход
репозитория, повторяющиеся правки; там его больши́е лимиты работают на нас.
Ревью идёт наоборот: разбор реализации на уместность ведёт Opus, а Кодекс
даёт независимое второе мнение другой родословной — линии ревью всегда
разных родословных, кто бы ни был исполнителем.
## Кому что поручать
Разрез проходит не по задаче целиком, а по подзадачам, и намечается при
планировании: вкусовое — Опусу, руки — Кодексу. Сначала идёт вкусовая часть:
она задаёт форму, имена и границы, под которые механическая потом
подстраивается. Писатель в дереве в каждый момент один — либо
последовательно, либо по непересекающимся файлам.
Читатель здесь не побочный потребитель, а тот, ради кого стенд существует:
код, комментарии и документы и есть продукт. Поэтому всё, что человек будет
читать и разбирать, пишет модель с чувством меры — сейчас это Opus. Codex
берёт техническую работу без вкусовых решений: миграции, разбор журналов и
объёмного вывода, обход репозитория, повторяющиеся правки. Там его запас
лимитов работает на нас, а экономить их на читаемом коде — экономия ложная:
переписывать выйдет дороже, чем сразу написать хорошо.
Экономить лимиты на том, что читает человек, — ложная экономия: переписывать
выйдет дороже, чем сразу написать хорошо.
Делить работу между ними стоит не целыми задачами, а подзадачами, и решать
это при планировании. Вкусовая часть идёт первой: она задаёт форму, имена и
границы, под которые механическая потом подстраивается.
Ревью держит две линии разных родословных: линию уместности ведёт Opus,
линию дефектов — Codex. Когда Opus писал и код, его линия теряет часть
независимости — это осознанная плата за вкус, и она гасится тем, что ревью
идёт свежей сессией без общего контекста и с явно другой линзой.
## Язык
+7 -3
View File
@@ -53,9 +53,13 @@ Gitea понимает только английские ключевые сло
ссылка, issue останется открытым. Наступали не раз: последний случай — слияние
PR #17, где issue #13 пришлось закрывать руками.
Порядок после слияния: закрыть задачу (`tea issues close <номер>`) и тикнуть
её пункт в чек-листе родительского issue этапа — Gitea чек-листы сама не
обновляет.
Отсюда простое правило: пиши в теле PR английское `Closes #NN` — тогда
слияние закроет задачу само, и ручного шага не остаётся. Всё остальное в PR
по-прежнему на русском: ключевое слово здесь не текст, а команда трекеру.
Если ключевого слова не было, порядок после слияния: закрыть задачу
(`tea issues close <номер>`) и тикнуть её пункт в чек-листе родительского
issue этапа — Gitea чек-листы сама не обновляет.
## Спека — источник истины