Достаточно ли новых навыков разработчиков для успешной разработки ИИ решений? Нет, недостаточно. Внедрение ИИ, или даже трансформация в AI native — это не просто еще один инструмент в арсенале команды. Это культурный сдвиг в подходе к разработке, особенно в том, как мы документируем и организуем архитектурные решения.

В классической разработке исполняемым компьютером является только код.🧑‍💻 От его качества зависит результат, что неизбежно создает возможность оставить западающие области в производственном цикле. Самые очевидные из них — документация и архитектурные описания. Технические писатели и архитекторы, какими бы опытными они ни были, часто отстают от темпа работы разработчиков. История знакома всем: разработали, протестировали (как смогли), развернули (как договорились), работает — отлично, документацию доделаем позже. Но с 🤖 эта схема не работает. При интеграции ИИ в разработку нужно общаться с ним по правилу “мусор на входе — мусор на выходе”. Это означает, что ИИ нужна полная и структурированная информация о проекте: документация, архитектура, стандарты. Если этой информации нет или она неполная, результаты будут неудовлетворительными.💀 Две практики, которые стоит внедрить для повышения эффективности работы ИИ:

1. DocAsCode — документация как исходный код Документацию нужно рассматривать как часть кодовой базы: • Писать в текстовых форматах (Markdown, reStructuredText), а не в бинарных (Word, PDF) • Хранить в системе контроля версий (Git) вместе с кодом или рядом с ним • Проводить код-ревью через pull/merge requests • Автоматизировать сборку через CI/CD пайплайны • Добавлять автоматизированные тесты на качество 2. ArchAsCode — архитектура как исходный код Архитектурные решения, диаграммы и стандарты описываются через декларативные языки разметки, что позволяет: • Верифицировать решения на соответствие установленным правилам • Генерировать артефакты автоматически • Развертывать инфраструктуру как код • Тестировать архитектурные ограничения • Версионировать все изменения Это логическое развитие после Infrastructure as Code (IaC) — от автоматизации инфраструктуры к автоматизации самих архитектурных решений.

Будем разбирать в деталях?