Media is too big
VIEW IN TELEGRAM
📹 README — это продукт. А вот проблема на числах.
Снял короткое видео на 2 минуты — про то, сколько стоит плохая документация. Без нытья, на числах.
Расчёты сделаны по публичным данным: Google Cloud DORA Report (2021, 2023), Stack Overflow Developer Survey, GetDX. Зарплаты — медиана Middle-разработчика по Хабр Карьере на 2026 год, Full Cost с учётом налогов и накладных.
Несколько фактов из видео:
— Команда 100 человек с плохой докой работает как 75. Потери — 124 млн ₽/год
— 62% разрабов тратят 30+ минут каждый день на поиск ответов в плохих доках
— 38% называют плохую документацию причиной увольнения
— Онбординг без доки — +2,5 месяца. Это 1 млн ₽ на каждого новичка
Полный разбор проблемы, решение по JTBD и готовый шаблон — в 👉 статье
В следующем видео — как улучшить документацию как продукт. Четыре потребителя, четыре документа, лестница вглубь.
👉 https://codemonsters.team/blog/2026/04/07/documentation-as-product-jtbd/
#rationaldev #codemonstersvlog
Снял короткое видео на 2 минуты — про то, сколько стоит плохая документация. Без нытья, на числах.
Расчёты сделаны по публичным данным: Google Cloud DORA Report (2021, 2023), Stack Overflow Developer Survey, GetDX. Зарплаты — медиана Middle-разработчика по Хабр Карьере на 2026 год, Full Cost с учётом налогов и накладных.
Несколько фактов из видео:
— Команда 100 человек с плохой докой работает как 75. Потери — 124 млн ₽/год
— 62% разрабов тратят 30+ минут каждый день на поиск ответов в плохих доках
— 38% называют плохую документацию причиной увольнения
— Онбординг без доки — +2,5 месяца. Это 1 млн ₽ на каждого новичка
Полный разбор проблемы, решение по JTBD и готовый шаблон — в 👉 статье
В следующем видео — как улучшить документацию как продукт. Четыре потребителя, четыре документа, лестница вглубь.
👉 https://codemonsters.team/blog/2026/04/07/documentation-as-product-jtbd/
#rationaldev #codemonstersvlog
👍3❤🔥2🥰2🍾1
Media is too big
VIEW IN TELEGRAM
💥🧠 README — это продукт. Часть 2: мышление
В первом видео побомбил числами. Во втором — как думать.
Проблема в том, что большинство README мы создаём не думая, на какую работу и кто нанимает нашу документацию.
Пишем «для всех» — получается ни для кого.
Или пишем только для одного. Или пишем чтобы отстал техлид на отвали.
У README минимум четыре клиента. Мы нашли создателя, потребителя, менеджера и ИИ-агента — но их наверняка больше. Зависит от контекста, компании, продукта.
Одним файлом четыре работы не закрыть — это как приготовить одно блюдо на ужин компании из вегана, мясоешки, аллергика и человека на диете с «оземпиком». Кто-то точно уйдёт голодным плюсом к диетчику.
Подход JTBD придумал Тони Ульвик после 10 лет в IBM.
3000+ успешных проектов.
Кристенсен популяризировал.
А я применил к документации с иишницей.
Если видишь пятого клиента — напиши в комменты, разберём.
Шестое чувство тоже можем обсудить в комментариях.
Статья с полным разбором, расчётами потерь и готовым шаблоном:
👉 https://codemonsters.team/blog/2026/04/07/documentation-as-product-jtbd/
#rationaldev #codemonstersvlog
В первом видео побомбил числами. Во втором — как думать.
Проблема в том, что большинство README мы создаём не думая, на какую работу и кто нанимает нашу документацию.
Пишем «для всех» — получается ни для кого.
Или пишем только для одного. Или пишем чтобы отстал техлид на отвали.
У README минимум четыре клиента. Мы нашли создателя, потребителя, менеджера и ИИ-агента — но их наверняка больше. Зависит от контекста, компании, продукта.
Одним файлом четыре работы не закрыть — это как приготовить одно блюдо на ужин компании из вегана, мясоешки, аллергика и человека на диете с «оземпиком». Кто-то точно уйдёт голодным плюсом к диетчику.
Подход JTBD придумал Тони Ульвик после 10 лет в IBM.
3000+ успешных проектов.
Кристенсен популяризировал.
А я применил к документации с иишницей.
Если видишь пятого клиента — напиши в комменты, разберём.
Шестое чувство тоже можем обсудить в комментариях.
Статья с полным разбором, расчётами потерь и готовым шаблоном:
👉 https://codemonsters.team/blog/2026/04/07/documentation-as-product-jtbd/
#rationaldev #codemonstersvlog
❤2🔥1
Спасибо, кремневый друг 🦾
(звучит как тост в мире, где вместо вина — термопастовый джин)
Написал SKILL для компонентных тестов совместно с Opus — для имплементации с Sonnet.
Получилось прекрасно. Без драм, без переписываний.🤫
Пока я пил кению, Sonnet написал тесты за 15 минут. Без ошибок.
Даже показалось, что он улыбнулся мне из терминала.
Или это был спам системных логов.
Параллельно накатал 4 статьи. Руки ещё не отвалились 😅
Теперь описываю SKILL для проектирования программы.
Чтобы вайб-кодер наконец овладел инженерным мастерством — на научных фактах и логике, а не на молитвах перед деплоем. 🙏🤖
Дальше — SKILL для имплементации с sonnet.
Как прогоню, протестирую и подниму одно API — вернусь с обзором и короткими статьями.
Не могу остановиться. Кофеин и нейросети — опасная компания. 🚀
Фигачим, фигачим
#rationaldev #codemonsterslog
(звучит как тост в мире, где вместо вина — термопастовый джин)
Написал SKILL для компонентных тестов совместно с Opus — для имплементации с Sonnet.
Получилось прекрасно. Без драм, без переписываний.🤫
Пока я пил кению, Sonnet написал тесты за 15 минут. Без ошибок.
Даже показалось, что он улыбнулся мне из терминала.
Или это был спам системных логов.
Параллельно накатал 4 статьи. Руки ещё не отвалились 😅
Теперь описываю SKILL для проектирования программы.
Чтобы вайб-кодер наконец овладел инженерным мастерством — на научных фактах и логике, а не на молитвах перед деплоем. 🙏🤖
Дальше — SKILL для имплементации с sonnet.
Как прогоню, протестирую и подниму одно API — вернусь с обзором и короткими статьями.
Не могу остановиться. Кофеин и нейросети — опасная компания. 🚀
Фигачим, фигачим
#rationaldev #codemonsterslog
🔥4🤣3👏2
Оттачиваем Скиллы 🧘Сводка с полей.
первый эндпоинт по спецификации готов, скилл реализации доработал по ходу — 15 минут.
2 эндпоинт. Запустил в реализацию чтобы без вопросов пилил соннет. Sonnet реализовал, смэтчил с компонентными тестами (fka интеграционными) на спецификацию — 25 минут.
3 эндпоинт выявил недостатки в скиллах. Опус промазал по скиллу проектирования модулей с I/O. Второй раз на тех же граблях 🙃. Поправил скилл проектирования и скилл реализации. Прогнал ревью по обновлённым.
4 эндпоинт спроектировал прекрасно и соннет реализовал без ошибок.
Автомат работает.
Реализация обошлась в $3.72, API 14m 26s, wall 21m 50s ⏱️.
Чувство двойное — восхищение и тихая грусть. Я передал машине свой опыт, свой способ думать о проектировании и реализации. И теперь это работает уже без меня.
Без моков. Без лишних строк кода. Без токенов в трубу.
Где Опус споткнулся
Промашка 1 — проектирование. Скопировал форму из карточек S1/S2, написанных до того, как правило закрепили в скилле. Старый артефакт лежал ближе в контексте — машина потянулась за ним, а не за правилом.
Это так человечно - посмотреть на пример рядом и сделать по-старому.
Промашка 2 — реализация. Спрашиваю: что с компонентными тестами? Не прогнал. Остановился на go test и go build, до конца чек-листа DoD не дошёл 🪜.
Перевожу с машинного: без жёсткого скилла модель срезает углы там, где живой инженер по привычке дошёл бы до конца.
Еще раз. 4 прогон проектирования и реализации эндпоинта меня порадовал своей лаконичностью и скоростью.
Почему это важно
Если в легаси оставлены ошибки — на следующем шаге они копируются. И ещё. И ещё. Ком растёт. Раньше это копили медленно, поколениями джунов. Теперь — ИИ-агент со скоростью генерации токенов 📣.
А потом ко мне приходят инженеры:
— Макс, ты нас учишь проектировать так, а почему там и здесь совсем не так?
Ответ очевиден 🤐
Скилл — не магия. Это дисциплина. Чёткий вход, чёткий выход, чёткая ответственность. Модель работает быстро, потому что не гадает по контексту, как по кофейной гуще.
Итог недели
Ушёл в терминал. Claude Code, голый CLI. Ревью — там же, без панелек и свистелок 🖥️.
Рефакторинг по итогам ревью обошелся — $1.15 💸.
Улучшение стоит дешевле чашки кофе.
Био-инженер — умей проектировать, пожалуйста. От этого польза тебе и индустрии🙏
😎 Улучшаю то, что могу, что рядом, на что влияю.
По одному скиллу, по одной карточке, по одному эндпоинту, по одному инженеру.
Скиллы работают всё лучше. Остановиться невозможно 🚀
Качество кода — ✅
Качество проектирования — ✅
Скорость — выросла.
Сеть не спит. Глубина не спит
#retionaldev #codemonsterslogs
первый эндпоинт по спецификации готов, скилл реализации доработал по ходу — 15 минут.
2 эндпоинт. Запустил в реализацию чтобы без вопросов пилил соннет. Sonnet реализовал, смэтчил с компонентными тестами (fka интеграционными) на спецификацию — 25 минут.
3 эндпоинт выявил недостатки в скиллах. Опус промазал по скиллу проектирования модулей с I/O. Второй раз на тех же граблях 🙃. Поправил скилл проектирования и скилл реализации. Прогнал ревью по обновлённым.
4 эндпоинт спроектировал прекрасно и соннет реализовал без ошибок.
Автомат работает.
Реализация обошлась в $3.72, API 14m 26s, wall 21m 50s ⏱️.
Чувство двойное — восхищение и тихая грусть. Я передал машине свой опыт, свой способ думать о проектировании и реализации. И теперь это работает уже без меня.
Без моков. Без лишних строк кода. Без токенов в трубу.
Где Опус споткнулся
Промашка 1 — проектирование. Скопировал форму из карточек S1/S2, написанных до того, как правило закрепили в скилле. Старый артефакт лежал ближе в контексте — машина потянулась за ним, а не за правилом.
Это так человечно - посмотреть на пример рядом и сделать по-старому.
«Я взял S2 как шаблон формы, а не как „вот так раньше делали — теперь делаем правильно“. Машина следует более ранним артефактам, а не более поздним правилам, потому что артефакт читается ближе к моменту проектирования и весит больше в контексте.»
Промашка 2 — реализация. Спрашиваю: что с компонентными тестами? Не прогнал. Остановился на go test и go build, до конца чек-листа DoD не дошёл 🪜.
«DoD явно содержит run-tests.sh healthy — я его прочитал, но остановился раньше. Это невнимательность, не техническое ограничение.»
Перевожу с машинного: без жёсткого скилла модель срезает углы там, где живой инженер по привычке дошёл бы до конца.
Еще раз. 4 прогон проектирования и реализации эндпоинта меня порадовал своей лаконичностью и скоростью.
Почему это важно
Если в легаси оставлены ошибки — на следующем шаге они копируются. И ещё. И ещё. Ком растёт. Раньше это копили медленно, поколениями джунов. Теперь — ИИ-агент со скоростью генерации токенов 📣.
А потом ко мне приходят инженеры:
— Макс, ты нас учишь проектировать так, а почему там и здесь совсем не так?
Ответ очевиден 🤐
Скилл — не магия. Это дисциплина. Чёткий вход, чёткий выход, чёткая ответственность. Модель работает быстро, потому что не гадает по контексту, как по кофейной гуще.
Итог недели
Ушёл в терминал. Claude Code, голый CLI. Ревью — там же, без панелек и свистелок 🖥️.
Рефакторинг по итогам ревью обошелся — $1.15 💸.
Улучшение стоит дешевле чашки кофе.
Био-инженер — умей проектировать, пожалуйста. От этого польза тебе и индустрии
😎 Улучшаю то, что могу, что рядом, на что влияю.
По одному скиллу, по одной карточке, по одному эндпоинту, по одному инженеру.
Скиллы работают всё лучше. Остановиться невозможно 🚀
Качество кода — ✅
Качество проектирования — ✅
Скорость — выросла.
Сеть не спит. Глубина не спит
#retionaldev #codemonsterslogs
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥3❤2
Привет!
В 13:05 расскажу про рациональную разработку на ГПБ Конф будет интересно.
Регистрация по⚡ ссылке
Приходи🤝 пообщаемся)
📍 Площадка: Connect University, 5-й Донской пр., 17
💙 День конференции: 14 мая
Начало регистрации на мероприятии в 10:30
⚡ мой слот в программе в малом зале: 13:30 — 14:00
#codemonstersvlog
В 13:05 расскажу про рациональную разработку на ГПБ Конф будет интересно.
Регистрация по
Приходи🤝 пообщаемся)
Начало регистрации на мероприятии в 10:30
#codemonstersvlog
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥6
codemonsters.log
Привет! В 13:05 расскажу про рациональную разработку на ГПБ Конф будет интересно. Регистрация по ⚡ ссылке Приходи🤝 пообщаемся) 📍 Площадка: Connect University, 5-й Донской пр., 17 💙 День конференции: 14 мая Начало регистрации на мероприятии в 10:30 ⚡ мой…
Книги, о которых рассказывал — раритет. Их почти не купить. Поэтому я всю дисциплину вынес в статьи.
https://codemonsters.team/blog/
Разобрал, проверил на практике, описал — чтобы вам упростить жизнь. Приеду домой, достану из чемодана — выложу фотки.
#codemonstersvlog
https://codemonsters.team/blog/
Разобрал, проверил на практике, описал — чтобы вам упростить жизнь. Приеду домой, достану из чемодана — выложу фотки.
#codemonstersvlog
🔥7
Как и обещал фото книг.
Книги, о которых рассказывал — раритет. Их почти не купить.
Поэтому я всю дисциплину вынес в статьи.
https://codemonsters.team/blog/
+ записываю короткие видосики про дисциплину.
Разобрал, проверил на практике, описал — чтобы вам упростить жизнь.
#codemonstersvlog
Книги, о которых рассказывал — раритет. Их почти не купить.
Поэтому я всю дисциплину вынес в статьи.
https://codemonsters.team/blog/
+ записываю короткие видосики про дисциплину.
Разобрал, проверил на практике, описал — чтобы вам упростить жизнь.
#codemonstersvlog
🔥9
Media is too big
VIEW IN TELEGRAM
🎬 README — это продукт. Часть 3: что получилось
В первом видео — числа. Во втором — мышление.
В третьем — конкретика.
Взял Claude Opus, написал промпт с концепцией JTBD, улучшил шаблон документации. Claude Sonnet в терминале разложил всё по файлам. Пинки и Брейн.
Три вещи, на которые стоит обратить внимание:
Pipe-формат API — четыре строки, и ты понимаешь как работает эндпоинт. Без головной боли.
Навык для инженера и машины: объяснить поток данных на пальцах.
Лестница вглубь — README → тесты → architecture → ADR → contributing. Каждый уровень — отдельный файл. Читатель сам решает, где ему остановиться.
Карта файлов — каждый документ знает своего клиента.
README — инженерам.
AGENTS.md — агенту.
Concept — менеджеру, инженеру. Каждый находят своё.
Шаблон сервиса:
👉 https://github.com/ubik-life/service-template
README сервиса авторизации (живой пример):
👉 https://github.com/ubik-life/passkey-demo-api
Платформа Ubik — описание всей системы:
👉 https://github.com/ubik-life/concept
Статья с полным разбором и расчётами потерь:
👉 https://codemonsters.team/blog/2026/04/07/documentation-as-product-jtbd/
#rationaldev #codemonstersvlog
В первом видео — числа. Во втором — мышление.
В третьем — конкретика.
Взял Claude Opus, написал промпт с концепцией JTBD, улучшил шаблон документации. Claude Sonnet в терминале разложил всё по файлам. Пинки и Брейн.
Три вещи, на которые стоит обратить внимание:
Pipe-формат API — четыре строки, и ты понимаешь как работает эндпоинт. Без головной боли.
Навык для инженера и машины: объяснить поток данных на пальцах.
Лестница вглубь — README → тесты → architecture → ADR → contributing. Каждый уровень — отдельный файл. Читатель сам решает, где ему остановиться.
Карта файлов — каждый документ знает своего клиента.
README — инженерам.
AGENTS.md — агенту.
Concept — менеджеру, инженеру. Каждый находят своё.
Шаблон сервиса:
👉 https://github.com/ubik-life/service-template
README сервиса авторизации (живой пример):
👉 https://github.com/ubik-life/passkey-demo-api
Платформа Ubik — описание всей системы:
👉 https://github.com/ubik-life/concept
Статья с полным разбором и расчётами потерь:
👉 https://codemonsters.team/blog/2026/04/07/documentation-as-product-jtbd/
#rationaldev #codemonstersvlog