Как дать агенту программирования исполнимую спецификацию

Агенты программирования лучше работают, когда успех можно наблюдать. Microsoft описывает spec-driven development с живой версионной спецификацией, синхронизированной с кодом и тестами.

1. Сначала опишите результат

Начните с пользователя и видимого поведения.

Goal: A signed-in learner can resume the lesson they started most recently.

User-visible behavior:
- The dashboard shows the most recently started lesson.
- Selecting it opens the lesson at the next incomplete step.
- A learner with no progress sees the existing “Start learning” action.

2. Определите критерии приёмки

Включите обычный путь, пустые состояния, неверный ввод, права и ошибки.

Acceptance criteria:
- A learner sees only their own progress.
- Missing progress does not cause a request or render error.
- A completed lesson points to the next lesson, or to the completion state.
- The existing dashboard remains unchanged for signed-out visitors.
- Automated tests cover the resume, empty, and unauthorized cases.

3. Сначала исследование, потом план

Попросите агента найти маршруты, компоненты, доступ к данным и тесты, а затем показать план и неопределённости. Проверьте сохранение существующих контрактов.

4. Сделайте спецификацию исполнимой

Храните её в версионном документе или issue, который команда действительно обновляет, и свяжите каждый критерий с тестом или ручной проверкой.

5. Оставьте человеческий контроль

Sources: Microsoft on spec-driven development, Build with agents in VS Code, and VS Code trust and safety.

6. Обновляйте

Спецификация не является одноразовым prompt. Обновляйте её при изменениях тестов или продукта и требуйте доказательства каждого критерия.