VibeCoderzVibeCoderz

Конспекты

Смарт-конспекты YouTube-видео — ключевые идеи и инсайты без необходимости смотреть часовые ролики

Все конспекты
📝 Конспект2026/03/19

GitHub SpecKit: Пошаговое руководство по Spec-Driven Development для вайбкодеров

Узнайте, как использовать GitHub SpecKit для структурированной разработки с AI. От спецификаций до реализации без галлюцинаций.

Содержание (5)+
📝

Смарт-конспект

🎯 О чём этот конспект: Разбор нового open-source фреймворка SpecKit от GitHub, который внедряет методологию Spec-Driven Development (разработка на основе спецификаций) в работу с AI-агентами. Вместо хаотичного промптинга («вайбкодинга»), SpecKit предлагает структурированный процесс из четырех фаз, превращая AI в дисциплинированного исполнителя.

👤 Кому будет полезно: Разработчикам и вайбкодерам, использующим Cursor, Claude Code или GitHub Copilot, которые сталкиваются с галлюцинациями AI и «кривым» кодом в больших проектах.

✨ Что получите: Вы научитесь использовать SpecKit для создания сложных приложений с предсказуемым результатом, минимизируя ошибки за счет четкого планирования и поэтапного выполнения задач под контролем AI-агента.

1. Концепция Spec-Driven Development (SDD) vs Вайбкодинг

Контекст: Традиционный «вайбкодинг» страдает от недостатка ясности: когда вы просите AI «добавить функцию обмена фото», модель додумывает тысячи деталей, которые могут не совпадать с вашим видением. Spec-Driven Development переворачивает процесс: сначала создается «живая» исполняемая спецификация (Spec), которая становится единым источником истины для всех стейкхолдеров и AI-инструментов. Это устраняет разрыв между намерением и реализацией.

Выгода: Код становится чище, безопаснее и надежнее, так как AI не гадает, а следует строгому техническому заданию, которое вы утвердили заранее.

Как применить:

  • Шаг 1: Установка SpecKit — [Terminal] — Установите инструмент и инициализируйте проект, выбрав фреймворк агента (например, GitHub Copilot, Claude Code или Gemini CLI).
  • Шаг 2: Инициализация проекта — [CLI] — Запустите команду создания проекта:
npx @githubnext/speckit init my-pokedex-app
  • Шаг 3: Выбор модели — [Config] — Для лучших результатов автор рекомендует использовать мощные модели, такие как Claude 3.5 Sonnet или Grok-1, так как качество следования спецификациям напрямую зависит от когнитивных способностей модели.

Результат: Создана структура проекта с папками scripts и templates, готовая к генерации документации.


2. Фаза 1: Specify (Определение намерений)

Контекст: На этом этапе вы описываете «что» и «зачем» вы строите, фокусируясь на пользовательских путях и результатах. SpecKit использует ваш промпт для генерации подробного Markdown-файла спецификации. Важно, что AI сам выделяет «зоны уточнения» (Needs Clarification), где ему не хватает данных для принятия решения.

Выгода: Вы получаете профессиональное ТЗ, включая Edge Cases (краевые случаи), о которых могли забыть, не тратя часы на его написание вручную.

Как применить:

  • Шаг 1: Запуск генерации спецификации — [CLI] — Введите общую идею проекта.
# Пример команды (в интерфейсе агента)
specify "Создай Pokedex Team Builder, где можно искать покемонов через API и добавлять их в команду. Используй Shadcn UI."
  • Шаг 2: Ревью файла spec.md — [VS Code] — Откройте созданный файл. Проверьте разделы User Stories, Acceptance Scenarios и Functional Requirements.
  • Шаг 3: Уточнение — [Markdown] — Если в блоке Needs Clarification есть вопросы, впишите ответы прямо в файл или обновите спецификацию новым промптом.

Результат: Утвержденный документ спецификации, который служит «законом» для AI на всех следующих этапах.


3. Фаза 2: Plan (Архитектурное планирование)

Контекст: После утверждения «что» строить, нужно определить «как». В фазе планирования задается стек технологий и архитектурные ограничения. SpecKit генерирует технический план, который включает схему данных, контракты объектов и даже исследовательский документ (Research Document) с обоснованием выбора тех или иных библиотек.

