Repolode
Submit
gojko

gojko/lights-on-software-factory

A boilerplate for running a lights-on software factory with Claude Code, including a sandbox, bash command regulator, lint hooks and a multi-agent workflow generator.

View on GitHub
Stars
67
Forks
7
Open issues
1
Last commit
yesterday

What is it?

This repository is a starting template for running a software factory with Claude Code, where AI agents do most of the implementation work with limited human review. It bundles a container for running Claude Code with only the workspace directory shared with the host, so the agent's access stays contained.

To cut down on approval prompts and repeated review feedback, it adds a deterministic bash command regulator that approves or denies commands based on project rules, and a PostToolUse hook that runs ESLint on every JavaScript file Claude edits and returns error messages to guide the agent. It also includes a simple planning and implementation workflow and a script generator that turns a plan into a multi-agent workflow, handling gates and testing steps without spending model tokens on that mechanical work.

The workspace contains a sample JavaScript project with tests and lint setup, which you can replace with your own code. The author says the orchestrator approach reduced token spend on the Votito project compared with plain Claude workflow execution.

Key features

  • 01Runs Claude Code in a container that shares only the workspace directory with the host.
  • 02Auto-approves or denies bash commands by project-specific rules, with guidance when blocked.
  • 03Runs ESLint on each JavaScript file Claude edits and feeds errors back to the agent.
  • 04Provides a basic plan-then-implement workflow with slash commands.
  • 05Generates multi-agent workflow scripts from plans, including gates and tests.

Use cases

  • Setting up a sandboxed environment for running Claude Code on a project.
  • Reducing repeated approval prompts by encoding command rules in a regulator.
  • Encoding recurring code review feedback as custom ESLint rules for agents.
  • Starting a new AI-driven development project from a working template.

Quick start

  1. 1

    Set up the container and run a first change by following GETTING-STARTED.md

  2. 2

    Start Claude Code in the workspace directory

    make claude

Things to know

  • Requires a container setup and Claude Code, so it is tied to Claude Code workflows.
  • The included planning and implementation workflow is a trivial example meant to be replaced.
  • Several components (sandbox, regulator, linter hook, orchestrator) must be configured before use.

Topics

#claude-code#ai-agents#software-factory#eslint#docker#workflow-automation#llm-tooling

FAQ

What is lights-on-software-factory?
A boilerplate for running a lights-on software factory with Claude Code, including a sandbox, bash command regulator, lint hooks and a multi-agent workflow generator. This repository is a starting template for running a software factory with Claude Code, where AI agents do most of the implementation work with limited human review. It bundles a container for running Claude Code with only the workspace directory shared with the host, so the agent's access stays contained.
Is lights-on-software-factory free to use? What license does it have?
lights-on-software-factory is open source under the MIT license. Check the license terms before using it in commercial products.
Is lights-on-software-factory still maintained?
Actively maintained. The last commit to lights-on-software-factory was on Oct 20, 2026.
What can I use lights-on-software-factory for?
Setting up a sandboxed environment for running Claude Code on a project. Reducing repeated approval prompts by encoding command rules in a regulator. Encoding recurring code review feedback as custom ESLint rules for agents. Starting a new AI-driven development project from a working template.
How do I install lights-on-software-factory?
Set up the container and run a first change by following GETTING-STARTED.md Start Claude Code in the workspace directory: make claude
Where can I get lights-on-software-factory?
The source code and installation instructions are on GitHub: https://github.com/gojko/lights-on-software-factory

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects