diff --git a/AGENTS.md b/AGENTS.md index 369383d..7be781a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -13,6 +13,26 @@ складывается фраза — это вопрос владельцу, а не строчка кода: проверки в этом репозитории однажды уже переросли продукт. +**Усложнение не бесплатно, и платит за него учебная ценность.** Чем сложнее +стенд, тем хуже он как учебный материал: внимание менти конечно, и каждая +конструкция, которую он обязан расшифровать по дороге к уроку, списывается с +этого счёта. Поэтому вопрос выше имеет вторую половину: **что менти платит, +чтобы это прочесть, и что получает взамен?** Ответ «вопрос — и ничего» +означает, что писать не нужно. + +Оборонительный код дороже прочего. Читатель не отличает «стоит здесь, потому +что есть настоящая опасность» от «стоит здесь, потому что кто-то был +остроумен», — и предполагает первое. Лишний сторож не безобиден: он +утверждает, будто опасность заслуживает внимания, и этим врёт. Особенно это +касается защиты от ошибки, которую человек делает сам себе и тут же видит: +разбирательство с ней и есть урок, отнимать его не надо. + +Ревью само по себе умеет только прибавлять: каждая находка просится в правку, +и за прогон их набираются десятки. Поэтому перед приёмкой заметной работы +идёт отдельный **проход на вычитание** — с правом только резать и с явным +списком неприкосновенного. Сомнение «резать или нет» решается в пользу +реза: вещь, которая себя не защитила, себя не защитила. + ## Кому что поручать Читатель здесь не побочный потребитель, а тот, ради кого стенд существует: