Начало работы
От нуля до AI, который понимает вашу архитектуру, за 5 минут.
Предварительные требования
Forge DevKit работает как система плагинов для AI-ассистентов кодирования. Вам нужен один из этих инструментов:
Claude Code
CLI для разработчиков от Anthropic
Рекомендуется
Claude Cowork
Десктоп-приложение с поддержкой плагинов
Cursor
AI-редактор кода
Node.js 18+ необходим для Forge CLI.
Проверьте командой node --version
Установите Forge
Выберите удобный способ установки:
Вариант A: CLI (рекомендуется)
$ npm install -g @reumbra/forge
Устанавливает команду forge глобально. Работает на всех платформах.
Вариант B: Десктоп-приложение
Скачать для вашей платформы
Выберите файл для вашей ОС в секции Assets: .exe для Windows, .dmg для macOS.
Windows (.exe)
Приложение пока не имеет цифровой подписи. Windows SmartScreen может заблокировать установку:
- Когда увидите "Система Windows защитила ваш компьютер", нажмите "Подробнее"
- Нажмите "Выполнить в любом случае"
macOS (.dmg)
Приложение пока не нотаризовано. macOS Gatekeeper заблокирует запуск:
- Откройте Системные настройки → Конфиденциальность и безопасность
- Прокрутите вниз до сообщения о заблокированном приложении
- Нажмите "Всё равно открыть"
Не доверяете неподписанным приложениям? Используйте CLI - npm install -g @reumbra/forge - тот же инструмент, установленный из npm. Цифровая подпись в планах.
Активируйте лицензию
$ forge activate FRG-XXXX-XXXX-XXXX
Используйте лицензионный ключ из письма с подтверждением покупки. Активации по тарифу: Starter 2, Pro 3, Complete 5 устройств.
Нет лицензии? Получите здесь.
Установите плагины
После активации forge автоматически устанавливает все плагины, включённые в ваш тариф. Запустите команду, чтобы увидеть вашу экосистему:
forge
✦ Forge - Plugin manager for Claude Code v0.3.8
● Licensed FRG-YGGT..TRE4 · bundle · expires Mar 6, 2027 (365d)
6 plugins installed
◆ What would you like to do?
● Manage plugins (6 installed)
○ License & devices
○ Run diagnostics
○ Deactivate
○ Exit
| Plugin | Version | Status | Description |
|---|---|---|---|
| forge-autopilot | v1.4.0 | ✓ up to date | Batch autonomous development - Agent Teams orchestration |
| forge-core | v4.13.0 | ✓ up to date | Architecture audit, quality patterns, dev-skills generation |
| forge-product | v3.9.0 | ✓ up to date | Product design module - user flows, stories, UX criteria |
| forge-qa | v3.7.0 | ✓ up to date | QA meta-tool - test generation, coverage analysis, requirement traceability |
| forge-tracker | v3.3.0 | ✓ up to date | Issue tracking integration - GitHub/Linear/Jira sync |
| forge-worktree | v1.2.0 | ✓ up to date | Git worktree lifecycle - Docker isolation, port offsets, safe teardown |
Настройте AI-окружение
Следуйте инструкциям для вашей платформы:
Claude Code
Рекомендуем запускать Claude Code с пропуском разрешений:
$ claude --dangerously-skip-permissions
Почему это безопасно с Forge?
У Forge собственная 7-этапная система качества, которая валидирует каждый шаг перед выполнением. Визард настройки читает десятки файлов, запускает команды детекции и записывает конфигурацию - стандартные запросы разрешений Claude Code потребовали бы сотни ручных нажатий "Разрешить" без реальной пользы для безопасности. Gates Forge - ваша система безопасности.
Claude Cowork
После установки плагинов они появляются в Claude Cowork, но отключены по умолчанию. Их нужно включить:
- Откройте панель Customize (иконка портфеля в левой боковой панели)
- Найдите секцию Personal plugins - вы увидите все плагины Forge как "Disabled"
- Нажмите на каждый плагин Forge и включите его
- Начните новый диалог
Совет: Не обязательно включать все плагины сразу. Начните с Forge core - это фундамент. Остальные включайте по мере необходимости.
Cursor
Устанавливайте плагины так же, как для Claude Code (шаги 1-3 выше). Cursor автоматически подхватывает установленные плагины из ~/.claude/.
После установки перезагрузите окно: Cmd+Shift+P → Developer: Reload Window.
Запустите визард настройки
Перейдите в директорию проекта и введите в чате:
/forge:setup
Визард проходит этапы последовательно - определяет экосистему, проводит аудит архитектуры, настраивает пайплайн и генерирует dev-скиллы под ваш проект.
◆ Forge Ecosystem
Your project management meta-tools. Each adapter generates artifacts
in your project's .claude/ directory and can be safely removed afterward.
| Module | Version | What it does |
|---|---|---|
| forge-core | v4.13.0 | Dev-pipeline: architecture + contracts + code |
| forge-product | v3.9.0 | Product design: user flows, stories, UX |
| forge-qa | v3.7.0 | Test strategy: coverage, acceptance tests |
| forge-tracker | v3.3.0 | Task hub: GitHub/Linear/ClickUp sync |
| forge-autopilot | v1.4.0 | Agent Teams: triage, waves, zero conflicts |
| forge-worktree | v1.2.0 | Git worktree management for isolated dev |
Legend: All 6 modules installed, none yet configured.
Commands available after setup:
| Category | Commands |
|---|---|
| Setup & Management | /forge:setup, /forge:patch |
| Smart Routing | /forge:hub "describe what you want" |
| Development | /dev |
| Product | /forge:product design/epic/roadmap/strategy |
| Testing | /forge:qa test/coverage/plan |
| Task Tracking | /forge:tracker pick/sync/close |
| Autopilot | /forge:autopilot |
| Worktrees | /forge:worktree-setup |
◆ Gate 1: Architecture Audit - Results
Stack: Astro 5.7.0 + TypeScript 5.8.0 + Tailwind CSS 4.1.0
Build: Vite │ Linter: Biome 2.0.0 │ Hosting: Cloudflare Pages
Architecture: FSD-adapted (4 layers)
Layers:
pages: src/pages/ (15 files) - assembly & routing, i18n (en + ru)
widgets: src/widgets/ (32 files, 21 widgets) - composite blocks, zero cross-imports
shared: src/shared/ (41 files) - ui(13) + config(22) + i18n(3) + lib
layouts: src/layouts/ (2 files) - BaseLayout
Conflict zones: none (0 files)
Parallel readiness: 9/10 - highly parallel
Sibling repos:
| Repo | Stack | Role | Forge? |
|---|---|---|---|
| acme-web | React 19.2+TanStack | frontend | ✓ 4.6 |
| acme-api | NestJS 11+Prisma | backend-api | ✓ 4.12 |
Всё готово
Ваш AI теперь понимает архитектуру. Дашборд показывает полную экосистему:
● Forge Ecosystem Dashboard - acme-web
| Component | Version | Status |
|---|---|---|
| forge-core | v4.13.0 | Configured |
| forge-product | v3.9.0 | Configured |
| forge-qa | v3.7.0 | Configured |
| forge-tracker | v3.3.0 | Configured |
| forge-autopilot | v1.4.0 | Active (6 batches) |
| forge-worktree | v1.2.0 | Active |
Project Profile
| Property | Value |
|---|---|
| Stack | React 19 + TanStack Start + Tailwind v4 + Vite + TypeScript strict |
| Architecture | FSD (5 layers, 13 features) |
| Pipeline | Parallel, trunk-based, conventional commits |
| Git workflow | Trunk-based with worktrees |
| CI/CD | Vercel (SSR Docker) |
| Backend | acme-api (bidirectional propagation) |
Ecosystem is fully configured and up to date. Available actions:
– /forge:hub - describe what you want, Hub routes to the right pipeline
– /forge:tracker - task management via Notion
– /forge:autopilot - batch development pipeline
– /forge:qa - testing and coverage
Начните с Hub
Введите /forge:hub "добавь платёжную систему" и опишите что хотите сделать. Hub классифицирует intent, проверит какие пререквизиты есть, и запустит нужный пайплайн автоматически. Никаких команд запоминать не нужно.
Опытные пользователи могут сразу вводить /dev, пропуская проверку пререквизитов.
Другие действия
- Запустите
/forge:setupв любой момент для дашборда или реконфигурации - Загляните в Руководство для полного справочника команд
Быстрый справочник команд
| Команда | Описание | Тариф |
|---|---|---|
| /forge:setup | Визард настройки, дашборд, обновление, реконфигурация | Starter+ |
| /forge:hub NEW | Универсальная точка входа - опишите что хотите, Hub проверит пререквизиты | Starter+ |
| /dev | Полный пайплайн разработки (генерируется после setup) | Starter+ |
| /forge:patch | Быстрые патчи конфигурации без полного визарда | Starter+ |
| /forge:product | Проектирование фич, эпики, роадмап, стратегия | Pro+ |
| /forge:qa | Стратегия тестирования, генерация тестов, анализ покрытия | Pro+ |
| /forge:tracker | Управление задачами (GitHub, Linear, ClickUp, Notion, Jira) | Pro+ |
| /forge:autopilot | Пакетная разработка с Agent Teams | Complete |
| /forge:worktree-setup | Шаблоны жизненного цикла git worktree | Starter+ |
| /forge:prompts | Промпт-инжиниринг (инвентаризация, аудит, эволюция) | Pro+ |
| Модули-советники (план Complete) | ||
| /forge:discovery | Product discovery (идеация, исследование, валидация) | Complete |
| /forge:marketing | Маркетинговая стратегия (позиционирование, цены, GTM) | Complete |
| /forge:copy | Копирайтинг бренда (генерация, ревью) | Complete |
| /forge:seo | SEO-стратегия (аудит, ключевые слова, schema) | Complete |
| /forge:analytics | Планирование аналитики (трекинг, схемы, дашборды) | Complete |
| /forge:onboarding | Дизайн онбординга (потоки активации, аудит) | Complete |
| /forge:growth | Стратегия роста (удержание, рефералы, расширение) | Complete |
| /forge:ab | A/B-эксперименты (гипотеза, дизайн, анализ) | Complete |
Готовы сделать AI осведомлённым об архитектуре?
Разовая покупка. 14 дней гарантия возврата.
Получить Forge - от €29 →Решение проблем
Плагины не отображаются?
Claude Code: Введите /exit, затем запустите claude снова. Проверьте через /plugins.
Claude Cowork: Откройте Customize → Personal plugins. Если плагины отображаются как "Disabled", нажмите на каждый и включите.
Визард зависает?
Визард сохраняет прогресс после каждого этапа. Если процесс прервался, запустите /forge:setup снова - он продолжит с того места, где остановился.
Windows SmartScreen блокирует установщик?
Нажмите "Подробнее" → "Выполнить в любом случае". Десктоп-приложение пока не имеет цифровой подписи. Если предпочитаете, используйте CLI: npm install -g @reumbra/forge.
macOS говорит "неизвестный разработчик"?
Системные настройки → Конфиденциальность и безопасность → "Всё равно открыть". Или используйте CLI.
Проблемы с активацией лицензии?
Запустите forge --diagnostics и отправьте вывод на support@reumbra.com.