FeatherSpec — воркфлоу

FeatherSpec ведет разработку от спецификации к плану и коду в Claude Code и Copilot: 13 команд /sdd и память в Markdown

  • 70 ★ репозитория
  • Последний коммит
  • MIT
Воркфлоу

Минимальный доступ

Почему такой уровень

  • Шаблон состоит из инструкций и команд в Markdown, но агент по ним пишет и меняет код проекта и файлы в `.specs` и `.memory-bank`
Все причины и проверки

gregorbiswanger/featherspec

Установка

Ручная установка

npx degit GregorBiswanger/featherspec my-project

Скачивает файлы шаблона без истории git. Затем откройте проект в Claude Code или Copilot и выполните /sdd-setup. Для существующего репозитория файлы копируют вручную.

Доступ и проверки

Как мы проверяем

Минимальный доступИнструмент ничего не запускает и не ходит в сеть.

  • Шаблон состоит из инструкций и команд в Markdown, но агент по ним пишет и меняет код проекта и файлы в `.specs` и `.memory-bank`

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

FeatherSpec — легкий шаблон разработки от спецификации (spec-driven development), в котором нет CLI, установки и зависимостей: только Markdown и папки. Вы описываете, что хотите, агент превращает это в спецификацию с проверяемыми критериями приемки, затем в план мелких шагов и только потом пишет код. Спецификации, планы, решения и прогресс лежат в репозитории, поэтому следующая сессия, коллега или другой инструмент продолжает с того же места. Тринадцать команд `/sdd-*` одинаково работают в Claude Code и GitHub Copilot, потому что оба запускают одни и те же файлы: `/sdd-setup`, `/sdd-specify`, `/sdd-clarify`, `/sdd-plan`, `/sdd-compile`, `/sdd-lifecycle`, `/sdd-overview`, `/sdd-clean`, `/sdd-architecture-scan`, `/sdd-architecture-update`, `/sdd-reverse-specify`, `/sdd-style-update`, `/sdd-featherspec-update`. Правила лежат в `AGENTS.md`, который импортирует `CLAUDE.md`, а подчиненные агенты-разведчики в `.claude/agents` и `.github/agents` читают код изолированно. Первый запуск `/sdd-setup` спрашивает язык документации, описание проекта, правила качества после каждого шага и режим TDD, затем место задач: GitHub, Jira, другой трекер или никакого. Для готовой кодовой базы мастер делает глубокое сканирование архитектуры и сжимает его в короткий слепок, а `/sdd-reverse-specify` восстанавливает поведение уже написанного кода. Постоянно в контексте только конституция примерно на 200 строк, карты модулей до 40 строк подгружаются при обращении к модулю.

Для кого. Разработчикам и командам, которые работают в Claude Code и GitHub Copilot вперемешку и хотят общий порядок спецификаций, планов и памяти проекта прямо в репозитории.

Подходит, если

  • Новая функция идет от спецификации с критериями приемки к плану мелких шагов и только потом к коду
  • Коллега открывает проект в Copilot, вы в Claude Code, и у обоих одинаковые команды `/sdd-*`
  • Существующий сервис надо описать: `/sdd-architecture-scan` строит слепок, а `/sdd-reverse-specify` восстанавливает поведение
  • Спецификации должны превращаться в тикеты Jira или GitHub Issues, а статусы в переходы
  • Новая сессия агента продолжает работу по Memory Bank без пересказа вчерашнего чата

Не подходит, если

  • Задача разовая и мелкая: цикл спецификации и плана избыточен
  • Нужен CLI или пакет с версиями: FeatherSpec состоит только из файлов, которые копируются в проект
  • Вы работаете в Cursor или Codex: шаблон рассчитан на Claude Code и GitHub Copilot в VS Code
  • Копировать десять папок и файлов в большой репозиторий нельзя по правилам команды

Пример запроса к агенту

/sdd-specify оформи функцию экспорта счетов в CSV со спецификацией и критериями приемки, затем /sdd-plan

Ограничения

  • Это шаблон из файлов: для нового проекта его берут кнопкой Use this template или `npx degit GregorBiswanger/featherspec my-project`, для существующего копируют `AGENTS.md`, `CLAUDE.md`, `.claude/`, `.github/prompts/`, `.github/instructions/`, `.github/agents/`, `.specs/`, `.memory-bank/` и `.vscode/settings.json`.
  • В Copilot открывают папку самого проекта в режиме Agent, иначе слэш-команды не появятся.
  • Связь с трекером идет через доступ, который уже есть у инструмента (`gh`, MCP GitHub или Atlassian), а своих знаний о трекере в шаблоне нет.
  • Глубокое сканирование большого репозитория дорого: его стоимость регулируют списком работ.

Как отключить. Файлы шаблона удаляют из репозитория: `AGENTS.md`, `CLAUDE.md`, `.claude/`, `.github/prompts/`, `.github/instructions/`, `.github/agents/`, `.specs/` и `.memory-bank/`. Установки и фоновых процессов нет, поэтому после удаления файлов от FeatherSpec ничего не остается.

Частые вопросы

Как начать работу с FeatherSpec?

Возьмите шаблон кнопкой Use this template или командой `npx degit GregorBiswanger/featherspec my-project`, откройте проект в Claude Code или Copilot и выполните `/sdd-setup`.

Нужно ли что-то устанавливать?

Нет. В проекте нет CLI и зависимостей, это Markdown и папки. Установка сводится к копированию файлов и первому запуску мастера `/sdd-setup`.

Как подключить существующий проект?

Скопируйте файлы шаблона в репозиторий и выполните `/sdd-setup`, выбрав existing software. Мастер предложит глубокое сканирование архитектуры, а `/sdd-reverse-specify` восстановит спецификации по коду и тестам.

Работает ли шаблон с Jira?

Да, если в мастере указать трекер: готовая спецификация может стать тикетом, а смена статуса дает соответствующий переход, через доступ, который уже есть у вашего инструмента. Одиночный разработчик отвечает `none`.

Сколько контекста занимает документация?

Всегда загружена только конституция примерно на 200 строк, а карты модулей до 40 строк подгружаются, когда агент работает с этим модулем.

Обсуждение

Вопросов и отзывов пока нет.

Воркфлоу

Два скилла для разработки от спецификации: /spec задает вопросы и сохраняет документ в specs/, /spec-impl реализует утвержденную спецификацию по шагам

СкиллРасширенный доступ387Звезды репозитория

CLI хранит спецификацию, задачи и доказательства готовности в git, чтобы Claude, Codex, Grok и Cursor передавали работу друг другу

CLIРасширенный доступ171Звезды репозитория

Скилл расспрашивает про проект и пишет requirements.md, design.md и tasks.md, чтобы Claude Code и Cursor работали по одному плану

СкиллРасширенный доступ158Звезды репозитория

Плагин из трех скиллов для крупных задач разработки: анализ проекта, разбивка на фазы с задачами в GitHub Issues, параллельные агенты и ревью кода

ПлагинШирокий доступ993Звезды репозитория

Терминальная среда и CLI для разработки по спецификациям: Gherkin, доска задач и несколько агентов в Rust.

CLIШирокий доступ104Звезды репозитория
Выбор редакции

Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации

CLIРасширенный доступ149,6 тыс.Звезды репозитория

Коротко о README

В README описан цикл «спецификация, план, код» и обещана работа без установки. Затем идут три шага старта, раздел о подключении готовой кодовой базы с архитектурным сканированием и обратной спецификацией, список команд `/sdd-*` и описание связи с трекерами.

Бейдж для README

Сообщить о проблеме