Lights-on software factory: take one small change through a reviewable plan

A plan you can inspect

The workflow separates impact analysis, plan creation and execution. A generated plan sidecar describes the steps, while an append-only progress record helps resume partial work. The accompanying guide supplies a small original task and an independent answer key.

Factory planning and execution ↗

Checks still need a reviewer

Role rules restrict top-level tool calls and gates check changes. A permitted make recipe can contain commands beyond the top-level match. Review the scripts, mounted paths, final diff and failures before using this with a consequential project.

Factory command regulator ↗Factory container setup ↗

What you can do

1. Read the setup and workflow documents, then use the guide’s fictional shipping-label task to evaluate one bounded change. Open reference ↗

Where the evidence stops

The documentation was inspected. The container, agent workflow and creator’s productivity claims were not tested here. The original acceptance fixture is an exercise to run and verify yourself.

Sources read. Repository documentation checked October 20, 2026 UTC. The original exercise below has not been run through the factory. No external project, container or coding agent was executed in this review.

Sources & further reading