Код дешев. Спецификация — это актив.
Код становится дешевым артефактом. Настоящая ценность теперь заключается в спецификации.
Я трачу меньше времени на написание планов реализации вручную. Я трачу больше времени на проектирование. ИИ делает это возможным. Он не заменяет инженерное суждение, он меняет то, где вы его применяете.
Я позволяю ИИ составлять черновики спецификаций и кода. Моя работа теперь заключается в определении намерений и выявлении ограничений. Написание текста — наименее ценная часть процесса.
Мои спецификации предназначены не для людей, читающих вики, а для следующей сессии ИИ. Они должны позволять ИИ продолжать работу без новых объяснений.
Эффективные спецификации фокусируются на:
- Требованиях
- Ограничениях
- Критериях приемки
- Шагах верификации
Они созданы для исполнения, а не просто для чтения. Аудитория — это следующий участник процесса, будь то человек или ИИ-агент.
Современное проектирование — это задача управления ограничениями. ИИ хорошо работает с ограничениями, если вы четко их фиксируете. Мой рабочий процесс проходит через следующие этапы: Намерение → Спецификация ИИ → Проверка человеком → План реализации ИИ → Проверка человеком → Генерация кода ИИ → Тестирование
Я задаю цель, требования и границы. ИИ составляет черновик спецификации. Я проверяю его. ИИ составляет план. Я проверяю его. Только после этого мы генерируем код.
Я пишу меньше, но проверяю тщательнее. Именно в этом сохраняется инженерная ценность.
Хорошая спецификация определяет, что должно быть истинным, а не то, как этого добиться. Например, спецификация рефакторинга должна гласить:
- Ни один класс в слое приложения не может ссылаться на реализации DAO.
- Критерии приемки: нарушения слоев возвращают ноль совпадений при поиске.
Самая важная задача — выявление несущих ограничений. Это критические правила, такие как:
- Стратегии инициализации базы данных
- Модели развертывания
- Границы интеграции
Если вы их упустите, система сломается.
Сессии ИИ временны. Они приходят и уходят. Ценность же заключается в общей памяти:
- Спецификациях
- Планах реализации
- Записях об архитектурных решениях (ADRs)
- Конвенциях
Эта память предотвращает расхождение документации. Когда ваш README, код и ADR рассказывают разные истории, доверие теряется. Вы должны привести их в соответствие с реальностью.
Репозиторий должен отражать следующую структуру:
- CLAUDE.md: Рабочий процесс и контрольные точки проверки.
- status.md: Актуальный индекс всех спецификаций и планов.
- specs/: «что» и «почему».
- plan/: «как».
- rules/: Правила написания кода на уровне классов.
- docs/adr/: Неизменяемые записи о важных решениях.
ИИ может генерировать код. Он не может с уверенностью определить, какие ограничения важны для вашего бизнеса. Это ваша ответственность.
Создавайте исполняемые знания. Начинайте каждый проект с общей памяти, а не с чистого листа.
Источник: https://dev.to/daniel_wu_cac679a2760ba0a/the-code-is-cheap-artifact-now-the-spec-is-the-asset-3b02
Дополнительное обучающее сообщество: https://t.me/GyaanSetuAi