add file

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)