AI Factory — нулевая конфигурация для AI-разработки
📂 Исходный код на GitHubИнструмент для мгновенной настройки AI-среды разработки с навыками, MCP-интеграциями и спецификациями — поддерживает Claude Code, Cursor, Codex, Gemini CLI и другие агенты.
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