Выгода: Предотвращение архитектурного хаоса. AI заранее продумывает структуру данных (например, Zod-схемы) и учитывает ваши требования (например, использование Debounce для API-запросов).

Как применить:

  • Шаг 1: Определение стека — [CLI] — Передайте технические требования.
plan "Используй Next.js, Tailwind CSS, и Zod для валидации. Добавь debounce на поиск (500ms), чтобы не спамить API покемонов."
  • Шаг 2: Анализ Research Document — [Markdown] — Изучите файл research.md. Там AI объяснит, почему выбраны конкретные решения и какие были альтернативы.
  • Шаг 3: Проверка контрактов — [Markdown] — Убедитесь, что типы данных в плане соответствуют вашим ожиданиям.

Результат: Пошаговый технический план реализации с чек-листом готовности.


4. Фаза 3 и 4: Tasks & Implement (Исполнение)

Контекст: План разбивается на мелкие, атомарные задачи (Tasks). Каждая задача имеет уникальный номер. Вместо того чтобы просить AI «напиши всё приложение», вы заставляете его выполнять задачи по очереди. SpecKit по умолчанию часто следует подходу TDD (Test-Driven Development), сначала создавая тесты, а затем код.

Выгода: Гранулярный контроль. Вы видите прогресс по каждой задаче и можете остановить процесс, если AI свернул не туда, не переписывая весь проект целиком.

Как применить:

  • Шаг 1: Генерация списка задач — [CLI] — Попросите создать список задач для MVP.
tasks "Создай список задач для реализации MVP версии согласно плану."
  • Шаг 2: Поэтапная реализация — [CLI] — Используйте команду implement с номерами задач.
implement tasks 1-4
  • Шаг 3: Итерация — [CLI] — После завершения первых задач, переходите к следующим:
implement tasks 5-10

Результат: Полностью рабочее приложение, где каждая функция протестирована и соответствует исходной спецификации.


GitHub SpecKit: ответы на частые вопросы

В: Чем SpecKit отличается от обычного промпта в Cursor? О: Cursor работает в режиме «чат-код», где контекст быстро теряется. SpecKit принуждает AI сначала зафиксировать требования в документах (spec.md, plan.md), которые агент обязан перечитывать перед каждым изменением кода. Это исключает ситуацию, когда AI «забывает» логику проекта через 10 сообщений.

В: Можно ли использовать SpecKit с Claude Code? О: Да, SpecKit — это открытый инструментарий, разработанный GitHub для работы с любыми агентскими фреймворками, включая Claude Code, GitHub Copilot и специализированные CLI-агенты.

В: Что делать, если AI сгенерировал плохую спецификацию? О: Вы можете вручную отредактировать файл спецификации в Markdown. SpecKit спроектирован так, чтобы человек мог вмешаться на любом из 4-х этапов. Ваши правки в файле станут новыми инструкциями для AI.

В: Обязательно ли использовать TDD (тесты перед кодом)? О: По умолчанию шаблоны SpecKit склоняют AI к TDD, так как это повышает надежность. Однако вы можете изменить это в фазе Plan, указав в промпте: «Реализуй функции без написания предварительных тестов».

В: Какую модель лучше выбрать для работы со SpecKit? О: Автор отмечает, что GPT-4o иногда справляется хуже, чем модели семейства Grok или Claude 3.5 Sonnet, в вопросах строгого следования сложным спецификациям. Рекомендуется использовать наиболее «умные» модели для фаз Specify и Plan.

Конспект создан на основе видео «GitHub SpecKit: The Future of AI Coding?» канала Better Stack. Все права на оригинальный материал принадлежат авторам. Источник: https://www.youtube.com/watch?v=em3vIT9aUsg

Редактор конспекта

Максим Наговицын

Маркетинг-стратег, IT-предприниматель, ментор по вайбкодингу

10+ лет в маркетинге, 300+ клиентских проектов: сайты, реклама, боты. Создатель GoBanana (228K+ пользователей, 11.6 млн ₽ выручки) и VibeCoderz. Делаю AI-продукты сам через Claude Code, Cursor, Windsurf и консультирую тех, кто хочет так же.

