ProductsFactory

ProductsFactory

**A 24/7 autonomous software-development system.** ProductsFactory orchestrates Claude Code agents inside isolated Docker containers to design, implement, review, and ship features across multiple product repositories — supervised by a FastAPI project-management dashboard.

It runs a continuous cycle loop: pick a product, choose a persona (designer, coder, reviewer, …), launch a sandboxed agent session, run deterministic quality gates on the result, open a pull request, review it, and auto-merge — with a layer of rule-based supervisors that detect and recover from cascades (stuck features, review ping-pong, false success, environment failures).

⚠️ **Status: experimental / research.** This is an ambitious automation system that spends real compute and pushes real code to real repositories. Run it against repos you own, in a sandbox, with the cost and safety controls described below. Read [`SECURITY.md`](SECURITY.md) before exposing it to anything you care about.

How it works

              ┌─────────────────────────────────────────────┐
              │  Orchestrator (pf-orchestrator container)    │
              │  cycle loop ~every 60s:                      │
              │   0. trainer / on-demand persona             │
              │   1. reviewer preempt                        │
              │   2. round-robin product → launch session    │
              └───────────────┬─────────────────────────────┘
                              │ launches one sandboxed agent per cycle
                              ▼
        ┌──────────────────────────────────────────────────┐
        │  Agent container (non-root, no docker socket)     │
        │  Claude Code runs a persona session on a product  │
        │  → edits files, writes session_result.json        │
        └───────────────┬──────────────────────────────────┘
                        │ post-session pipeline (deterministic gates)
                        ▼
        lint guards · drift d