About Dark Factory KB
A compiled knowledge base documenting the three major autonomous AI agent factory systems:
- **Kelly Factory** — the operator's autonomous factory inspired by the Kelly handbook, built on OpenClaw with named sub-agents (Router, Carson, Mary, Sally, Amelia, Phil), 5-layer memory, and pipeline-based workflow
- **Gas Town** (Steve Yegge) — Multi-agent dark factory with Mayor, Crew, Polecats, Deacon, and Witness roles. GUPP hook enforcement, Beads audit substrate, adversarial multi-agent quality
- **Yuki AI CEO** — Judy Win, AI CEO of Yuki Capital. GitHub-as-brain, 3-tier authority matrix, autonomous production loops, progressive disclosure memory
Architecture
The KB lives in dark-factory-kb/ with:
- `compiled/sources/` — 38 compiled markdown articles, each as `.md` + generated `.html`
- `scripts/generate-html.py` — generates styled HTML wrappers from markdown
- `scripts/header.py` — shared nav header, single source of truth for all pages
- `scripts/deploy.sh` — deploy to Cloudflare Pages (one command)
Naming Conventions
- `index.html` — home page (structured wiki index, served at `/` by CF Pages)
- `all-pages.html` — flat alphabetical list of all articles
- `sources.html` — source attribution index
- `{slug}.html` — individual wiki article pages
Adding New Articles
- Add `.md` file to `compiled/sources/`
- Run `python3 scripts/generate-html.py` to generate HTML wrappers
- Run `bash scripts/deploy.sh` to publish
Source Files
All source .md files are in compiled/sources/. HTML is generated on-demand — the .md files are canonical.
Acknowledgments
Kelly factory patterns derived from Kelly handbook chapters and tweet threads. Gas Town from Steve Yegge's public essays. Yuki AI CEO from Romain Simon and Judy Win's public blog series.