Об авторе →
Все конспекты

Источник

КаналBetter Stack
Конспект добавлен2026/03/19
Смотреть на YouTube

Инструменты из конспекта

Похожие конспекты

📝 Конспект

Роль CAIO и стратегия внедрения Generative AI: Практическое руководство от Leidos

Как внедрить ИИ в корпорацию: метрики успеха, модель Hub and Spoke, борьба с Legacy-кодом и советы от CAIO компании Leidos.

2026/04/17
📝 Конспект

Вайбкодинг для 40+: Как создавать IT-продукты и решать задачи бизнеса с помощью AI-агентов

Практическое руководство по вайбкодингу для людей 40+: как без навыков программирования создавать и запускать IT-продукты с помощью нейросетей.

2026/11/02
📝 Конспект

Вайб-маркетинг с AI-агентами: Полный пайплайн от исследования до сайта и лидогенерации

Пошаговый пайплайн вайб-маркетинга: исследование ЦА, анализ конкурентов, сборка продающего сайта через Claude Code и запуск лидогенерации.

2026/11/02
📝 Конспект

Фреймворк Intent.md от Anthropic: Как ставить задачи Claude Code без ошибок и сломанного кода

Пошаговый пайплайн разработки с Claude Code по методологии Anthropic: Intent.md, Spec.md и Plan.md для безошибочного кодинга и автономных AI-агентов.

2026/10/15
📝 Конспект

Поиск клиентов для вайбкодера: 9 проверенных способов генерации лидов и заказов

Гид по поиску клиентов для вайбкодеров: парсинг ФНС и карт, аудит ошибок, субподряд в студиях, Revenue Share и создание контент-фабрики.

2026/10/15
📝 Конспект

AI-агентство для реального сектора: Как продавать и собирать воронки локальному бизнесу за часы

Пошаговый гайд по запуску AI-сервисного бизнеса: выбор высокочековых ниш, аудит сайтов через LLM-промпты, сборка воронок и продажи без упоминания AI.

2026/10/15

Читать далее

📢 Новость

Эпоха Claude Code: Итоги масштабного опроса разработчиков 2026 года

Claude Code захватил рынок всего за 8 месяцев, а 95% инженеров используют AI еженедельно. Разбираем главные тренды в инструментах для вайбкодинга.

2026/03/03
📢 Новость

Spec-Driven Development: как Spec-kit меняет правила игры для вайбкодеров

Команда Prezi протестировала новый подход к разработке через спецификации. Узнайте, как связка Spec-kit и Cursor превращает кодинг в процесс одобрения команд агента.

2026/02/16
📢 Новость

GitHub выпустил Copilot Desktop: прямой конкурент Cursor и Windsurf

GitHub представил нативное десктопное приложение Copilot, ориентированное на агентную разработку и глубокую интеграцию с ОС.

2026/05/23
📄 Статья

Agent Plugins 1.0: единый формат плагинов для AI-агентов — что ставить в 2026

6 августа 2026 года Vercel вместе с Amazon, Anysphere (это компания-создатель Cursor), GitHub, Microsoft и OpenAI опубликовали Agent Plugins 1.0.0 - открытый формат упаковки плагинов для AI-агентов. В тот же день Google объявила, что присоединяется к…

2026/09/158 мин
📄 Статья

agent-browser от Vercel: токен эффективный браузер для AI агентов

agent-browser — это CLI-инструмент от Vercel Labs, который дает AI-агентам управлять браузером через команды терминала, а не через скриншоты. Вместо картинки страницы (3000-5000 токенов) агент получает текстовый ASCII-wireframe на 200-400 токенов и к…

2026/08/2610 мин
📄 Статья

Jcode 15,5К звезд и агент в 245 раз быстрее Claude Code

Jcode - open source coding-агент на Rust, который за полгода набрал больше 15,5 тысяч звезд на GitHub и обошел Claude Code по скорости запуска в 245 раз. Автор проекта - Джереми Хуанг (1jehuang), бывший стажер SpaceX, который написал харнесс в одиноч…

2026/08/1110 мин