ddmitry/clickstream-data-platform
1
0
Fork 0
Code Issues 15 Pull Requests Actions Packages Projects 1 Releases Wiki Activity

docs(agents): контракт — кому поручать вкусовую работу, кому техническую

Browse Source 
Зачем.
Учебная ценность записана как базовая, но вывода о выборе исполнителя из
неё не делалось. Прогон #18 показал цену пропуска: код технически
безупречен и при этом неправильной формы — монолитная задача в DAG, ручная
машинерия там, где у Airflow есть свой механизм, ноль комментариев к самому
неочевидному решению.

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

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

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
ddadmin
2026-07-31 15:22:38 +03:00
co-authored by Claude Opus 5
parent 812b398ce2
commit 81f9754c54
1 changed files with 19 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTS.md
+19
View File
@@ -8,6 +8,25 @@
Стенд строится по спеке
[«Боевой реализм стенда (v2)»](docs/specs/2026-07-30-stand-v2-realism.md).
Отсюда следует, кому что поручать. Читатель здесь — не побочный потребитель,
а тот, ради кого стенд существует: код, комментарии и документы и есть
продукт. Поэтому всё, что человек будет читать и разбирать, пишет модель с
чувством меры — по умолчанию Opus. Кодексу остаётся техническая работа без
вкусовых решений: миграции, разбор журналов и объёмного вывода, обход
репозитория, повторяющиеся правки; там его больши́е лимиты работают на нас.
Ревью идёт наоборот: разбор реализации на уместность ведёт Opus, а Кодекс
даёт независимое второе мнение другой родословной — линии ревью всегда
разных родословных, кто бы ни был исполнителем.
Разрез проходит не по задаче целиком, а по подзадачам, и намечается при
планировании: вкусовое — Опусу, руки — Кодексу. Сначала идёт вкусовая часть:
она задаёт форму, имена и границы, под которые механическая потом
подстраивается. Писатель в дереве в каждый момент один — либо
последовательно, либо по непересекающимся файлам.
Экономить лимиты на том, что читает человек, — ложная экономия: переписывать
выйдет дороже, чем сразу написать хорошо.
## Язык
Пиши на ясном русском языке. Иностранные слова оставляй только там, где у