Концепция

Как Forge DevKit думает, почему работает именно так и чем отличается от библиотек промптов.

Архитектура мета-инструмента

Forge - не библиотека промптов. Это мета-инструмент - инструмент, который генерирует инструменты. Когда вы запускаете /forge:setup, Forge анализирует ваш проект и генерирует специфичные для него артефакты: dev-скиллы, паттерны качества, конфигурации пайплайна и гайдрейлы. Артефакты живут в директории .claude/ вашего проекта и работают автономно.

◆

Одноразовый по дизайну: После настройки вы можете полностью удалить Forge. Сгенерированные артефакты продолжат работать - это самодостаточные файлы, которые AI читает при старте сессии. Forge - генератор, а не рантайм.

Как это работает

Детекция. Forge сканирует ваш проект: стек, фреймворки, архитектурные слои, соглашения, файловую структуру, зависимости. Никаких конфигурационных файлов не нужно.

Генерация. На основе результатов детекции Forge генерирует артефакты под ваш проект: dev-скиллы с вашими соглашениями, паттерны качества для вашего стека, фазы пайплайна для вашего воркфлоу.

Автономность. Сгенерированные артефакты загружаются AI автоматически при каждом старте сессии. Они содержат архитектуру вашего проекта, паттерны и правила - AI никогда не забывает.

Детекция вместо конфигурации

В Forge ноль захардкоженных знаний о проектах. Он не поставляется с шаблонами NestJS, паттернами React или конвенциями Django. Вместо этого он определяет, что использует ваш проект, и генерирует артефакты на основе того, что находит.

7-этапный визард настройки анализирует вашу реальную кодовую базу: package.json, структуру директорий, паттерны импортов, Docker-конфиги, CI-пайплайны, миграции базы данных. Он строит модель вашей архитектуры - не из шаблонов, а из доказательств.

Что Forge определяет

✓ Стек и фреймворки
✓ Архитектурные слои и границы
✓ Конвенции именования и стиль кода
✓ Тест-фреймворки и паттерны
✓ Docker, CI/CD и инфраструктура
✓ База данных и ORM
✓ Auth, events и AI/LLM-паттерны

Почему детекция важна

✓ Работает с любой комбинацией стека
✓ Нет конфиг-файлов для поддержки
✓ Адаптируется к проекту, а не наоборот
✓ Ловит конвенции, которые шаблоны пропускают
✓ Переконфигурируйте в любой момент по мере развития проекта

Core + Адаптеры

Forge использует архитектуру core + адаптеры. forge-core - это фундамент: настройка, детекция, генерация артефактов и пайплайн разработки. Все остальные модули - адаптеры, расширяющие ядро.

Адаптеры - это независимые плагины, связанные через shared state в .claude/forge/. Каждый адаптер читает артефакты других модулей, от которых зависит (discovery не читает ничего, marketing читает discovery, copy читает marketing) - но все зависимости опциональны. Каждый адаптер работает самостоятельно; он просто становится умнее с контекстом от соседей.

Поток экосистемы

discovery → marketing → product → /dev пайплайн ↓ copy, seo, analytics ↓ onboarding, growth, ab

◆

Установите то, что нужно. Starter даёт базовый пайплайн (forge-core + forge-worktree). Pro добавляет продуктовый дизайн, тестирование, трекинг задач и управление промптами. Complete открывает 8 модулей-советников, окружающих пайплайн стратегией: от discovery до A/B-тестирования.

Пайплайн разработки

Когда вы вводите /dev, Forge активирует многофазный пайплайн, сгенерированный специально для вашего проекта. Каждая фаза имеет чёткие границы, проверки качества и гайдрейлы, предотвращающие попытки AI срезать углы.

Фазы пайплайна

Фаза 0

Понимание. Прочитать задачу, загрузить контекст из трекера и продуктовых артефактов, спланировать подход.

Фаза 1

Планирование. Разбить задачу на шаги, определить затронутые файлы и слои, валидировать относительно архитектуры.

Фаза 2

Реализация. Писать код следуя обнаруженным конвенциям, границам слоёв и паттернам именования.

Фаза 3

