From 6baba21f066e228b64edc5752de3352df17466ec Mon Sep 17 00:00:00 2001 From: Oleg Proskurin Date: Tue, 10 Feb 2026 22:40:36 +0700 Subject: [PATCH] add file --- assets/beyond-vibe-coding/sdd-vs-vibe.md | 266 +++++++++++++++++++++++ 1 file changed, 266 insertions(+) create mode 100644 assets/beyond-vibe-coding/sdd-vs-vibe.md diff --git a/assets/beyond-vibe-coding/sdd-vs-vibe.md b/assets/beyond-vibe-coding/sdd-vs-vibe.md new file mode 100644 index 0000000..e99e841 --- /dev/null +++ b/assets/beyond-vibe-coding/sdd-vs-vibe.md @@ -0,0 +1,266 @@ +# Spec-Driven Development: Решение проблем Vibe Coding + +## Определение SDD + +Spec-Driven Development — методология AI-разработки, где детальные спецификации создаются до написания кода и служат единственным источником истины для AI-агентов. Workflow: Constitution → Requirements → Design → Tasks → Implementation. + +## Проблемы Vibe Coding и решения через SDD + +### 1. Context Amnesia +**Проблема Vibe**: Потеря контекста после ~30 промптов, 40-60% времени на повторное объяснение контекста. +**Решение SDD**: Спецификации как persistent storage контекста. Контекст доставляется один раз, 80%+ успех с первой попытки. + +### 2. Production Readiness +**Проблема Vibe**: +- Только 9% разработчиков готовы деплоить vibe-код в production +- 63% тратят БОЛЬШЕ времени на дебаг AI-кода +- 68% тратят БОЛЬШЕ времени на устранение уязвимостей +- 170/1,645 приложений Lovable имели security vulnerabilities + +**Решение SDD**: +- 65%+ confidence для production deployment +- Testability: 4-5/5 vs 2-4/5 у vibe +- Scalability: 4/5 vs 2-3/5 у vibe +- Diagnosability: 4/5 vs 2/5 у vibe + +### 3. Intent-to-Implementation Deviation +**Проблема Vibe**: Накопление отклонений от изначального намерения с каждой итерацией. Кодовая база дрейфует. +**Решение SDD**: Спецификация как source of truth фиксирует намерение. Каждая итерация валидируется против spec. + +### 4. Team Collaboration +**Проблема Vibe**: Вся история в chat logs, невозможность onboarding новых членов команды. +**Решение SDD**: +- Specs в version control (git) +- Документированные решения и обоснования +- Onboarding новых членов за минуты vs часы/дни + +### 5. Maintainability +**Проблема Vibe**: +- Отсутствие документации +- Зависимость от AI для каждого технического вызова +- "Создает разработчиков, которые не способны заниматься maintenance" + +**Решение SDD**: +- Specs как живая документация +- Maintainability score: 4/5 vs 2-3/5 у vibe +- Четкая структура для code review + +### 6. Скорость vs Качество +**Проблема Vibe**: 19% МЕДЛЕННЕЕ реально, хотя ощущается 20% быстрее (METR study). +**Решение SDD**: Медленнее upfront, но минимум rework. Общий cycle time короче для production-ready кода. + +## Статистика использования SDD + +### Adoption Rate +- **84%** разработчиков используют AI-инструменты (общий рынок) +- **~60-70%** переходят на гибридный подход Vibe+SDD после 6+ месяцев +- **~20-25%** внедрили полностью SDD-workflow для всех production-задач +- **20-50%** кода в Robinhood и Microsoft генерируется через SDD-подходы + +### Timeline и Tools +- **Сентябрь 2025**: Запуск GitHub Spec-Kit (open source) +- **Июль 2025**: Запуск AWS Kiro IDE +- **2025**: SDD становится key engineering practice (Thoughtworks Technology Radar) + +### Распределение по опыту +- **Senior (10+ лет)**: Преимущественно используют SDD для production, 81% productivity gain +- **Mid-level (3-10 лет)**: Смешанное использование, переход на SDD для сложных проектов +- **Junior (0-3 лет)**: Редко используют SDD из-за сложности написания качественных specs + +### Industry Adoption +- Tech Startups: 73% adoption AI-tools (часть через SDD) +- Digital Agencies: 61% +- E-commerce: 57% + +## Достоинства перехода Vibe → SDD + +### Количественные метрики + +| Метрика | Vibe Coding | SDD | Улучшение | +|---------|-------------|-----|-----------| +| Production Confidence | 9% | 65%+ | +622% | +| Context Re-explanation Time | 40-60% | <10% | -80% | +| First-try Success Rate | ~40% | 80%+ | +100% | +| Testability | 2-4/5 | 4-5/5 | +50% | +| Maintainability | 2-3/5 | 4/5 | +60% | +| Diagnosability | 2/5 | 4/5 | +100% | +| Team Onboarding Time | Часы/дни | Минуты | -90% | + +### Качественные преимущества + +**1. Улучшенная переиспользуемость** +- Research logs и specs документируют решения +- Снижение дублирования кода +- Knowledge base для команды + +**2. Минимизация потери контекста** +- Git-committed specs сохраняют всю историю +- Не зависит от chat history limits +- Specs переживают AI sessions + +**3. Упрощенный code review** +- Валидация против specs +- Четкие acceptance criteria +- Автоматизированные проверки соответствия + +**4. Predictable outcomes** +- Specs определяют "done" +- Минимум неопределенности +- Ясные expectations для AI + +**5. Scalable architecture** +- Specs форсируют думать о структуре +- Architectural decisions документируются +- Prevents ad-hoc solutions + +### Экономические преимущества + +**Снижение costs**: +- Меньше времени на rework (40-60% → <10%) +- Меньше debugging time (63% excess → minimal) +- Меньше security vulnerabilities (68% excess time → early detection) + +**Увеличение velocity**: +- Быстрее onboarding ($X/hour * hours saved) +- Параллельная работа команды (specs как contract) +- Reusable specs для похожих features + +## SDD Tooling Ecosystem + +### Major Platforms + +**1. GitHub Spec-Kit** (сентябрь 2025) +- CLI + templates +- Commands: `/constitution`, `/specify`, `/plan`, `/tasks`, `/implement` +- Интеграция: Cursor, Copilot, Claude Code, Windsurf +- Open source, активное community + +**2. AWS Kiro** (июль 2025) +- Dedicated IDE (VS Code fork) +- Spec Mode + Vibe Mode +- Files: `requirements.md`, `design.md`, `tasks.md` +- Context management через structured files + +**3. OpenSpec** +- Lightweight alternative +- Markdown-based +- Files: `proposal.md`, `specs/*.md`, `tasks.md`, `design.md` + +**4. Better Spec** +- AI-powered spec generation +- Hot module replacement +- Multi-model support (Claude, GPT-4, Gemini, local) + +**5. APM (Windsurf)** +- Multi-agent система +- File-based memory +- CLI workflows + +### Agent Integration + +**Claude Code** +- Custom slash commands (`.claudecode/`) +- `CLAUDE.md` constitution +- Task spawning, planning mode + +**Cursor** +- Composer Workspace +- Agent Mode +- Spec-kit integration via custom commands +- `.cursorrules` customization + +**Windsurf** +- Cascade context system +- APM framework +- Multi-model support + +**VS Code + GitHub Copilot** +- Custom instructions via markdown +- Spec templates auto-completion +- API contract generation (OpenAPI/Swagger) + +**Rovo (Atlassian)** +- Integrated spec management +- Jira synchronization +- Team collaboration features + +### Common Workflow + +``` +1. /constitution → project principles & constraints +2. /specify → user stories & requirements +3. /plan → technical design & architecture +4. /tasks → granular task breakdown +5. /implement → code generation against specs +6. Iterate: /clarify для edge cases +``` + +## Use Cases для SDD + +### Оптимально +- Production systems для customers +- Enterprise applications с compliance +- Team collaboration (>2 developers) +- Long-lived codebases +- Complex architectures (microservices) +- Mission-critical systems + +### Не оптимально +- Disposable prototypes +- Solo pet projects без maintenance +- Сверх-простые скрипты +- High uncertainty exploration phase + +## Hybrid Approach: Лучшая практика + +**Рекомендованная стратегия** (60-70% developers): + +1. **Exploration (Phase 0)**: Vibe coding для PoC (1-3 дня) +2. **Development (Phase 1-N)**: SDD для core features при validation идеи +3. **Maintenance**: SDD для features, vibe для minor fixes + +**Ключевой принцип**: "Vibe coding — как вы исследуете AI. Spec-Driven Development — как вы выпускаете продукт с AI." + +## Key Insights + +### Паттерны переходов +- **Vibe → SDD**: Доминирующий паттерн (~70% после 6+ мес) +- **Триггеры перехода**: Барьер ~30 промптов, production requirements, team growth +- **Spec → Vibe**: Практически не встречается + +### По типам задач +SDD особенно эффективен для: +- Complex business logic (34% AI gain без SDD) +- Security-critical code (12% AI gain без SDD) +- Multi-service architectures +- Long-term projects (>3 months) + +### Эволюция подхода +- 2024-early 2025: Vibe coding доминирует +- Mid-2025: SDD tools запускаются (Kiro, Spec-Kit) +- Late 2025-2026: Hybrid становится стандартом +- Future: Спецификации как executable artifacts + +## Цитаты экспертов + +**На тему production-готовности**: +"Production-grade качество требует преднамеренного надзора. Testability, maintainability, scalability заметно улучшились, когда были усилены через промпты, тестовые стратегии и ревью." — Thoughtworks + +**На тему context management**: +"Pure vibe coding: 40-60% времени на повторное объяснение контекста. Spec-Driven: Контекст доставлен один раз, 80%+ первоначальный успех." + +**На тему философии**: +"Vibe coding принимает отклонение как стоимость скорости. SDD минимизирует отклонение через upfront structure." + +## Источники + +- GitHub Spec-Kit documentation & repository (2025-09) +- AWS Kiro launch materials (2025-07) +- Thoughtworks Technology Radar 2025 +- RedMonk developer surveys (2025) +- Visual Development Survey 2025 +- Reddit communities: r/ClaudeCode, r/ChatGPTCoding, r/windsurf +- Business Insider: 167 developers survey (2026-01) +- METR study on AI coding performance +- Second Talent: Vibe Coding Statistics 2026 +- Lovable vulnerability analysis (170/1,645 apps)