Ко всем записям

claude.md как список багфиксов

Три правила вайбкодинга: чистая база, файл правил вместо банальностей и spec-driven разработка. И почему нейрослоп приятно удалять.

Прошлые попытки вайбкодить в Godot у меня были довольно печальные. Нейронки могли поправить что-то в скриптах, но синтаксис сцен, автолоады и прочее модели знали плохо. Поэтому в основном я делал всё руками.

С моделью Opus 4.6 получается куда лучше накидывать прототипчики игр. Понятное дело, код написан как попало, в нём туча багов, сложные кейсы модель делает хуёво. Но главное — она позволяет проверить идею и посмотреть её в динамике.

И это дорогого стоит.

Почему нейрокод проще удалять

Раньше процесс был такой. Пришла идея — сажусь кодить. Плохо кодить не могу, стараюсь, чтобы всё было разбито на модули, чтобы код эстетически нравился. Это занимает время.

Потом смотрю на всё это и понимаю, что идея была так себе. Но удалить жалко, потому что sunk cost. Я в этот код столько сил вложил, как можно взять и удалить? Извините, это же шедевр искусства, он останется тут навсегда.

С нейрокодом ситуация другая. Душа радуется, когда удаляю нейрослоп. Если фича получилась хреновая, удаляем всё и пишем заново, никаких сожалений. Только радость, будто порядок навёл и сидишь довольный в чистоте.

Это позволяет быстро итерироваться и откидывать хуёвые варианты. А другого способа сделать хорошо, кроме как сначала сделать кучу раз плохо, видимо, не существует.

Правило первое: не начинайте с пустого проекта

Проект не должен быть пустым. В нём должна быть какая-то база, причём код должен быть такой, чтобы не стыдно друзьям показать.

Нейронка сейчас как джун: тупо копипастит все куски, которые видит. Поэтому если что-то плохо написано, это будет размножено многократно. Мыслить нейронка не умеет, для неё что твоя инструкция, что код из рандомного файла имеют одинаковый вес. Так что можно хоть десять раз прописать в промпте правило: если есть файлы, где оно нарушается, то правило пойдёт нахуй довольно быстро.

Правило второе: claude.md — это список багфиксов

Накидайте claude.md с описанием хороших и плохих паттернов. Но избегайте банальных фраз типа «пиши хорошо, плохо не пиши» и «будь сеньор-девелопером». Это нихуя не работает.

Относитесь к этому файлу как к списку багфиксов. Каждая запись должна фиксить какое-то поведение модели. Если надоело писать однотипные комментарии — значит, самое время внести это в claude.md.

Мне нравится формат с good и bad примерами. Нейронка такое хорошо понимает и меньше тупит.

У себя я так за три месяца поднял качество работы Claude примерно на 30–40%. Не потому, что нашёл волшебный промпт, а потому что каждый раз, когда мне в десятый раз приходилось объяснять один и тот же косяк, я шёл и писал новое правило.

Правило третье: спека для непонятных задач

Если фича большая и вы не знаете, как её толком делать, используйте spec-driven development. Плагинов полно, я юзаю Obra Superpowers.

Суть примерно одна: плагин запрещает модели сразу бросаться в бой. Вместо этого она минут 15 пытает тебя вопросами. Потом даёт вычитать мини-спеку, потом большую спеку, а потом ещё план реализации.

Занимает дохуя времени и жрёт тонну токенов. Но для задач, где ты сам слабо понимаешь, что делать, работает неплохо. Для задач, где всё понятно, использовать не стоит. И без подписки за сто баксов вы даже первый этап вопросов не пройдёте: токены кончатся раньше.

Что в итоге

Вайбкодинг — это не «нажал кнопку и получил продукт». Это режим, в котором ты быстрее проверяешь идеи и меньше жалеешь удалять плохие варианты.

Но качество всё ещё зависит от того, насколько чистая у тебя база и насколько честно ты записываешь правила. Если пустить всё на самотёк, получится не x10, а десять джунов, которые пишут код одновременно и не разговаривают друг с другом.

А если относиться к claude.md как к живому списку багфиксов, то через пару месяцев это начинает окупаться. Проверено на себе, пусть и без контрольной группы.