From 8903b6a054fe91aebce80346a1279b4cbb669f4a Mon Sep 17 00:00:00 2001 From: Dmitry Dementiev Date: Fri, 7 Aug 2026 12:04:43 +0300 Subject: [PATCH] =?UTF-8?q?docs(agents):=20=D1=83=D1=81=D0=BB=D0=BE=D0=B6?= =?UTF-8?q?=D0=BD=D0=B5=D0=BD=D0=B8=D0=B5=20=D0=BD=D0=B5=20=D0=B1=D0=B5?= =?UTF-8?q?=D1=81=D0=BF=D0=BB=D0=B0=D1=82=D0=BD=D0=BE=20=E2=80=94=20=D0=BF?= =?UTF-8?q?=D0=BB=D0=B0=D1=82=D0=B8=D1=82=20=D1=83=D1=87=D0=B5=D0=B1=D0=BD?= =?UTF-8?q?=D0=B0=D1=8F=20=D1=86=D0=B5=D0=BD=D0=BD=D0=BE=D1=81=D1=82=D1=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Зачем: - у вопроса «чему на этом научится менти?» не хватало второй половины: он отсеивал бесполезное, но не взвешивал цену полезного. Стенд учебный, и чем он сложнее, тем хуже как учебный материал. - прогон #41 показал механизм: две слепые линии ревью дали 15 находок, саморевью ещё 7, и каждая по устройству триажа превратилась в правку. Шага, на котором кто-нибудь вычитает, в конвейере не было ни разу — только воронка. Проход на вычитание потом срезал 149 строк и 6 тестов, и всё срезанное появилось после ревью, а не при замысле. - Что: - в раздел «Цель репозитория» добавлены три абзаца: внимание менти как конечная валюта и вопрос «что он платит и что получает»; почему оборонительный код дороже прочего и врёт про опасность; проход на вычитание как обязательный шаг перед приёмкой заметной работы. - записано частное правило, выведенное владельцем на двух резах подряд: не сторожить ошибку, которую человек делает сам себе и тут же видит — разбирательство с ней и есть урок. - Проверка: - правка текстовая, целей make не задевает; make config-test зелёный. Co-Authored-By: Claude Opus 5 --- AGENTS.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 369383d..7be781a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -13,6 +13,26 @@ складывается фраза — это вопрос владельцу, а не строчка кода: проверки в этом репозитории однажды уже переросли продукт. +**Усложнение не бесплатно, и платит за него учебная ценность.** Чем сложнее +стенд, тем хуже он как учебный материал: внимание менти конечно, и каждая +конструкция, которую он обязан расшифровать по дороге к уроку, списывается с +этого счёта. Поэтому вопрос выше имеет вторую половину: **что менти платит, +чтобы это прочесть, и что получает взамен?** Ответ «вопрос — и ничего» +означает, что писать не нужно. + +Оборонительный код дороже прочего. Читатель не отличает «стоит здесь, потому +что есть настоящая опасность» от «стоит здесь, потому что кто-то был +остроумен», — и предполагает первое. Лишний сторож не безобиден: он +утверждает, будто опасность заслуживает внимания, и этим врёт. Особенно это +касается защиты от ошибки, которую человек делает сам себе и тут же видит: +разбирательство с ней и есть урок, отнимать его не надо. + +Ревью само по себе умеет только прибавлять: каждая находка просится в правку, +и за прогон их набираются десятки. Поэтому перед приёмкой заметной работы +идёт отдельный **проход на вычитание** — с правом только резать и с явным +списком неприкосновенного. Сомнение «резать или нет» решается в пользу +реза: вещь, которая себя не защитила, себя не защитила. + ## Кому что поручать Читатель здесь не побочный потребитель, а тот, ради кого стенд существует: