███████╗ █████╗  ██████╗████████╗ ██████╗ ██████╗ ██╗   ██╗
██╔════╝██╔══██╗██╔════╝╚══██╔══╝██╔═══██╗██╔══██╗╚██╗ ██╔╝
█████╗  ███████║██║        ██║   ██║   ██║██████╔╝ ╚████╔╝ 
██╔══╝  ██╔══██║██║        ██║   ██║   ██║██╔══██╗  ╚██╔╝  
██║     ██║  ██║╚██████╗   ██║   ╚██████╔╝██║  ██║   ██║   
╚═╝     ╚═╝  ╚═╝ ╚═════╝   ╚═╝    ╚═════╝ ╚═╝  ╚═╝   ╚═╝   

factory.md

A Dockerfile for code factories.

factory.md is a single markdown file that holds every standard an autonomous coding agent must follow to ship code in a repo — coding style, build environment, testing, documentation, dev environment, code quality, observability, and security — in 8 named sections.

v2 adds an optional stage layer (## stages, ## triage, ## plan) so one file can declare the whole pipeline — triage → plan → build → test → ship → monitor — not just the rules. Backward-compatible: v1 files run unchanged.

Clone a factory, run it anywhere.

Specification

The canonical spec lives in factory.md.

Examples

Full, source-cited factory files derived entirely from public material:

• examples/stripe.md — Stripe-style repo
• examples/vercel.md — Vercel-style repo

Both use the v2 stage layer; see docs/workflow.md for the pipeline.

Implementations

• Detroit — reference implementation. factory.sh reads factory.md from the repo root, injects every section into the agent prompt as rules, and dispatches bullets against a built-in check library.
• checker/ — minimal zero-dependency checker. Runs the strict (!) rules' check: commands, with --stage filtering. The deterministic slice of the spec.
• (your framework here — PRs welcome)

Contributing

Open an issue or PR. Spec changes should land as discussion first.

License

MIT — see LICENSE.