# Lights-on Software Factory

> Boilerplate for running a lights-on software factory with Claude Code using a sandbox container, command regulator, lint hooks, and a deterministic workflow orchestrator.

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.

## Features
- Sandboxed container for running Claude Code, sharing only the workspace directory
- Deterministic bash command regulator with automated approve/deny and guidance
- PostToolUse lint hook with custom eslint rules and helpful error messages
- Basic planning and implementation workflow commands
- Deterministic multi-agent workflow script generator
- Plan validation and progress/resume support
- Worker, gate, and check agents
- Example project with tests

## Integrations
Claude Code, Docker, ESLint, Node.js

## Platforms
API, CLI

## Pricing
Open Source

## Links
- Website: https://github.com/gojko/lights-on-software-factory
- Documentation: https://github.com/gojko/lights-on-software-factory/blob/master/GETTING-STARTED.md
- Repository: https://github.com/gojko/lights-on-software-factory
- EveryDev.ai: https://www.everydev.ai/tools/lights-on-software-factory