Интерактивный гайд
Каждый терминал ниже - реальный сценарий. Смотрите, как выполняются команды, что генерируется, что Forge делает на каждом шаге.
Ваш стек, понятый
forge setup читает вашу кодовую базу - package.json, структуру директорий, конфиг-файлы - и строит полный профиль архитектуры. Без анкет, без конфигурации. Просто работает.
Backend-проект
9 гейтов менее чем за 10 секунд. Forge определяет весь стек (NestJS, Prisma, PostgreSQL, JWT, Bull queues), аудирует naming conventions по всем сервисам, измеряет покрытие существующих скиллов и генерирует tailored dev-pipeline с 50+ паттернами качества, привязанными к вашим конкретным capabilities.
◆ Gate 1: Architecture Audit
Stack: NestJS 11.0 + TypeScript 5.8 + Prisma 6.4
Architecture: Clean Architecture (3 layers)
Database: PostgreSQL 16 | CI: GitHub Actions
Auth: JWT + Passport | Events: Bull queues
Parallel: 7/10 | Conflicts: 2 zones
✓ Gate 2: Development Pipeline
Git: trunk-based · Commits: conventional (92%) · Mode: balanced
✓ Gate 3: Task Tracking → GitHub Issues + 3 scripts
✓ Gate 3.5: Script Verification → 3/3 syntax + smoke tests
◆ Gate 4: Quality Checklist
Capabilities: api · database · auth · events · docker
✓ Loaded: api.md + infra.md + shared.md → 53 patterns
◆ Gate 5: Naming Conventions
✓ Services: *Service (8/8) ✓ DTOs: Create*Dto (12/15)
⚠ Events: inconsistent → adopted *CreatedEvent
✓ Gate 6: Knowledge Export → CLAUDE.md updated, 15 rationalization detectors
◆ Gate 6.5: Skill Reconciliation
dev 35% → Replace (5/13 core features)
deploy 62% → Augment (+resume, +tasklist, +self-review)
testing 90% → Keep (12/13 core features)
◆ Generation: Dev-skills & Config
.claude/
├── CLAUDE.md ← architecture + conventions
├── settings.json ← 3 execution modes
└── skills/dev/
├── SKILL.md ← 6-phase TDD pipeline
├── step-catalog.md ← 52 scoped steps
└── quality-patterns/ ← api + infra + shared
✦ Setup complete. 9/9 gates passed. AI is now architecture-aware.
Works with: Claude Code · Cursor · Windsurf · any AI agent
Frontend-проект
Та же команда, совершенно другой результат. На проекте Next.js + React 19 + Tailwind v4 Forge генерирует UI-специфичные паттерны качества (accessibility, performance, component boundaries), настраивает компонентное тестирование с Testing Library + Vitest и адаптирует весь пайплайн под frontend-конвенции.
◆ Gate 1: Architecture Audit
Stack: Next.js 15.3 + React 19 + TypeScript 5.8
Rendering: App Router (hybrid SSR/SSG)
Styling: Tailwind v4 + shadcn/ui | Auth: NextAuth v5
✓ Gate 2: Development Pipeline
✓ Gate 4: Quality Checklist → 42 UI patterns (React, a11y, perf)
✓ Gate 5: Naming Conventions
✓ Gate 6: Knowledge Export → 12 rationalization detectors
✓ Gate 6.5: Skill Reconciliation
◆ Generation: Dev-skills & Config
✓ 48 steps · quality-patterns/ui.md · quality-patterns/shared.md
✓ Component testing configured (Testing Library + Vitest)
✦ Setup complete. 7/7 gates passed. AI is now UI-aware.
Обнаружение экосистемы
Gate 0 сканирует установленные адаптеры и рекомендует дополнительные модули на основе вашего стека и рабочего процесса. Устанавливайте за секунды - они автоматически регистрируются в dev-пайплайне.
◆ Gate 0: Ecosystem Discovery
Installed:
✓ forge-core v8.0.0
✓ forge-product v4.1.1
Recommended for your stack:
◇ forge-qa Test strategy orchestrator
◇ forge-tracker ClickUp/Linear/Jira sync
◇ forge-prompts Prompt architecture tools
Installing recommended adapters...
✓ forge-qa v3.8.1 installed
✓ Test skills registered in dev-pipeline
✓ Quality gates activated
✦ Ecosystem ready. 3 adapters configured.
Опишите что хотите
Без Hub нужно знать, что /forge:product должен запускаться до /forge:qa, который запускается до /dev. С Hub достаточно описать задачу на обычном языке. /forge:hub проверит какие пререквизиты есть, найдёт недостающие и построит правильную цепочку выполнения автоматически.
Автоматическое разрешение пререквизитов
Попросите платёжную систему. Hub проверит, есть ли product stories для платежей - их нет. Проверит, есть ли тест-план - его нет. Вместо того чтобы прыгать сразу к коду без контекста, Hub строит цепочку из 3 шагов: сначала спроектировать фичу, потом сгенерировать тесты из критериев приёмки, затем реализовать с TDD. Все пререквизиты решены до первой строки кода.
◆ Intent → product_feature · domain: payments
Prerequisite check:
✓ discovery → market context exists
✓ marketing → positioning exists
✗ product → no stories for payments
✗ qa → no test plan for payments
Execution chain:
1. product design "payments" → stories + acceptance criteria
2. qa test "payments" → test plan from AC
3. dev "payments" → implementation + TDD
✓ Proceed with 3 steps? Y
◆ Step 1/3: product design "payments"
✓ Generated 3 user stories, 7 acceptance criteria, 2 user flows
◆ Step 2/3: qa test "payments"
✓ Mapped 7 AC to 12 assertions · Generated 4 test files
◆ Step 3/3: dev "payments" → 6-phase TDD pipeline
✓ 12/12 tests passing · 7/7 AC covered · PR #94
✦ Chain complete. 3 steps · 12 tests · 7 AC · 0 skipped prerequisites.
Dev-пайплайн
Когда Hub направляет на разработку, /dev берёт на себя 6-фазный TDD-пайплайн. Все модули работают вместе: forge-worktree изолирует в ветке, forge-product загружает критерии приёмки, forge-qa генерирует тесты, forge-tracker синхронизирует статус - полная интеграция, ноль ручной координации.
6-фазный пайплайн с интеграцией модулей
Дайте описание фичи. Forge создаёт изолированный worktree, загружает критерии приёмки из forge-product, генерирует падающие тесты через forge-qa (делегируя на Sonnet для экономии), реализует до зелёного, запускает self-review на Haiku, проверяет покрытие AC и открывает PR - всё одной командой. Сабагенты работают на дешёвых моделях, чтобы не тратить токены Opus на механическую работу.
◆ Phase 0: Gate
Task: new-feature · ~8 files · Mode: balanced
✓ forge-worktree → branch feat/eng-142-webhook in isolated worktree
✓ forge-product → loaded 5 AC from features/payment.md
✓ forge-tracker → linked ENG-142 → In Progress
✓ Red flags: none
◆ Phase 1: Understand
Schema: WebhookEvent table · Layers: domain, infra, interface
✓ Contracts: IWebhookRepository, ProcessWebhookCommand, WebhookDto
◆ Phase 2: Test (RED)
✓ forge-qa → AC mapped to 8 assertions · dispatched test-generator (sonnet)
Generated: webhook.spec.ts (5 tests) + stripe-sig.spec.ts (3 tests)
✗ 8 tests failing - ready for implementation
◆ Phase 3: Implement (GREEN)
core.3.10: WebhookEvent entity + value objects
core.3.20: WebhookRepository (Prisma)
core.3.30: ProcessWebhookHandler + signature verification
core.3.40: WebhookController + route guards
✓ 8/8 tests passing
◆ Phase 4: Verify
✓ Type check · ✓ Lint · ✓ Quality patterns: 14/14
✓ Self-review (haiku) → 0 issues · 0 rationalization flags
✓ forge-product → AC coverage: 5/5
✓ forge-tracker → ENG-142 marked complete
◆ Phase 5: Close
✓ forge-worktree → PR #91 created, worktree cleaned
✦ Feature complete. 6 phases · 5/5 AC · 8 tests · 0 flags.
Детекторы рационализации
AI-модели обучены быть полезными - иногда слишком полезными. Когда AI-агент рационализирует пропуск best practices ("добавим тесты потом", "обработка ошибок подождёт"), 15 детекторов рационализации Forge ловят это прямо в процессе генерации и блокируют шорткат. Паттерны привязаны к вашим capabilities: API guards, database migrations, auth flows, event handling - не generic чеклисты.
⚠ Rationalization Detector Triggered
DETECTED: "Skip for now" pattern
Rule: api.quality.error-handling
What AI said:
"We can add error handling later
to keep things simple for now"
Why it matters:
→ 73% of production incidents trace to
missing error handling added "later"
✗ Blocked. Error handling is required.
✓ Generating error boundary template...
✦ Quality preserved. AI stayed on track.
Специализированные модули
Помимо setup и dev-пайплайна, у Forge есть специализированные модули для тестирования, трекинга задач, дизайна продукта, промпт-инжиниринга и полностью автономной разработки.
Генерация тестов (forge-qa)
Тесты генерируются из критериев приёмки, а не из догадок AI. forge-qa читает спецификации фич из forge-product, маппит каждый AC на конкретные assertions и генерирует тесты в 11 режимах (unit, integration, component, acceptance, e2e). Каждый тест привязан к требованию через 4-уровневую прослеживаемость: AC, use cases, UX-критерии и LLM-as-Judge оценка.
◆ Analyzing acceptance criteria...
Feature: Payment Webhook Endpoint
Source: .claude/forge/product/features/payment.md
✓ 5 acceptance criteria found
✓ 3 edge cases derived
◆ Generated tests:
src/test/
├── payment-webhook.spec.ts 5 tests
├── stripe-signature.spec.ts 3 tests
└── payment-events.e2e.spec.ts 4 tests
Running tests...
✓ 12/12 passing (1.3s)
✦ Tests traced to requirements. Not guesswork.
Синхронизация задач (forge-tracker)
Двусторонняя синхронизация между вашим трекером задач и AI-агентом. Забирайте задачи из Linear, ClickUp, Jira, GitHub или Notion - критерии приёмки попадают прямо в dev-пайплайн. После завершения реализации forge-tracker отмечает задачу как выполненную и публикует summary. Никакого копирования ticket ID, никаких ручных обновлений статуса.
◆ Syncing with Linear...
Sprint: March W2 (4 items remaining)
ENG-142 Payment webhook Urgent
ENG-138 Email notification fix High
ENG-145 Dashboard filters Medium
ENG-147 API rate limiting Medium
Picked: ENG-142 - Payment webhook
✓ Status → In Progress
✓ Branch: feat/eng-142-payment-webhook
✓ Acceptance criteria loaded (5 items)
✦ Task synced. AI has full context.
Агент-команды (forge-autopilot)
Финальный уровень. Forge анализирует бэклог, определяет файловые конфликты между фичами, группирует их в параллельные волны и запускает AI-команды в изолированных git worktree. Агент-техлид координирует, а тиммейты независимо выполняют полный /dev пайплайн. 3 режима автономности: supervised (вы подтверждаете каждый PR), semi-auto (зелёные PR мерджатся автоматически), full-auto (hands-off выполнение спринта).
◆ Phase 1: Triage
Analyzing backlog: 6 features classified
✓ 4 parallelizable, 2 sequential
◆ Phase 2: Wave Planning
Wave 1 (parallel):
● Team A → ENG-142 Payment webhook
● Team B → ENG-145 Dashboard filters
● Team C → ENG-147 Rate limiting
◆ Phase 3: Executing Wave 1...
Team A: ████████████░░ 85% (GREEN)
Team B: ██████████████ 100% ✓ PR #89
Team C: ██████░░░░░░░░ 45% (RED)
✦ 2/3 features complete. 12 min elapsed.
И это не всё
forge-product
Дизайн фич с user stories, критериями приёмки, UX-флоу
forge-prompts
Промпт-инжиниринг с фреймворками CO-STAR, RISEN, TIDD-EC
forge-worktree
Жизненный цикл git worktree - параллельные ветки, нулевые конфликты портов
9 Advisory-модулей
Discovery, marketing, analytics, SEO, copy, onboarding, growth, A/B-тесты
Начните строить лучше
Всё, что вы видели, выполняется менее чем за 10 секунд. Артефакты хранятся в .claude/ - они работают с Claude Code, Cursor, Windsurf и любым AI-агентом. Удалите Forge после настройки - артефакты работают автономно.
EUR 29
Starter - core + worktree
EUR 79
Pro - + product, QA, tracker, prompts
EUR 149
Complete - все 15+ модулей