Тестирование. Генерация тестов из критериев приёмки (не из догадок AI), запуск quality gates.

Фаза 4

Ревью. Самопроверка по 50+ паттернам качества, проверка на рационализацию, верификация полноты.

Каждая фаза включает детекторы рационализации - 15 паттернов, которые ловят попытки AI пропустить шаги, упростить требования или срезать углы. Они калиброваны под уровень сложности вашего проекта: не замедляют простые задачи, но перехватывают ярлыки на сложных.

Паттерны качества

После определения возможностей вашего проекта (UI, API, база данных, Docker, auth, events, AI) Forge генерирует паттерны качества, ограниченные тем, что у вас реально есть. Бэкенд API-проект получает другие паттерны, чем full-stack приложение с React-фронтендом.

UI-паттерны

Границы компонентов, управление состоянием, доступность, адаптивный дизайн, бюджеты производительности

API-паттерны

Обработка ошибок, валидация, auth guards, rate limiting, контракты ответов

Инфраструктурные паттерны

Docker-конфигурация, безопасность CI/CD, изоляция окружений, стратегии миграций

Общие паттерны

Конвенции именования, границы слоёв, правила зависимостей, организация кода, структура тестов

Обновления и эволюция

Forge отслеживает владение каждым сгенерированным файлом через заголовки версий. При обновлении плагина Forge знает, какие файлы он сгенерировал (безопасно обновить) и какие вы изменили (сохранить). Запустите /forge:setup upgrade, чтобы проверить обновления и применить их безопасно.

Ваш проект эволюционирует, и Forge эволюционирует вместе с ним. Сменили тест-фреймворк? Реструктурировали слои? Запустите /forge:setup reconfigure, чтобы переопределить и перегенерировать артефакты. Визард сохраняет прогресс после каждого этапа, поэтому прерывания безопасны.

Кастомизация пайплайна

Forge генерирует пайплайн под ваш проект - но вы не заперты в нём. Можно добавлять свои шаги, встраивать собственную логику, создавать проектные скиллы и интегрировать их в экосистему. Всё, что вы добавляете, отслеживается и переживает обновления.

Добавление шагов в пайплайн

Пайплайн разработки строится из каталога шагов - структурированного реестра всех фаз и шагов, которым следует AI. Вы можете добавить свои шаги в любую фазу через /forge:patch.

Пример: добавление шага линтинга

# Запуск команды patch

$ /forge:patch

# Выбираем "step-catalog.md" как цель

# Forge создаёт:

step-catalog.md ← новая строка с тегом [patch:patch.2.1]

.claude/forge/patches/patch.2.1.md ← тело шага

.claude/forge/patches/registry.yaml ← реестр для обновлений

Патченные шаги помечаются тегом [patch:{id}] в каталоге. При обновлении Forge каталог пересобирается из последнего шаблона - затем ваши патчи автоматически применяются из реестра. Ваша логика никогда не теряется.

◆

Три типа патчируемых артефактов: Managed-файлы (полностью forge-owned), augmented-файлы (user-owned с forge-секциями) и catalog-файлы (таблицы шагов). У каждого типа свои правила скоупа для предотвращения случайных перезаписей.

Создание своих скиллов

Помимо патчинга шагов, вы можете создавать полностью новые скиллы, которые живут рядом со сгенерированными Forge. Скилл - это просто файл SKILL.md в .claude/skills/ с именем и описанием в frontmatter.

Структура файлов скилла

.claude/skills/ forge-dev-context/ # сгенерирован Forge forge-dev-implement/ # сгенерирован Forge my-deploy-check/ # ваш кастомный скилл SKILL.md references/ deploy-checklist.md

В SKILL.md нужен frontmatter с name и description - описание используется AI для решения, когда активировать скилл. Пишите чётко: "Использовать этот скилл при деплое на staging или production" работает лучше, чем "помощник деплоя".

✓

Сосуществование по дизайну. Ваши кастомные скиллы и сгенерированные Forge живут в одной директории .claude/skills/. Forge отслеживает свои файлы через managed-заголовки и никогда не трогает файлы, которые не создавал. При обновлении ваши скиллы остаются нетронутыми.

