{"id":44091740,"url":"https://github.com/lee-to/ai-factory","last_synced_at":"2026-02-26T18:40:42.121Z","repository":{"id":336827601,"uuid":"1151301762","full_name":"lee-to/ai-factory","owner":"lee-to","description":"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.","archived":false,"fork":false,"pushed_at":"2026-02-25T17:57:51.000Z","size":21809,"stargazers_count":291,"open_issues_count":4,"forks_count":36,"subscribers_count":10,"default_branch":"2.x","last_synced_at":"2026-02-25T19:54:31.009Z","etag":null,"topics":["ai","ai-agents","ai-skills","spec-driven-development"],"latest_commit_sha":null,"homepage":"https://aif.cutcode.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lee-to.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/security.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-02-06T09:47:40.000Z","updated_at":"2026-02-25T17:57:55.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/lee-to/ai-factory","commit_stats":null,"previous_names":["lee-to/ai-factory"],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/lee-to/ai-factory","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lee-to%2Fai-factory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lee-to%2Fai-factory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lee-to%2Fai-factory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lee-to%2Fai-factory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lee-to","download_url":"https://codeload.github.com/lee-to/ai-factory/tar.gz/refs/heads/2.x","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lee-to%2Fai-factory/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29867604,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-26T18:27:06.972Z","status":"ssl_error","status_checked_at":"2026-02-26T18:26:57.848Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agents","ai-skills","spec-driven-development"],"created_at":"2026-02-08T11:11:02.137Z","updated_at":"2026-02-26T18:40:42.114Z","avatar_url":"https://github.com/lee-to.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.npmjs.com/package/ai-factory\"\u003e\n    \u003cimg src=\"https://img.shields.io/npm/v/ai-factory?label=version\" alt=\"Version\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://aif.cutcode.dev/\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/official%20site-aif.cutcode.dev-0ea5e9\" alt=\"Official Site\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/lee-to/ai-factory/actions/workflows/ci.yml\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/lee-to/ai-factory/ci.yml?branch=2.x\u0026label=tests\" alt=\"Tests\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n![logo](https://github.com/lee-to/ai-factory/raw/2.x/art/promo.png)\n\n# AI Factory\n\n\u003e **Stop configuring. Start building.**\n\nYou 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.\n\n**One command. Full AI-powered development environment.**\n\n```bash\nai-factory init\n```\n\n---\n\n## Why AI Factory?\n\n- **Zero configuration** — installs relevant skills, configures integrations\n- **Best practices built-in** — logging, commits, code review, all following industry standards\n- **Spec-driven development** — AI follows plans, not random exploration. Predictable, resumable, reviewable\n- **Community skills** — leverage [skills.sh](https://skills.sh) ecosystem or generate custom skills\n- **Stack-agnostic** — works with any language, framework, or platform\n- **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)\n\n---\n\n## Installation\n\n### Using npm\n\n```bash\nnpm install -g ai-factory\n```\n\n### Using mise\n\n```bash\nmise use -g npm:ai-factory\n```\n\n## Quick Start\n\n```bash\n# In your project directory\nai-factory init\n```\n\nThis will:\n- Ask which AI agent you use\n- Install relevant skills\n- Configure MCP servers (for supported agents)\n\nThen open your AI agent and start working:\n\n```\n/aif\n```\n\n## Usage\n\nIf the package is installed:\n```bash\nai-factory init\n```\n\nOr running without installation via `npx`:\n```bash\nnpx ai-factory init\n```\n\n### Upgrading from v1 to v2\n\n```bash\n# 1) Update the CLI package\nnpm install -g ai-factory@latest\n\n# 2) Migrate existing skills to v2 naming\nai-factory upgrade\n```\n\n`ai-factory upgrade` removes old bare-named skills (`commit`, `feature`, etc.) and installs new `aif-*` prefixed versions. Custom skills are preserved.\n\n### Example Workflow\n\n```bash\n# Explore options and requirements before planning (optional)\n/aif-explore Add user authentication with OAuth\n\n# Plan a feature — creates branch, analyzes codebase, builds step-by-step plan\n/aif-plan Add user authentication with OAuth\n\n# Optionally refine the plan with deeper analysis\n/aif-improve\n\n# Execute the plan — implements tasks one by one, commits at checkpoints\n/aif-implement\n\n# Fix a bug — AI learns from every fix and gets smarter over time\n/aif-fix TypeError: Cannot read property 'name' of undefined\n\n# Set up CI pipeline — GitHub Actions or GitLab CI with linting, SA, tests\n/aif-ci github\n\n# Generate project documentation — README + docs/ with topics\n/aif-docs\n```\n\nSee the full [Development Workflow](docs/workflow.md) with diagram and decision table.\n\n### Auto-Generated Documentation\n\nAI Factory can generate and maintain your project docs with a single command:\n\n```bash\n/aif-docs          # Creates README + docs/ structure from your codebase\n/aif-docs --web    # Also generates a static HTML documentation site\n```\n\n- **Generates docs from scratch** — analyzes your codebase and creates a lean README + detailed `docs/` pages by topic\n- **Cleans up scattered files** — finds loose CONTRIBUTING.md, ARCHITECTURE.md, SETUP.md in your root and consolidates them into a structured `docs/` directory\n- **Keeps docs in sync** — integrates with `/aif-implement` so documentation is updated automatically after each feature\n- **Builds a docs website** — `--web` generates a static HTML site with navigation and dark mode, ready to host\n\n---\n\n## Documentation\n\n| Guide | Description |\n|-------|-------------|\n| [Getting Started](docs/getting-started.md) | What is AI Factory, supported agents, CLI commands |\n| [Development Workflow](docs/workflow.md) | Workflow diagram, when to use what, spec-driven approach |\n| [Reflex Loop](docs/loop.md) | Iterative generate → evaluate → critique → refine workflow |\n| [Core Skills](docs/skills.md) | All slash commands — explore, plan, fix, implement, evolve, docs, and more |\n| [Plan Files](docs/plan-files.md) | Plan files, self-improvement patches, skill acquisition |\n| [Security](docs/security.md) | Two-level security scanning for external skills |\n| [Extensions](docs/extensions.md) | Writing and installing extensions — commands, injections, MCP, agents |\n| [Configuration](docs/configuration.md) | `.ai-factory.json`, MCP servers, project structure, best practices |\n\n---\n\n![happy](https://github.com/lee-to/ai-factory/raw/2.x/art/happy.png)\n\n## Links\n\n- [Official Website](https://aif.cutcode.dev) - AI Factory website\n- [skills.sh](https://skills.sh) - Skill marketplace\n- [Agent Skills Spec](https://agentskills.io) - Skill specification\n- [Claude Code](https://claude.ai/code) - Anthropic's AI coding agent\n- [Cursor](https://cursor.com) - AI-powered code editor\n- [OpenCode](https://opencode.ai) - Open-source AI coding agent\n- [Roo Code](https://roocode.com) - AI coding agent for VS Code\n- [Kilo Code](https://kilo.ai) - Open-source agentic coding platform\n- [Windsurf](https://windsurf.com) - AI-powered code editor by Codeium\n- [Warp](https://www.warp.dev) - Intelligent terminal with AI agent\n- [Zencoder](https://zencoder.ai) - AI coding agent for VS Code and JetBrains\n- [Codex CLI](https://github.com/openai/codex) - OpenAI's coding agent\n- [Gemini CLI](https://github.com/google-gemini/gemini-cli) - Google's coding agent\n- [Antigravity](https://antigravity.dev) - AI coding agent\n- [Junie](https://www.jetbrains.com/junie/) - JetBrains' AI coding agent\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flee-to%2Fai-factory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flee-to%2Fai-factory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flee-to%2Fai-factory/lists"}