Большинство README в ИТ выглядят так:
«TODO»
Всё.
Инженер написал код. Сдал. Ушёл.
А следующий человек — открывает репо и видит pzdc .
Я строю с тобой Passkey Demo API. Авторизация без паролей — биометрия, WebAuthn, JWT.
И я фиксирую всё: промпты, решения, альтернативы.
Не потому что так принято.
А потому что любой сможет пройти этот же путь — шаг за шагом.
Документация — это не артефакт. Это продукт.
Если ты не можешь объяснить что ты построил — ты ничего не построил.📝

Описание идеи на GitHub
Ссылка на первую инструкцию

#rationaldev #codemonstersvlog

Оттачиваем Скиллы 🧘Сводка с полей.

первый эндпоинт по спецификации готов, скилл реализации доработал по ходу — 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