Аугментация существующих скиллов

Если у вас уже есть dev-скиллы до установки Forge, визард настройки обнаруживает их и запускает gap-анализ. Он сравнивает ваш скилл с 13 core-фичами (фазовый пайплайн, протокол возобновления, паттерны качества и т.д.) и рекомендует один из трёх режимов:

Оставить

Ваш скилл уже покрывает 80%+ фич Forge. Изменения не нужны.

Дополнить

Ваш скилл хорош, но не хватает конкретных фич. Forge встраивает их как помеченные секции - ваш контент остаётся нетронутым.

Заменить

Покрытие низкое. Forge генерирует свежие скиллы с нуля, сохраняя ваш оригинал как бэкап.

Дополненные секции обёрнуты маркерами типа . При обновлении обновляется только контент внутри маркеров - всё за их пределами остаётся вашим.

Как Hub обнаруживает ваши скиллы

Forge Hub (/forge:hub) - это роутер интентов, который классифицирует ваш запрос и находит нужный скилл. Он начинает с проверки готовности, затем обнаруживает скиллы на двух уровнях:

✓

Работает с любым состоянием проекта. Запустите /forge:hub на пустой директории - он предложит /forge:init для scaffolding. Запустите на проекте без Forge - автоматически запустит /forge:setup для настройки пайплайна. Запустите на настроенном проекте - направит к нужному скиллу. Не нужно ничего помнить.

Уровни обнаружения Hub

Бутстрап. Hub проверяет, настроен ли Forge. Нет конфига? Запускает setup автоматически. Пустой проект? Предлагает init. Вы никогда не упрётесь в тупик.

Установленные адаптеры. Hub читает .claude/forge/core/config.yaml, чтобы знать, какие модули Forge активны. Это управляет обходом графа зависимостей и резолвом пререквизитов.

Проектные скиллы. AI автоматически загружает все скиллы из .claude/skills/ при старте сессии - как сгенерированные Forge, так и ваши кастомные. Hub направляет к тому скиллу, который соответствует интенту - неважно, создан он Forge или вами.

Когда вы говорите /forge:hub проверить готовность к деплою и у вас есть кастомный скилл my-deploy-check, AI видит его в списке и может направить к нему. Никакой дополнительной настройки - достаточно описания в SKILL.md, чтобы AI связал интент со скиллом.

Недостающие адаптеры? Hub предложит установить

Когда Hub обходит граф зависимостей и находит, что нужный модуль не установлен, он не пропускает его молча. Вместо этого он классифицирует влияние и предлагает выбор:

Обязательный

Целевой адаптер отсутствует. Hub останавливается и предлагает установить прямо сейчас. После установки цепочка продолжается.

Рекомендуемый

Upstream-модуль значительно улучшит качество результата. Hub объясняет ценность и предлагает установку. Можно пропустить.

Опциональный

Приятное дополнение. Hub пропускает молча и логирует рекомендацию в отчёте выполнения.

◆

Новые адаптеры требуют обновления пайплайна. Если вы установили новый адаптер Forge (например forge-analytics), запустите /forge:setup upgrade, чтобы каталог шагов обновился шагами нового модуля. Сам Hub обновления не требует - он читает config.yaml динамически. Но каталог шагов dev-пайплайна - это сгенерированный артефакт и нуждается в перегенерации для включения шагов нового адаптера.

Переопределение конфигурации пайплайна

Для продвинутого контроля вы можете переопределить поведение пайплайна без изменения сгенерированных файлов. Pipeline config в .claude/forge/core/pipeline-config.yaml позволяет закреплять или пропускать манифесты адаптеров, задавать execution mode по умолчанию и настраивать лимиты.

Пример: pipeline-config.yaml

# Пропустить advisory-модули для быстрой итерации skip_manifests: - forge-seo-manifest - forge-analytics-manifest # Закрепить execution mode execution_mode: balanced # Лимиты max_subagents: 3

Этот файл принадлежит пользователю (без managed-заголовка) - Forge никогда его не перезаписывает. Изменения вступают в силу при следующем запуске /dev.

Хотите увидеть в действии?

Начать за 5 минут → Все 15 модулей