https://github.com/lee-to/ai-factory
You want to build with AI, but setting up the right context, prompts, and workflows takes time. AI Factory handles all of that so you can focus on what matters — shipping quality code.
https://github.com/lee-to/ai-factory
ai ai-agents ai-skills spec-driven-development
Last synced: about 2 months ago
JSON representation
You want to build with AI, but setting up the right context, prompts, and workflows takes time. AI Factory handles all of that so you can focus on what matters — shipping quality code.
- Host: GitHub
- URL: https://github.com/lee-to/ai-factory
- Owner: lee-to
- Created: 2026-02-06T09:47:40.000Z (2 months ago)
- Default Branch: 2.x
- Last Pushed: 2026-02-25T17:57:51.000Z (about 2 months ago)
- Last Synced: 2026-02-25T19:54:31.009Z (about 2 months ago)
- Topics: ai, ai-agents, ai-skills, spec-driven-development
- Language: TypeScript
- Homepage: https://aif.cutcode.dev
- Size: 20.8 MB
- Stars: 291
- Watchers: 10
- Forks: 36
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Security: docs/security.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# AI Factory
> **Stop configuring. Start building.**
You want to build with AI, but setting up the right context, prompts, and workflows takes time. AI Factory handles all of that so you can focus on what matters — shipping quality code.
**One command. Full AI-powered development environment.**
```bash
ai-factory init
```
---
## Why AI Factory?
- **Zero configuration** — installs relevant skills, configures integrations
- **Best practices built-in** — logging, commits, code review, all following industry standards
- **Spec-driven development** — AI follows plans, not random exploration. Predictable, resumable, reviewable
- **Community skills** — leverage [skills.sh](https://skills.sh) ecosystem or generate custom skills
- **Stack-agnostic** — works with any language, framework, or platform
- **Multi-agent support** — Claude Code, Cursor, Windsurf, Roo Code, Kilo Code, Antigravity, OpenCode, Warp, Zencoder, Codex CLI, GitHub Copilot, Gemini CLI, Junie, Qwen Code, or [any agent](docs/getting-started.md#supported-agents)
---
## Installation
### Using npm
```bash
npm install -g ai-factory
```
### Using mise
```bash
mise use -g npm:ai-factory
```
## Quick Start
```bash
# In your project directory
ai-factory init
```
This will:
- Ask which AI agent you use
- Install relevant skills
- Configure MCP servers (for supported agents)
Then open your AI agent and start working:
```
/aif
```
## Usage
If the package is installed:
```bash
ai-factory init
```
Or running without installation via `npx`:
```bash
npx ai-factory init
```
### Upgrading from v1 to v2
```bash
# 1) Update the CLI package
npm install -g ai-factory@latest
# 2) Migrate existing skills to v2 naming
ai-factory upgrade
```
`ai-factory upgrade` removes old bare-named skills (`commit`, `feature`, etc.) and installs new `aif-*` prefixed versions. Custom skills are preserved.
### Example Workflow
```bash
# Explore options and requirements before planning (optional)
/aif-explore Add user authentication with OAuth
# Plan a feature — creates branch, analyzes codebase, builds step-by-step plan
/aif-plan Add user authentication with OAuth
# Optionally refine the plan with deeper analysis
/aif-improve
# Execute the plan — implements tasks one by one, commits at checkpoints
/aif-implement
# Fix a bug — AI learns from every fix and gets smarter over time
/aif-fix TypeError: Cannot read property 'name' of undefined
# Set up CI pipeline — GitHub Actions or GitLab CI with linting, SA, tests
/aif-ci github
# Generate project documentation — README + docs/ with topics
/aif-docs
```
See the full [Development Workflow](docs/workflow.md) with diagram and decision table.
### Auto-Generated Documentation
AI Factory can generate and maintain your project docs with a single command:
```bash
/aif-docs # Creates README + docs/ structure from your codebase
/aif-docs --web # Also generates a static HTML documentation site
```
- **Generates docs from scratch** — analyzes your codebase and creates a lean README + detailed `docs/` pages by topic
- **Cleans up scattered files** — finds loose CONTRIBUTING.md, ARCHITECTURE.md, SETUP.md in your root and consolidates them into a structured `docs/` directory
- **Keeps docs in sync** — integrates with `/aif-implement` so documentation is updated automatically after each feature
- **Builds a docs website** — `--web` generates a static HTML site with navigation and dark mode, ready to host
---
## Documentation
| Guide | Description |
|-------|-------------|
| [Getting Started](docs/getting-started.md) | What is AI Factory, supported agents, CLI commands |
| [Development Workflow](docs/workflow.md) | Workflow diagram, when to use what, spec-driven approach |
| [Reflex Loop](docs/loop.md) | Iterative generate → evaluate → critique → refine workflow |
| [Core Skills](docs/skills.md) | All slash commands — explore, plan, fix, implement, evolve, docs, and more |
| [Plan Files](docs/plan-files.md) | Plan files, self-improvement patches, skill acquisition |
| [Security](docs/security.md) | Two-level security scanning for external skills |
| [Extensions](docs/extensions.md) | Writing and installing extensions — commands, injections, MCP, agents |
| [Configuration](docs/configuration.md) | `.ai-factory.json`, MCP servers, project structure, best practices |
---
## Links
- [Official Website](https://aif.cutcode.dev) - AI Factory website
- [skills.sh](https://skills.sh) - Skill marketplace
- [Agent Skills Spec](https://agentskills.io) - Skill specification
- [Claude Code](https://claude.ai/code) - Anthropic's AI coding agent
- [Cursor](https://cursor.com) - AI-powered code editor
- [OpenCode](https://opencode.ai) - Open-source AI coding agent
- [Roo Code](https://roocode.com) - AI coding agent for VS Code
- [Kilo Code](https://kilo.ai) - Open-source agentic coding platform
- [Windsurf](https://windsurf.com) - AI-powered code editor by Codeium
- [Warp](https://www.warp.dev) - Intelligent terminal with AI agent
- [Zencoder](https://zencoder.ai) - AI coding agent for VS Code and JetBrains
- [Codex CLI](https://github.com/openai/codex) - OpenAI's coding agent
- [Gemini CLI](https://github.com/google-gemini/gemini-cli) - Google's coding agent
- [Antigravity](https://antigravity.dev) - AI coding agent
- [Junie](https://www.jetbrains.com/junie/) - JetBrains' AI coding agent
## License
MIT