Урок 16.19. Экосистема сообщества

Зачем это нужно

Механизмы расширения (уроки 16.11-16.15) были бы теорией без экосистемы поверх них. К срезу 2026-10-03 сообщество Spec Kit построило 157 расширений от 90+ авторов, 33 пресета, walkthrough-ы на разных стеках и спутниковые проекты - от VS Code-расширений до TUI-дашбордов.

Этот урок - карта экосистемы: что публикуется, как каталогизировано, как находить и как публиковать свое. Каталоги расширений и пресетов в оригинале - огромные таблицы; здесь они сжаты до категорий и характерных примеров (полные каталоги - по ссылкам на оригинал).

Основная идея

Сообщество строит пять видов вкладов: extensions (новые возможности), presets (новое поведение), bundles (role-based стеки), walkthroughs (сквозные примеры) и friends-проекты (построенное поверх). Все компоненты сообщества создаются и поддерживаются независимо их авторами; мейнтейнеры проверяют только полноту и формат записей каталогов - код не ревьюится, не аудируется и не одобряется. Листинг в каталоге - не знак качества: ревьюйте исходники до установки.

Расширения сообщества

Расширения добавляют возможности: доменные команды, интеграции внешних платформ, quality gates. На срез 2026-10-03 - 157 расширений (страница каталога упоминает 130+ от 70+ авторов в описании раздела; итоговая статистика лендинга - 157); поиск и browse - на стороннем сайте Community Extensions (https://speckit-community.github.io/extensions/) и в catalog.community.json.

Каталог классифицирует двумя осями. Категория (частые значения, допускается любая строка): docs - читает, валидирует или генерирует спек-артефакты; code - ревьюит, валидирует или модифицирует исходники; process - оркестрирует workflow между фазами; integration - синхронизация с внешними платформами; visibility - репортит о здоровье или прогрессе проекта. Эффект: read-only - отчеты без изменения файлов; read-write - меняет файлы, создает артефакты, обновляет спеки. Авторы объявляют category и effect в extension.yml; поля видны CLI (specify extension info).

Характерные примеры по категориям (полная таблица - в оригинале):

Категория	Примеры	Что делают
`docs`	Spec Diagram, Data Model Diagram, Spec Trace, Atlas, MarkItDown	Mermaid-диаграммы SDD-состояния и ER из моделей; матрица трассированности «требование -> тест»; интерактивные архитектурные сторибуки; конвертация PDF/Word/Excel в Markdown для референсов спеки
`code`	TDD Extension, Verify Extension, Security Review, Cleanup	red-green-refactor цикл с записанным red/green-подтверждением и mutation-проверкой силы тестов; post-implementation валидация кода против артефактов; full-project security-аудиты; scout-rule чистка после реализации
`process`	CI Guard, Architecture Guard, Brownfield Bootstrap, Product Forge, Canon, AIDE	ворота соответствия спек в CI/CD; дрейф-детекция архитектуры и задачи рефакторинга; автodiscovery архитектуры для внедрения SDD в существующей кодовой базе; продуктовый lifecycle-оркестратор; baseline-driven workflows; 7-шаговый жизненный цикл
`integration`	Jira Integration, Linear Sync, Azure DevOps, Spec Kit Figma, M365	зеркалирование спек в Jira/Linear/Azure Boards; заземление спек в Figma-контексте; импорт Teams-сообщений и документов SharePoint как Markdown
`visibility`	Project Health Check, Cost Tracker, Token Consumption Analyzer, Spec Scope	диагностика здоровья проекта по структуре/агентам/фичам; трекинг долларовой стоимости LLM по фичам; анализ потребления токенов; оценка усилий и контроль scope-крипа

Заметные направления за пределами таблиц: управление памятью проекта и ADR (adrkit, Memory Loader, Spec Kit Memory), параллелизация и оркестрация агентов (Spec Kit Schedule, Worktree Isolation, MAQA), не-SDD применения (Fiction Book Writing как расширительная линия, Time Machine - ретроспективное применение SDD к существующему коду). Напомним модель доверия урока 16.12: community-каталог discovery-only; установка - через вэттинг---from или кураторский каталог.

Пресеты сообщества

Пресеты переопределяют шаблоны, команды и терминологию без смены тулинга; каталог - в catalog.community.json. Крупные группы (полная таблица - в оригинале):

Группа	Примеры	Что делают
Governance-семейство	Security Governance, Architecture Governance, A11Y Governance, Test-First Governance, Cross-Platform Governance	добавляют secure-coding и ASVS-контроль, STRIDE/arc42-моделирование угроз, WCAG 2.2 AA и доступные статусы, BDD/ATDD-сценарии с трассируемостью, паритет Bash/PowerShell - каждый десятки шаблонов и команд
Локализация и UX	Pirate Speak (Full), Claude AskUserQuestion, VS Code Ask Questions	вся терминология на пиратском наречии («specs» -> «Voyage Manifests», «plans» -> «Battle Plans»); нативный AskUserQuestion-пикер вместо Markdown-таблиц в clarify/checklist
Творческие writing-пресеты	Fiction Book Writing, Game Narrative Writing, Screenwriting	SDD-workflow для романов и аудиокниг (12 языков, 26 шаблонов, 34 команды), гейм-нарративы с ветвлением и диалоговыми деревьями, сценарии с экспортом в Fountain/FTX/PDF
Инженерные конвенции	Database Standards, Explicit Task Dependencies, Table of Contents Navigation	ORM-агностичные конвенции БД со schema-review-чеклистом; явные `(depends on T###)` и execution-wave DAG в tasks.md; навигационное оглавление в артефактах
Методологии	Canon Core, OpenUP Governance, Model Driven Engineering, Spec2Cloud	адаптация к baseline-driven workflows; lifecycle OpenUP с исполняемым реестром рисков; MDE с cross-spec поддержкой; деплой-ориентированный конвейер в Azure

Колонки оригинального каталога: Preset / Purpose / Provides (счетчики templates, commands, scripts) / Requires (например, Canon Core требует расширения Canon) / URL. Своя публикация - по Presets Publishing Guide.

Бандлы сообщества

Бандлы собирают расширения, пресеты, workflows и шаги в стек роли или команды. Принятые записи публикуются в bundles/catalog.community.json; встроенный community-источник discovery-only - search/info работают, установка по ID требует явного install-allowed каталога (урок 16.15). На срез:

Бандл	Назначение	Роль	Состав
Agentstandards Multi-Vendor Architecture	Codex-оркестрованный мульти-вендорный архитектурный совет, жесткий task gate и поддерживающий workflow	architecture-governance	1 расширение, 1 пресет, 1 workflow
SicarioSpec Security & Governance	secure-by-default governance: классификация данных, моделирование угроз, code-owned ворота верификации	security-engineer	1 расширение, 11 пресетов
SpecAssay	durable-ID promotion: шаблоны, отказ Gate 2 на молчаливых пробелах, эмиссия trace-manifest	developer	1 расширение, 1 пресет

Сабмишен включает: публичный репозиторий с валидным bundle.yml; версионируемый GitHub-релиз с артефактом specify bundle build; документацию роли, компонентов, требуемых каталогов и workflow; предлагаемую запись каталога; тестовые доказательства из чистого проекта. Резолюция компонентов: ссылки бандла резолвятся из bundled-компонентов, уже установленных или активных каталогов - если нужны не-дефолтные каталоги, включите их URL в сабмишен и README и протестируйте полный путь установки из чистого проекта. Ревью мейнтейнеров проверяет поля, доступность URL, наличие манифеста и форму записи - поведение компонентов не аудируется. Обновление - новое Bundle Submission issue с новой версией, URL, измененным списком компонентов и обновленными доказательствами.

Walkthroughs сообщества

Пошаговые руководства SDD в действии - read-only примеры завершенных прогонов, не «официальные golden-выходы»:

Greenfield .NET CLI tool (.NET single-binary CLI «Timezone Utility» из пустого каталога): полный цикл constitution -> specify -> plan -> tasks -> многопроходный implement на агентах GitHub Copilot.
Greenfield Spring Boot + React platform: платформа LLM-аналитики с REST API, PostgreSQL и Docker Compose - включая clarify-шаг и кросс-артефактный analyze.
Brownfield ASP.NET CMS extension: расширение открытой .NET CMS (~307 000 строк) - Docker Compose-инфраструктура и headless REST API; SDD в существующей кодовой базе без спек и конституции.
Brownfield Java runtime extension: Jakarta EE runtime Piranha (~420 000 строк, 180 Maven-модулей) - консоль администратора с паролем; большой мультимодульный Java-проект.
Brownfield Go / React dashboard: NASA Hermes ground support system (Go) + React-дашборд телеметрии - весь цикл из терминала через GitHub Copilot CLI.
Greenfield Spring Boot MVC с пресетом pirate-speak: та же генерация «на пиратском» без изменения тулинга - демонстрация силы пресетов.
Greenfield Spring Boot + React с расширением AIDE: 7-шаговый жизненный цикл (vision -> roadmap -> прогресс -> очередь -> work items -> исполнение -> фидбек) на сценарии семейной торговой платформы - как extension-механизм вплетает другой стиль spec-driven разработки.

Для урока 16.17 brownfield-примеры особенно ценны: они показывают SDD поверх чужих больших кодовых баз без предварительных спек.

Friends-проекты

Проекты, расширяющие, визуализирующие или строящие поверх Spec Kit (независимые, если не отмечено first-party):

cc-spex - плагин Claude Code: композируемые трейты поверх Spec Kit с quality gates на базе Superpowers, spec/code-ревью, изоляция git worktree, параллельная реализация агентными командами.
VS Code Spec Kit Assistant - визуальный оркестратор полного SDD-цикла: статус фаз, интерактивный чек-лист задач, DAG-визуализация; бэкенды Claude, Gemini, Copilot, OpenAI; требует specify в PATH.
SpecKit Assistant (npm) - то же семейство визуальных оркестраторов без глобальной установки: npx speckit-assistant.
SpecKit Companion - VS Code-расширение: богатый просмотр спек с кликабельными ссылками, комментарии в стиле GitHub-review, визуальный степпер SDD, управление steering-документами.
cc-spec-kit - плагин для Claude Code и Copilot CLI: ставит скиллы Spec Kit через plugin marketplace.
spectatui - TUI-дашборд: фичи, спецификации, интеграции, пресеты, workflows, расширения; подключение к существующим AI-сессиям или запуск новых из терминала.
spec-kit-copilot - first-party проект GitHub: skills-плагин Copilot, открывающий CLI specify агенту Copilot - по фокусированному скиллу на группу команд (setup, init, extensions, presets, bundles, workflows...); агент сам решает, когда и какие specify-команды запускать.
Spec Kit Workflow Cockpit - терминальная панель управления workflow: живой обзор всего процесса, чтение/правка документов фичи на гейтах, решения ворот с подтверждением; скилл cockpit-run-context связывает интерактивную сессию с текущим прогоном.
Specstride - автономный оркестратор реализации: потребляет tasks.md фичи (спека, план, контракты - read-only контекст), гоняет агента (Claude Code, Codex, локальная модель) пофазно; фаза двигается только при одобрении отдельного LLM-критика; застрявшие фазы получают диагноста и суженный ретрай; opt-in-цикл учится на телеметрии и откатывает ухудшения.
Raaghu Spec Kit - SDD внутри Azure DevOps: PM, BA и QA генерируют и ревьюят структурированные спеки, планы, задачи и чек-листы, создают work items Azure Boards; Services и on-premises Server.

Как опубликовать свое

Выбор типа компонента - по гайду кастомизации (урок 16.11). Публикация - по официальным гайдам: Extension Publishing Guide (extensions/EXTENSION-PUBLISHING-GUIDE.md), Presets Publishing Guide (presets/PUBLISHING.md), для бандлов - Bundle Submission issue (см. выше). Общий знаменатель всех трех: валидный манифест, версионируемый релиз-артефакт, документация и тестовые доказательства из чистого проекта.

Практика

Через specify extension search найдите по категории три расширения, релевантные вашему процессу (например, visibility, process, integration); для выбранного пройдите путь discovery-only установки: info -> архив-кандидат -> ревью -> --from.
Изучите пресет Fiction Book Writing и pirate-speak: объясните, почему они возможны без изменения ядра, - сошлитесь на стек резолюции урока 16.13.
Пройдите один brownfield-walkthrough (ASP.NET CMS или Java runtime) - обратите внимание, что первая фича не была «задокументировать всё» (урок 16.17).

Краткое резюме

Экосистема сообщества - пять видов вкладов поверх механизмов ядра: расширения (157, категории docs/code/process/integration/visibility, эффекты read-only/read-write), пресеты (33: governance-семейства, локализация, творческие writing-пресеты, инженерные конвенции, методологии), бандлы (role-based стеки с задокументированными каталогами), walkthroughs (greenfield/brownfield примеры на .NET, Java, Go/React, Spring) и friends (VS Code-расширения, TUI, плагины Copilot/Claude, оркестраторы). Все компоненты независимы: каталоги проверяют формат, не код.

Главное из урока:

листинг в каталоге - не аудит и не одобрение; ревью исходников до установки обязательно;
категория и эффект расширения объявляются автором и видны CLI;
community-каталоги discovery-only: установка найденного - через вэттинг---from или кураторский install-allowed каталог;
сабмишен бандла требует доказательств резолюции зависимостей из чистого проекта;
walkthroughs - примеры, не golden-выходы: ваши артефакты законно отличаются.

Вопросы для самопроверки

Перечислите пять видов вкладов сообщества и по одному предложению роли каждого.
Что именно проверяют мейнтейнеры при приеме компонента в каталог? Что они сознательно не проверяют?
Объясните оси классификации расширений: категории и эффекты. Где автор объявляет их и где значения видны пользователю?
Почему community-каталоги discovery-only? Вспомните два корректных пути установки найденного в нем компонента.
Какие требования предъявляются к сабмишену бандла? Почему тестовая установка из чистого проекта обязательна?
Приведите по одному примеру walkthrough и friends-проекта, полезных для команды с большой унаследованной кодовой базой.

Что дальше

Последний урок модуля - 16.20: как устроен сам репозиторий Spec Kit, как поднять окружение контрибьютора и внести свой вклад в развитие инструмента.