Lights-On Software Factory

Lights-on software factory boilerplate for Claude Code

A starting point for running a lights-on software factory with Claude Code (humans supervising agents, deterministic checks providing guardrails instead of markdown prayers, deterministic orchestrator scheduling tasks instead of LLM inference). Based on the setup developed for
Votito, where the orchestrator reduced token spend compared to bare-bones Claude workflow execution by around 80%.

See gojko.net/slides/202609-gotocph.pdf for a quick overview.

What is in this repostory?

The purpose of this repository is to act both as a simple boilerplate setup for
new projects, and as an educational demonstration of the core concepts of
software factories:

This repository provides setup for:

1. A sandbox/container for running Claude Code in a secure environment, sharing only the workspace directory with the host. See CONTAINER.md for more information.
2. A deterministic bash command regulator, to reduce approval fatigue and ensure agents execute the commands allowed by project-specific rules. The regulator performs a deep-inspection of bash commands and provides automated approve/deny with instructions on what to do instead if blocked. See REGULATOR.md for more information. Ask Claude to add more custom rules each time it asks you for approval.
3. A deterministic linter-based feedback system for enforcing custom domain-specific rules, to help reduce human involvement in code review. A PostToolUse hook runs the linter on every JavaScript file Claude edits, and guides the agents to avoid common mistakes with helpful error messages. Ask Claude to write more custom rules each time you find yourself providing repetitive design/code feedback. Ask Claude to implement custom eslint language parsers for HTML/CSS/other file…