Agent Forge

Scaffold projects pre-wired for Claude Code multi-agent workflows

Русский · English

Одна команда — и у тебя готовое монорепо с командой AI-агентов: PM планирует, разработчик пишет код, тестировщик проверяет, ревьюер смотрит diff. Всё работает через локальный Claude Code CLI, без API-ключей.

# Установи глобально
npm i -g @delightvlg/agent-forge

# Создай проект (интерактивный режим)
agentforge new my-app

# Или без установки — через npx / pnpm
npx @delightvlg/agent-forge new my-app
pnpm dlx @delightvlg/agent-forge new my-app

cd my-app && pnpm install
claude                    # открой Claude Code
> /init-project           # интервью → заполнит стек и настроит проект

При запуске agentforge new CLI проведёт тебя через интерактивную настройку:

1. Структура проекта — выбери нужные слои: backend, web, mobile. CLI автоматически подберёт правильный шаблон.
2. Выбор скиллов — для каждого слоя выбери технологии и best practices, которые должны знать твои агенты. Скиллы — это .md-инструкции, которые учат агентов как именно писать код для твоего стека.

Что такое скиллы?

Скиллы — это курированные гайды по лучшим практикам, которые попадают в .claude/skills/. Каждый скилл содержит правила, паттерны и анти-паттерны для конкретной технологии. Когда агент работает с твоим кодом, он следует этим инструкциям — результат: консистентный, идиоматичный, production-ready код.

| Категория | Скиллы | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Backend | NestJS, Express, TypeScript, PostgreSQL, Prisma, TypeORM, Drizzle, Redis, GraphQL, REST API, Backend Testing, BullMQ (Queues), S3 / Object Storage | | Frontend | React, Next.js, Vite + React, Tailwind CSS, TypeScript, Zustand, React Query, React Hook Form + Zod, Frontend Testing, Accessibility, Component Design, Performance, Storybook | | Mobile | React Native, Expo, Expo Router, React Navigation, RN Testing Library, App Store / Google Play | | Common | Monorepo, Docker, CI/CD, Auth (JWT/OAuth2), Conventions, Git Flow, Security, Error Handling, Logging & Observability, Environment & Config |

Добавить скилл в существующий проект можно в любой момент:

agentforge add skill prisma

С --yes CLI использует разумные умолчания (без вопросов). С -s nestjs,prisma,react можно передать скиллы явно.

Agent Forge создаёт монорепо на pnpm workspaces с полностью настроенной инфраструктурой для AI-разработки:

Агенты

| Агент | Роль | | --------------------- | -------------------------------- | | project-manager | Декомпозиция задач, планирование | | context-collector | Сбор стека и конвенций проекта | | backend-dev | Разработка серверной части | | web-dev | Разработка веб-интерфейса | | mobile-dev | Разработка мобильного приложения | | tester | Прогон тестов, проверка AC | | codex-reviewer | Внешнее ревью через OpenAI Codex |

Структура

.claude/
  agents/       ← конфиги агентов
  commands/     ← /plan /implement /review /status
  skills/       ← переиспользуемые инструкции
.agent-memory/
  project.md    ← стек + конвенции
  session-log.md
  tasks/        ← задача = файл
  decisions/    ← ADR-записи
apps/
  backend/      ← если выбран backend
  web/          ← если выбран web
  mobile/       ← если выбран mobile (Expo)
packages/
  shared/       ← общие типы (web + mobile)

Стек-агностично: шаблон не навязывает фреймворк. При первом /init-project интервью определяет платформы и наполняет .agent-memory/project.md реальным стеком.

После создания проекта, весь процесс разработки проходит через цепочку AI-агентов:

  ┌─────────────────┐
  │  Твоя идея      │
  └────────┬────────┘
           ▼
  ┌──────────────────────────────────────────────────┐
  │  Project Manager                        (opus)   │
  │  Уточняет требования → декомпозирует на задачи   │
  │  → создаёт файлы в tasks/ → GitHub Issues        │
  └────────┬─────────────────────────────────────────┘
           ▼
  ┌──────────────────────────────────────────────────┐
  │  Dev Agent (backend / web / mobile)    (sonnet)  │
  │  Реализует задачу + пишет тесты                  │
  └────────┬─────────────────────────────────────────┘
           ▼
  ┌──────────────────────────────────────────────────┐
  │  Tester                                (sonnet)  │
  │  Прогоняет тесты → pass/fail + покрытие AC       │
  └────────┬─────────────────────────────────────────┘
           ▼
  ┌──────────────────────────────────────────────────┐
  │  Codex Reviewer                        (sonnet)  │
  │  Ревью диффа → APPROVE / REQUEST_CHANGES         │
  └────────┬─────────────────────────────────────────┘
           ▼
  ┌───────────────────┐
  │  PR → Ты мерджишь │
  └───────────────────┘

agentforge new <name>                     # интерактивно
agentforge new <name> --yes --no-install  # без вопросов
agentforge new <name> -t default          # выбрать шаблон
agentforge new <name> --lang en           # язык CLI

| Флаг | По умолчанию | Описание | | -------------------------- | :----------: | ------------------------ | | -t, --template <name> | default | Пресет (см. ниже) | | --git / --no-git | спрашивает | Инициализировать git | | --install / --no-install | спрашивает | Запустить pnpm install | | -y, --yes | false | Принять все умолчания | | --lang <en\|ru> | авто | Язык интерфейса CLI |

Доступные пресеты для --template: default (backend + web + mobile), backend-web, backend-mobile, web-mobile, backend-only, web-only, mobile-only, minimal. В интерактивном режиме CLI сам подбирает пресет по выбранным платформам — любая комбинация валидна.

Локализация

CLI определяет язык автоматически: флаг --lang → переменная AGENTFORGE_LANG → системная локаль → английский.

AGENTFORGE_LANG=ru agentforge new my-app   # через env
agentforge --lang ru new my-app            # через флаг

Agent Forge рассчитывает на:

• Claude Code CLI — основной движок агентов
• Codex CLI (опционально) — внешнее ревью
• gh CLI (опционально) — работа с GitHub Issues / PR

API-ключ Claude не нужен — всё работает через локальный Claude Code.

pnpm install
pnpm dev new /tmp/smoke --yes --no-install --no-git   # запуск из исходников
pnpm build                                             # сборка в dist/
pnpm smoke                                             # E2E smoke-тест

src/                    исходники CLI (TypeScript, ESM)
  index.ts              точка входа
  commands/new.ts       команда `agentforge new`
  lib/                  copy-template, render, paths
  i18n/                 en.ts, ru.ts, index.ts
templates/
  _base/                общий корень (CLAUDE.md.hbs, .claude/, .agent-memory/, scripts, configs)
  _apps/                по одной папке на платформу (backend / web / mobile)
  _shared/              скиллы + агенты, подключаются в .claude/ по запросу
  minimal/              самостоятельный минимальный пресет (без apps/)
packages/
  create-agent-forge/   пакет для `pnpm create`
scripts/
  smoke.mjs             E2E smoke-тест

Любой пресет с платформами (default, backend-web, backend-mobile, web-mobile, backend-only, web-only, mobile-only) собирается на лету из _base + нужных _apps/*. minimal вынесен отдельно, потому что у него свой package.json / lefthook.yml.

MIT · Made by Sergey Kompanietc