Skip to content

lee-to/ai-factory

Repository files navigation

Version Official Site Tests

logo

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.

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 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

Installation

Using npm

npm install -g ai-factory

Using mise

mise use -g npm:ai-factory

Quick Start

# In your project directory (interactive wizard)
ai-factory init

# Or non-interactive with flags
ai-factory init --agents claude,codex --mcp playwright,github

This will:

  • Ask which AI agent you use (or use --agents flag)
  • Install relevant skills (or use --skills flag)
  • Configure MCP servers (or use --mcp flag)

Then open your AI agent and start working:

/aif

Need CLI flags, update/upgrade details, or extension commands? See Getting Started. Need slash-command reference? See Core Skills.

Example Workflow

# Explore options and requirements before planning (optional)
/aif-explore Add user authentication with OAuth

# Need a strictly verified answer before changing anything?
/aif-grounded Does this repo already support OAuth providers?

# 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

# Create a knowledge reference from docs AI doesn't know about
/aif-reference https://docs.example.com/api-reference --name example-api

# 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 with diagram and decision table.


Documentation

Guide Description
Getting Started What is AI Factory, supported agents, CLI commands
Development Workflow Workflow diagram, when to use explore vs grounded, spec-driven approach
Reflex Loop Iterative generate → evaluate → critique → refine workflow
Subagents Claude Code only: repo-local planning, implementation, and loop subagents with narrow role contracts
Core Skills All slash commands — explore, grounded, plan, fix, implement, evolve, docs, and more
Quality Gates Machine-readable aif-gate-result summaries for verify, review, security, and rules gates
Skill Evolution How /aif-fix patches feed into /aif-evolve to generate smarter skill rules
Plan Files Plan files, self-improvement patches, skill acquisition
Security Two-level security scanning for external skills
Extensions Writing and installing extensions — commands, injections, MCP, agents
Configuration .ai-factory.json, MCP servers, project structure, best practices
Config Reference Full config.yaml key reference and skill read/write matrix

Links

License

MIT

About

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.

Topics

Resources

Contributing

Security policy

Stars

Watchers

Forks

Contributors