开发者 gojko 在 GitHub 上公开了 lights-on-software-factory 仓库,为用 Claude Code 运行「亮灯软件工厂」(lights-on software factory)提供一个起点。README 称,这套配置基于为 Votito 开发的环境,其中的编排器与基础 Claude 工作流执行相比,token 花费降低约 80%。该数字出自 README 自述。仓库既可作为新项目的简单样板,也用来演示软件工厂的核心概念。
README 说明,这个仓库有两个用途:一是给新项目当简单的起步样板,二是作为软件工厂核心概念的教学演示。仓库的 workspace 目录放着 Claude Code 的配置和一个简单的示例项目。示例模块 src/format-greeting.js 在目录说明中被标注为「replace it」,即使用者应替换成自己的代码。
根目录除 README 和 LICENSE 外,还有一组分主题的说明文档:
GETTING-STARTED.md:首次搭建与第一次改动SETTINGS.md:settings.local.json 接入了哪些设置LINTER-HOOK.md:lint 钩子与自定义 lint 规则REGULATOR.md:Bash 命令调节器ORCHESTRATOR.md:编排器的内部工作方式WORKFLOW.md:从想法到完成一次运行的用户流程CONTAINER.md:容器镜像与 root 相关目标仓库根目录的 makefile 提供一组与容器有关的目标:docker-image、init、claude、shell、test、lint 和 root。其中 make claude 会在 workspace 中启动 Claude Code。容器镜像由 vm/Dockerfile 定义,基于 Alpine,包含 Node.js、make、git 等。.claude-home 目录被 Git 忽略,用来保存容器内 Claude Code 的登录信息和历史记录。
workspace/.claude 是配置的主体,README 的目录说明列出了以下部分:
settings.local.json:包含钩子、环境变量、权限和偏好设置agents:workflow-worker、workflow-gate、workflow-check 三个 agentcommands:impact-analysis、plan-execution、execute、regulator 四个命令workflow:工具目录,src 下分为 regulator(调节器引擎与规则)、generator(计划校验器与工作流生成器)和 lint(ESLint 插件、两条规则及 lint 钩子逻辑),另有 bin 和覆盖这些工具的 tests此外,workspace 下还有存放计划与进度记录的 plans 目录、CLAUDE.md(引入 CONTRIBUTING.md),以及自带 init、test、lint 和两个工作流关卡目标的 makefile。
本文依据的是仓库 README 的开头说明和目录结构。80% 这一数字为作者在 README 中的说法。