From 81f9754c54a29eaac619312a5af434a91be87cb2 Mon Sep 17 00:00:00 2001 From: Dmitry Dementiev Date: Fri, 31 Jul 2026 15:21:49 +0300 Subject: [PATCH] =?UTF-8?q?docs(agents):=20=D0=BA=D0=BE=D0=BD=D1=82=D1=80?= =?UTF-8?q?=D0=B0=D0=BA=D1=82=20=E2=80=94=20=D0=BA=D0=BE=D0=BC=D1=83=20?= =?UTF-8?q?=D0=BF=D0=BE=D1=80=D1=83=D1=87=D0=B0=D1=82=D1=8C=20=D0=B2=D0=BA?= =?UTF-8?q?=D1=83=D1=81=D0=BE=D0=B2=D1=83=D1=8E=20=D1=80=D0=B0=D0=B1=D0=BE?= =?UTF-8?q?=D1=82=D1=83,=20=D0=BA=D0=BE=D0=BC=D1=83=20=D1=82=D0=B5=D1=85?= =?UTF-8?q?=D0=BD=D0=B8=D1=87=D0=B5=D1=81=D0=BA=D1=83=D1=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Зачем. Учебная ценность записана как базовая, но вывода о выборе исполнителя из неё не делалось. Прогон #18 показал цену пропуска: код технически безупречен и при этом неправильной формы — монолитная задача в DAG, ручная машинерия там, где у Airflow есть свой механизм, ноль комментариев к самому неочевидному решению. Что. В «Цель репозитория» добавлено правило: всё, что человек будет читать и разбирать, пишет модель с чувством меры; техническая работа без вкусовых решений — Кодексу; линии ревью всегда разных родословных. Отдельно отмечено, что экономия лимитов на читаемом коде ложная. Проверка. make config-test — пройдено 3, 3 и 6, ошибок 0. Co-Authored-By: Claude Opus 5 (1M context) --- AGENTS.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index c419220..a986010 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -8,6 +8,25 @@ Стенд строится по спеке [«Боевой реализм стенда (v2)»](docs/specs/2026-07-30-stand-v2-realism.md). +Отсюда следует, кому что поручать. Читатель здесь — не побочный потребитель, +а тот, ради кого стенд существует: код, комментарии и документы и есть +продукт. Поэтому всё, что человек будет читать и разбирать, пишет модель с +чувством меры — по умолчанию Opus. Кодексу остаётся техническая работа без +вкусовых решений: миграции, разбор журналов и объёмного вывода, обход +репозитория, повторяющиеся правки; там его больши́е лимиты работают на нас. +Ревью идёт наоборот: разбор реализации на уместность ведёт Opus, а Кодекс +даёт независимое второе мнение другой родословной — линии ревью всегда +разных родословных, кто бы ни был исполнителем. + +Разрез проходит не по задаче целиком, а по подзадачам, и намечается при +планировании: вкусовое — Опусу, руки — Кодексу. Сначала идёт вкусовая часть: +она задаёт форму, имена и границы, под которые механическая потом +подстраивается. Писатель в дереве в каждый момент один — либо +последовательно, либо по непересекающимся файлам. + +Экономить лимиты на том, что читает человек, — ложная экономия: переписывать +выйдет дороже, чем сразу написать хорошо. + ## Язык Пиши на ясном русском языке. Иностранные слова оставляй только там, где у