https://beregov.me/ru/notes/Recent content in Заметки on Максим БереговHugoruTue, 29 Sep 2026 03:30:00 +0300https://beregov.me/ru/notes/how-this-site-was-made/Tue, 29 Sep 2026 03:30:00 +0300https://beregov.me/ru/notes/how-this-site-was-made/<p>Сайт я собирал вместе с ИИ за одну длинную сессию. Самое интересное в этом было не в коде, а в том, как менялось представление о том, каким он должен быть.</p> <h2 id="брендбук-под-меня--но-не-мне">Брендбук под меня — но не мне</h2> <p>Когда-то мне сделали брендбук: неоновый зелёный, космический туннель, пиксельный шрифт, заголовки капителью. Первым делом сайт сделали строго по нему. Получилось аккуратно и узнаваемо — и мне понравилось меньше, чем было до этого, в простой вёрстке.</p>https://beregov.me/ru/notes/readme-and-agents/Tue, 29 Sep 2026 02:00:00 +0300https://beregov.me/ru/notes/readme-and-agents/<p>В каждом моём репозитории — от библиотеки на Go до обёртки над чужим образом — лежат четыре файла: <code>README.md</code>, <code>CONTRIBUTING.md</code>, <code>CHANGELOG.md</code> и <code>AGENTS.md</code>. Обязательны все четыре, исключений по типу репозитория нет.</p> <p>Главное правило одно: <strong>README, CONTRIBUTING и CHANGELOG пишет человек человеку. AGENTS.md пишет агент агенту. Смешивать нельзя в обе стороны.</strong></p> <h2 id="почему-нельзя-одним-текстом">Почему нельзя одним текстом</h2> <p>Документ, адресованный сразу двоим, не служит никому. Человеку мешает машинная плотность: списки команд, инварианты, запреты без объяснений. Исполнителю мешает всё остальное: вводные, причины, приглашения «почитать, чтобы проникнуться». В итоге каждый читает половину и пропускает важное.</p>https://beregov.me/ru/notes/capture-lessons-now/Mon, 28 Sep 2026 19:00:00 +0300https://beregov.me/ru/notes/capture-lessons-now/<p>Раньше я откладывал записи на потом: доделаю задачу — и запишу, что понял. Потом наступало «потом», и половина уже не вспоминалась. Особенно самое ценное: почему выбрали этот вариант, а не соседний.</p> <p>Теперь правило другое: <strong>родилось решение, урок, процедура или важный факт — записываю сразу</strong>, короткой заметкой в общую папку входящих, и продолжаю работу.</p> <h2 id="что-в-такой-заметке">Что в такой заметке</h2> <p>Всего несколько строк и четыре части:</p> <ul> <li><strong>Суть</strong> — что решили, что поняли, как делать;</li> <li><strong>Причины</strong> — почему так; это забывается быстрее всего;</li> <li><strong>Отвергнуто</strong> — какие были варианты и чем не подошли;</li> <li><strong>Открытое</strong> — что осталось непроверенным.</li> </ul> <p>Пустые части не пишу. Оформлять, выбирать вид, искать дубли в этот момент не нужно — это отдельная работа, и делает её не тот, кто записывает.</p>