A dark factory is a factory that can keep working with little human help. This project brings that idea to software development: AI agents plan, write code, test, review, open PRs and merge them.
You provide a planning folder describing what to build. The first bootstrap pull request runs with human supervision and is merged manually. After that, Dark Factory handles the rest.
You control each run with two limits:
- Parallel task limit: how many tasks can run at the same time. Defaults to 3.
- Run task limit: how many tasks Dark Factory handles in one run. Defaults to unlimited.
Note: The interactive system flow is best viewed on desktop.
| Part | Purpose |
|---|---|
| Dark Factory | Coordinates tasks, workers, merges, recovery, and cleanup |
| Agent Orchestrator | Manages workers, worktrees, processes, and logs |
| worktree-compose | Isolates Docker Compose services and ports for each worktree |
| AO Plugins | Connect AO workers to Archon and report their lifecycle to Dark Factory |
| Archon | Runs step-by-step agent workflows: prompt -> shell command -> prompt -> ... |
| Archon Workflows | Runs implementation with auto-feature, review cleanup with auto-squash, and merge readiness with merge-gate |
| Superpowers | Guides feature planning and implementation inside Archon workflows |
| Dark Factory Skill | Teaches your agent how to use Dark Factory |
| Planning Templates | Help create the project context, roadmap, and bootstrap |
Model defaults: The bundled Archon workflows use Codex gpt-5.5 with
high reasoning effort. See Setup to
change them.
Linux is the only currently supported platform.
-
Complete the setup guide.
-
Create the target repository's
planning/folder by following the planning guide. -
Complete T000 by following the target repository's
planning/bootstrap.mdwith human supervision. Merge its pull request manually, mark T000 complete, and update localmainfromorigin/main. Do not run Dark Factory before this gate is complete. -
Open Codex in the target repository and ask:
Start
$dark-factorywith 3 concurrent tasks.
Documentation: Setup | Planning | System Flow | Architecture | Dependencies | Planning Contract | Operator Guide | Distribution