О чём доклад

• SDD: намерение — из чата в репозиторий
• Где спасает — и где 1300 строк ради одной даты
• Плюсы и минусы 50/50, без вердикта «внедряйте»

О чём поговорим?

1. 01Боль агентского кодинга
2. 02Plan mode — первая попытка
3. 03Где plan mode заканчивается
4. 04SDD и OpenSpec
5. 05Почему SDD плох
6. 06Регулятор церемонии

Знакомая сцена

• Вчера вы час объясняли агенту архитектуру аутентификации
• Сегодня он предлагает ровно тот подход, который вы отвергли
• Проблема не в модели — в архитектуре процесса

Диагноз: моста нет

Три сбоя по именам

Ростом окна это не лечится

Деградация внимания к середине контекста — свойство трансформера, а не баг.

Нужна внешняя память о намерении

Первое, что попробовала индустрия, — plan mode.

О чём поговорим?

• Боль агентского кодинга
• Plan mode — первая попытка
• Где plan mode заканчивается
• SDD и OpenSpec
• Почему SDD плох
• Регулятор церемонии

Что это механически

• Агент читает, ищет, думает вслух
• Писать не может — ограничение и есть вся магия
• На выходе — план, который ревьюите вы

Explore → Plan → Implement

Выигрыш когнитивный, не технический

Бонусы и правило одного предложения

• Контекст, набранный на планировании, уже загружен — реализация идёт точнее
• Отклонили план — выбросили дёшево: правок ещё нет
• Можешь описать диф одной фразой — не планируй. Не можешь — планируй

Для 80% задач этого достаточно

Дальше — про оставшиеся 20%.

О чём поговорим?

• Боль агентского кодинга
• Plan mode — первая попытка
• Где plan mode заканчивается
• SDD и OpenSpec
• Почему SDD плох
• Регулятор церемонии

План — артефакт одной сессии

Четыре стены

Заметка, а не контракт

OpenSpec: «plan mode отлично работает для одной сессии — мы делаем планы, которые живут через много»

Вынеси намерение туда, где живёт всё, что переживает сессии — в репозиторий, под git

О чём поговорим?

• Боль агентского кодинга
• Plan mode — первая попытка
• Где plan mode заканчивается
• SDD и OpenSpec
• Почему SDD плох
• Регулятор церемонии

Определение без пафоса

• Спецификация — версионируемый первичный артефакт
• Код — производная от неё
• Это не документ для людей — это вход для агента

Идея старая — инструменты новые

Ландшафт одним слайдом

Герой доклада: OpenSpec

• Fission-AI · YC W26 · MIT · npm
• Без API-ключей и без MCP — работает поверх любого агента
• Позиционирует себя дословно: «plan mode для сложных фич»

Две папки — вся модель

openspec/
├── specs/                  # истина: как система ведёт себя СЕЙЧАС
│   ├── auth/spec.md
│   └── payments/spec.md
└── changes/                # предложения: что мы МЕНЯЕМ
    ├── add-2fa/
    ├── rate-limit-api/
    └── archive/

→ specs — «как есть», changes — «как станет»

Change — самодостаточный пакет

changes/add-2fa/
├── proposal.md        # зачем и что — читает человек на ревью
├── design.md          # как — решения и трейдофы
├── tasks.md           # чеклист — по нему идёт агент
└── specs/
    └── auth/spec.md   # дельта требований, не копия спеки

Дельты вместо переписывания

## MODIFIED Requirements

### Requirement: User login
The system SHALL require a second factor
after password verification.

#### Scenario: Login with TOTP
- WHEN the password is correct
- THEN the system prompts for a TOTP code

## ADDED Requirements

### Requirement: Recovery codes
The system SHALL issue ten one-time recovery codes.

→ маркеры ADDED / MODIFIED / REMOVED — не нужно специфицировать всю систему заранее

Мост построен: цикл замкнулся

Что это даёт на ревью

Brownfield-first: спека растёт только там, где вы трогаете код. Ревьюишь намерение, а не диф.

О чём поговорим?

• Боль агентского кодинга
• Plan mode — первая попытка
• Где plan mode заканчивается
• SDD и OpenSpec
• Почему SDD плох
• Регулятор церемонии

Дальше — ровно столько же времени против

Иначе это была бы реклама, а не доклад.

Церемония не окупается на малом

«Это же водопад»

Ерет: SDD либо создаёт обучение, либо это водопад с большим счётом за токены. Разница — в вас, не в инструменте.

Сам термин размыт

• Böckeler: три инструмента под одной вывеской делают три разные вещи
• «Мы делаем SDD» — вы не знаете, что делает собеседник
• Thoughtworks Radar: Assess, не Adopt

Spec drift

Код ушёл вперёд — спека осталась.

• Агент компилирует устаревшее намерение
• Без проверки соответствия проблема невидима
• Лечение — CI-проверка спеки против кода, как у тестов

Spec sprawl

Спека разрослась больше кода.

• Её больше никто не читает
• Агент тонет в собственном контексте — привет, lost in the middle
• Лечение — дельты и архивация вместо одного вечно растущего документа

Спека не заставляет слушаться

Документированные drift-режимы агентов.

• Правила игнорируются на исполнении
• Забываются к середине сессии, отбрасываются как необязательные
• Спека — исходные данные, а не гарантия

Спека после кода

Главный анти-паттерн.

• Пишется задним числом как декорация для ревью
• Никого ни к чему не обязывает
• Дискредитирует весь процесс — лучше без спеки, чем с фальшивой

О чём поговорим?

• Боль агентского кодинга
• Plan mode — первая попытка
• Где plan mode заканчивается
• SDD и OpenSpec
• Почему SDD плох
• Регулятор церемонии

Не методология — регулятор

Тест на здоровье процесса

• Спека пишется после кода?
• Спеку никто не читает на ревью?
• Если да — вы делаете не SDD, а бюрократию

SDD не делает агента умнее. Он делает ваше намерение переживающим сессию

Иногда это ровно то, чего не хватало. А иногда — 1300 строк ради одной даты.