Lights-on Software Factory

Lights-on Software Factory is an MIT-licensed boilerplate repository by Gojko Adzic for running Claude Code as a supervised software factory. It combines a sandboxed container, a bash command regulator, a lint-on-edit hook, and a deterministic orchestrator that generates multi-agent workflow scripts. The README says it is based on the setup developed for Votito, where the orchestrator reduced token spend by around 80% compared to bare-bones Claude workflow execution.

What It Is

The repository is both a starting point for new projects and an educational demonstration of software-factory concepts: humans supervise agents, deterministic checks provide guardrails, and a deterministic orchestrator schedules tasks instead of LLM inference. A workspace directory holds the Claude Code configuration and a trivial example project.

Guardrails and Orchestration

• Sandbox: Claude Code runs in a container that shares only the workspace directory with the host.
• Bash regulator: It deeply inspects bash commands and automatically approves or denies them according to project-specific rules. When it blocks a command, it gives instructions on what to do instead, which reduces approval fatigue.
• Linter feedback: A PostToolUse hook runs eslint on every JavaScript file Claude edits and returns helpful error messages, enforcing custom domain rules and reducing human code-review effort.
• Orchestrator: Based on the plan from the implementation workflow, it generates Claude workflow scripts and structures testing and gates, moving mechanical orchestration from inference to command-line tools.

Workflow and Setup Path

A basic planning and implementation workflow is included as a simple example to build on or replace, with commands such as impact-analysis, plan-execution, execute, and regulator. Setup starts with building the container and running a first change, as described in GETTING-STARTED.md. Separate documents cover settings, the linter hook, the regulator, the orchestrator, and the container.