Документация и ИИ

Документация и ИИ

Никогда я не была таким фанатом документации как во время индивидуального проекта разработки с claude code)

Во время традиционной разработки с командой, где есть аналитик, разработка, тестирование, сложно и, как будто, не всегда нужно, обновлять документацию после каждой задачи, по разным причинам: 1. продукты делаются «с колес» или просто быстро развиваются (и меняются) 2. численность команды такова, что лишних рук никогда не хватает 3. в задачах на разработку есть описания и схемы, поэтому в случае необходимости всегда можно посмотреть в них 4. по составу и описанию релиза тоже можно понять, когда и что менялось

Но при разработке в одиночку с ИИ процесс выглядит совсем по другому. Уже через 6-7 пул реквестов я поняла, что без обновления документации после каждого изменения просто невозможно – изменений очень много, они быстрые, и вне зависимости от сложности, ты просто физически не можешь держать в голове все взаимосвязи.

Так что «по итогам обнови документацию» теперь один из постоянных пунктов промпта. А еще у меня есть: · pull_request_template · documentation_guidelines · чек-лист перед мержем в общем, настоящий процесс)   Это лишь один из примеров того, о чем пишут во всех отчетах: при внедрении ИИ очень важно переосмысливать процессы.