AI Factory — нулевая конфигурация для AI-разработки

· 1 мин чтения
ai-agents skills spec-driven-development cli-tools workflow
📂 Исходный код на GitHub

Инструмент для мгновенной настройки AI-среды разработки с навыками, MCP-интеграциями и спецификациями — поддерживает Claude Code, Cursor, Codex, Gemini CLI и другие агенты.

AI Factory — нулевая конфигурация для AI-разработки

AI Factory — это CLI-утилита, которая превращает пустую директорию проекта в полностью готовую среду для AI-разработки. Одна команда ai-factory init — и у вас есть навыки, конфигурация MCP-серверов и спецификации для spec-driven разработки.

Что это такое

Проблема, которую решает AI Factory: каждый раз, когда вы начинаете работать с AI-агентом в новом проекте, приходится тратить время на настройку. Написать правильный промпт, подключить MCP-серверы, настроить линтеры, продумать рабочий процесс. AI Factory берёт всю рутину на себя.

Проект написан на TypeScript и Shell, распространяется через npm. Лицензия MIT. На момент написания — 919 звёзд на GitHub.

Установка и запуск

npm install -g ai-factory

Альтернативный вариант через mise:

mise use -g npm:ai-factory

Запуск в директории проекта:

ai-factory init

Команда запустит интерактивный мастер, который спросит, какой AI-агент вы используете, определит стек проекта и установит нужные навыки и MCP-серверы. Можно обойтись без интерактива:

ai-factory init --agents claude,codex --mcp playwright,github

Поддерживаемые агенты

AI Factory не привязан к конкретному AI-инструменту. Поддерживаются:

  • Claude Code
  • Cursor
  • Windsurf
  • Roo Code
  • Kilo Code
  • Antigravity
  • OpenCode
  • Warp
  • Zencoder
  • Codex CLI и Codex app
  • GitHub Copilot
  • Gemini CLI
  • Junie
  • Qwen Code

Для каждого агента генерируется своя конфигурация — навыки, промпты и интеграции адаптированы под конкретную платформу.

Рабочий процесс

AI Factory строит разработку вокруг концепции spec-driven development. AI работает по заранее написанным планам, а не исследует код случайным образом.

Основные команды:

Команда Назначение
/aif-explore Исследование вариантов и требований перед планированием
/aif-grounded Строго верифицированный ответ без изменений в коде
/aif-plan Создание ветки, анализ кодовой базы и построение плана
/aif-improve Углублённый анализ и улучшение плана
/aif-implement Пошаговая реализация плана с коммитами на контрольных точках
/aif-fix Исправление багов с обучением на каждом исправлении
/aif-ci Настройка CI/CD (GitHub Actions или GitLab CI)
/aif-docs Генерация документации проекта
/aif-reference Создание справочников из внешних документов
/aif-evolve Эволюция навыков на основе накопленного опыта

Типичный цикл: explore → plan → improve → implement → fix → evolve.

Reflex Loop

Отдельный механизм — итеративный цикл generate → evaluate → critique → refine. Каждая генерация проходит оценку, критику и доработку. Это повышает качество кода, который выдаёт AI-агент.

Навыки и экосистема

Навыки (skills) — центральный концепт AI Factory. Это переиспользуемые инструкции, которые определяют, как AI-агент работает с конкретными задачами. Навыки можно брать из маркетплейса skills.sh или генерировать свои.

Механизм /aif-fix интересен тем, что каждое исправление бага генерирует патч для навыков. Со временем агент становится умнее — накапливает опыт и применяет его в будущих задачах. Команда /aif-evolve собирает эти патчи и обновляет навыки.

Безопасность

Двухуровневое сканирование внешних навыков. Перед установкой навыки из внешних источников проходят проверку безопасности. Это особенно важно, учитывая что навыки выполняют произвольные инструкции через AI-агента.

Расширения

AI Factory поддерживает расширения. Можно писать свои команды, инъекции, MCP-серверы и конфигурации агентов. Есть пример расширения aif-ext-hello в репозитории.

Конфигурация

Настройки хранятся в .ai-factory.json в корне проекта. Файл определяет, какие навыки активны, какие MCP-серверы подключены и какие правила применяются. Подробное описание всех ключей — в документации по конфигурации.

Связанные проекты

  • aif-handoff — автономная Kanban-доска, построенная на AI Factory
  • HLV — более продвинутый фреймворк от того же автора, если AI Factory кажется слишком простым
  • Agent Skills Spec — спецификация формата навыков

Для кого

AI Factory подойдёт, если вы:

  • Используете AI-агенты в повседневной разработке и устали настраивать каждый проект вручную
  • Хотите системный подход к spec-driven разработке через AI
  • Работаете в команде, где разные разработчики используют разных AI-агентов
  • Пишете навыки для AI-агентов и хотите распространять их через маркетплейс

Источник: https://github.com/lee-to/ai-factory