docs(agents): усложнение не бесплатно — платит учебная ценность
- Зачем:
- у вопроса «чему на этом научится менти?» не хватало второй половины:
он отсеивал бесполезное, но не взвешивал цену полезного. Стенд
учебный, и чем он сложнее, тем хуже как учебный материал.
- прогон #41 показал механизм: две слепые линии ревью дали 15 находок,
саморевью ещё 7, и каждая по устройству триажа превратилась в правку.
Шага, на котором кто-нибудь вычитает, в конвейере не было ни разу —
только воронка. Проход на вычитание потом срезал 149 строк и 6 тестов,
и всё срезанное появилось после ревью, а не при замысле.
- Что:
- в раздел «Цель репозитория» добавлены три абзаца: внимание менти как
конечная валюта и вопрос «что он платит и что получает»; почему
оборонительный код дороже прочего и врёт про опасность; проход на
вычитание как обязательный шаг перед приёмкой заметной работы.
- записано частное правило, выведенное владельцем на двух резах подряд:
не сторожить ошибку, которую человек делает сам себе и тут же видит —
разбирательство с ней и есть урок.
- Проверка:
- правка текстовая, целей make не задевает; make config-test зелёный.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
@@ -13,6 +13,26 @@
|
||||
складывается фраза — это вопрос владельцу, а не строчка кода: проверки в этом
|
||||
репозитории однажды уже переросли продукт.
|
||||
|
||||
**Усложнение не бесплатно, и платит за него учебная ценность.** Чем сложнее
|
||||
стенд, тем хуже он как учебный материал: внимание менти конечно, и каждая
|
||||
конструкция, которую он обязан расшифровать по дороге к уроку, списывается с
|
||||
этого счёта. Поэтому вопрос выше имеет вторую половину: **что менти платит,
|
||||
чтобы это прочесть, и что получает взамен?** Ответ «вопрос — и ничего»
|
||||
означает, что писать не нужно.
|
||||
|
||||
Оборонительный код дороже прочего. Читатель не отличает «стоит здесь, потому
|
||||
что есть настоящая опасность» от «стоит здесь, потому что кто-то был
|
||||
остроумен», — и предполагает первое. Лишний сторож не безобиден: он
|
||||
утверждает, будто опасность заслуживает внимания, и этим врёт. Особенно это
|
||||
касается защиты от ошибки, которую человек делает сам себе и тут же видит:
|
||||
разбирательство с ней и есть урок, отнимать его не надо.
|
||||
|
||||
Ревью само по себе умеет только прибавлять: каждая находка просится в правку,
|
||||
и за прогон их набираются десятки. Поэтому перед приёмкой заметной работы
|
||||
идёт отдельный **проход на вычитание** — с правом только резать и с явным
|
||||
списком неприкосновенного. Сомнение «резать или нет» решается в пользу
|
||||
реза: вещь, которая себя не защитила, себя не защитила.
|
||||
|
||||
## Кому что поручать
|
||||
|
||||
Читатель здесь не побочный потребитель, а тот, ради кого стенд существует:
|
||||
|
||||
Reference in New Issue
Block a user