OpenSpec — spec-driven development для AI-ассистентов кодинга

· 1 мин чтения
spec-driven ai-agents planning context-engineering
📂 Исходный код на GitHub

Фреймворк spec-driven development (SDD) от Fission AI. Каждое изменение — отдельная папка с proposal, specs, design, tasks. Поддерживает 25+ AI-ассистентов через slash-команды (/opsx:propose, /opsx:apply, /opsx:archive).

OpenSpec — spec-driven development для AI-ассистентов кодинга

AI-ассистенты кодинга генерируют код быстро, но когда требования живут только в истории чата — результат непредсказуем. OpenSpec решает эту проблему, добавляя лёгкий слой спецификаций между задумкой и реализацией.

Что такое OpenSpec

OpenSpec — фреймворк spec-driven development (SDD) с открытым исходным кодом, написанный на TypeScript. Основная идея: сначала договориться, что строим, потом строить. Каждое изменение проходит через артефакты — proposal, specs, design, tasks — которые живут рядом с кодом в папке openspec/.

Проект набрал 53 000+ звёзд на GitHub и активно развивается командой Fission AI.

Философия

OpenSpec намеренно противостоит тяжеловесным методологиям:

  • Fluid, not rigid — артефакты можно обновлять в любой момент, нет жёстких фазовых ворот
  • Iterative, not waterfall — итеративный подход вместо водопада
  • Easy, not complex — минимум церемоний, быстрая установка
  • Built for brownfield — работает не только с нуля, но и с существующими проектами
  • Scalable — от пет-проектов до энтерпрайза

Рабочий процесс

Основной рабочий процесс состоит из трёх slash-команд:

/opsx:propose add-dark-mode
→ AI создаёт папку openspec/changes/add-dark-mode/
  ✓ proposal.md — зачем и что меняем
  ✓ specs/      — требования и сценарии
  ✓ design.md   — технический подход
  ✓ tasks.md    — чеклист реализации

/opsx:apply
→ AI реализует задачи по списку

/opsx:archive
→ Изменение архивируется, спецификации обновляются

Расширенный профиль добавляет команды /opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:bulk-archive, /opsx:onboard.

Установка

Требуется Node.js 20.19.0+. Установка глобально:

npm install -g @fission-ai/openspec@latest

Инициализация в проекте:

cd your-project
openspec init

После инициализации AI-ассистенту доступна команда /opsx:propose <что-хотите-построить>.

Для обновления agent-инструкций в существующих проектах:

openspec update

Также работает с pnpm, yarn, bun и nix.

Поддерживаемые инструменты

OpenSpec работает с 25+ AI-ассистентами через slash-команды, включая:

  • Claude Code
  • OpenCode
  • Cursor
  • Copilot CLI
  • Codex
  • Gemini CLI
  • Windsurf
  • и другие

Полный список доступен в документации проекта.

Сравнение с альтернативами

Инструмент Подход Плюсы Минусы
OpenSpec Лёгкие артефакты, итеративность Свобода инструментов, минимум церемоний —
Spec Kit (GitHub) Жёсткие фазовые ворота Основательность Тяжеловесный, Python, много Markdown
Kiro (AWS) Привязка к IDE Мощный Залочен на свой IDE и модели Claude

Рекомендации по использованию

  • Модели — OpenSpec лучше работает с моделями высокого уровня reasoning: Codex 5.5, Opus 4.7
  • Гигиена контекста — очищайте контекст перед началом реализации, это улучшает качество
  • Community schemas — доступны сторонние наборы схем для интеграции с другими инструментами

Ссылки

Источник: https://github.com/Fission-AI/OpenSpec

Похожие материалы