ai-factory
무엇인가
AI Factory는 AI 코딩 에이전트에 스펙 기반 개발 절차를 주입하는 프롬프트 팩이다. 규율하는 영역은 컨텍스트 구성, 계획 수립, 구현 순서, 커밋 시점, 코드 리뷰, CI 파이프라인, 문서 생성이다. 에이전트가 즉흥적으로 코드베이스를 탐색하는 대신 계획을 따라 작업하도록 절차를 고정한다.
어떻게 동작하나
동작은 설치형 CLI와 스킬 파일의 조합으로 이뤄진다. `ai-factory init`이 프로젝트에 스킬 파일을 배치하고 MCP 서버 설정을 기록한다. 이후 에이전트에서 `/aif`(Codex CLI·Codex app은 `$aif`)를 호출하면 하위 명령이 열린다. `/aif-plan`은 브랜치 생성·코드베이스 분석·단계별 계획 작성을, `/aif-implement`는 계획의 태스크를 하나씩 구현하고 체크포인트마다 커밋하는 절차를 담는다. `/aif-explore`, `/aif-grounded`, `/aif-improve`, `/aif-fix`, `/aif-ci`, `/aif-docs`, `/aif-reference`가 각각 사전 탐색, 근거 검증, 계획 보강, 버그 수정, CI 구성, 문서 생성, 외부 문서 기반 지식 참조를 맡는다.
무엇과 다른가
프롬프트를 매 작업마다 직접 작성하거나 단일 CLAUDE.md·AGENTS.md에 규칙을 몰아넣는 방식과 달리, 작업 단계별로 분리된 스킬 파일과 슬래시 명령으로 절차를 나눈다. 계획 산출물이 파일로 남아 재개와 리뷰가 가능하고, skills.sh 생태계의 커뮤니티 스킬이나 직접 생성한 스킬을 같은 구조로 추가할 수 있다. 언어·프레임워크·플랫폼에 종속되지 않는다.
어떻게 쓰나
설치는 `npm install -g ai-factory` 또는 `mise use -g npm:ai-factory`로 하고, 프로젝트 디렉터리에서 `ai-factory init`을 실행한다. 대화형 마법사가 사용할 에이전트·스킬·MCP 서버를 묻고, 비대화형은 `--agents`, `--skills`, `--mcp` 플래그로 지정한다. 설치 후 에이전트를 열고 `/aif`를 입력해 첫 작업을 시작한다. 스킬 파일만 필요하면 `npx skills add lee-to/ai-factory --skill '*'`를 쓰지만 이 경로에는 CLI 명령과 MCP 자동 구성, 에이전트 변환기, 대화형 마법사가 포함되지 않는다.
전제와 한계
Claude Code, Cursor, Windsurf, Roo Code, Kilo Code, Antigravity, OpenCode, Warp, Zencoder, Codex CLI, Codex app, GitHub Copilot, Gemini CLI, Junie, Qwen Code 등 여러 에이전트를 지원하며 Node.js/npm 또는 mise 환경이 선행돼야 한다. 스킬 파일 자체는 에이전트가 해당 파일을 읽도록 설정되어야 발동하므로, 설치 없이 파일만 복사하면 슬래시 명령 체계와 MCP 설정은 동작하지 않는다.