harness-multiagents

黑灯工厂 (Harness Multi-Agent System)

English | 中文

---

English

What is 黑灯工厂?

黑灯工厂 (Black-light Factory) is a human-AI collaborative software generation system — orchestrate multiple specialized AI Agents in a pipeline from requirements to delivery. It implements the Harness Engineering philosophy: humans own strategic decisions, AI Agents handle execution and review.

32 skills covering the full E2E pipeline (v2), following acceptance-driven development with a strict TDD iron law (no failing test, no production code).

Supported Platforms

Platform	Status	Guide
Claude Code (Anthropic)	Primary	Installation
Codex (OpenAI)	Supported	Installation
OpenCode	Supported	Installation

Installation

Claude Code

Prerequisites: Claude Code installed.

Step 1: Create project structure

mkdir -p _context/memory/sw-shared
mkdir -p _context/memory/sw-controller

Step 2: Configure

Create _context/config.yaml:

sw:
  architecture: "monolith"              # or "microservices"
  business_domain: "general"            # general | fintech | ecommerce | internal-tools
  min_iteration_before_human: 3
  enabled_reviewers: "security,logic,performance"
  knowledge_base_auto_update: true
  merge_strategy: "merge"

Create _context/config.user.yaml:

communication_language: Chinese
user_name: Your Name

Step 3: Copy skills

Copy the skills/ directory from this repo into your project root. Minimum required skills: sw-controller, sw-tdd-agent, sw-reviewer-logic, sw-worktree-controller.

Step 4: Update .gitignore

echo ".worktree/" >> .gitignore
echo "_context-output/" >> .gitignore

Step 5: Start developing

/sw-controller I want to add a health check endpoint to the project

Codex (OpenAI)

See docs/INSTALL-codex.md for the full guide.

Quick install:

mkdir -p ~/.agents/skills
ln -s /path/to/harness/services/multiagents/skills ~/.agents/skills/harness

Enable multi-agent support in ~/.codex/config.toml:

[features]
multi_agent = true

Skills are auto-discovered on restart. Invoke by name: sw-controller, sw-tdd-agent, etc.

OpenCode

See docs/INSTALL-opencode.md for the full guide.

Quick install — add to opencode.json:

{
  "plugin": ["harness@git+https://github.com/wenxueliu/harness.git"]
}

Or point to a local clone:

{
  "plugin": ["./services/multiagents/.opencode/plugins"]
}

Restart OpenCode. All skills auto-register.

Quick Start

Four scenarios — pick your starting point:

Scenario	Start Here
I have an existing project	See Scenario A
I'm starting a new project from scratch	See Scenario B
I have multiple microservices	See Scenario C
I just want a 5-minute tour	Run /sw-controller demo mode

Detailed walkthrough: docs/quickstart-en.md

Agent Architecture (v2)

sw-controller (Orchestrator: Intent Gate + Phase Transition + Delegation)
  │
  ├── [需求层 Ideation]
  │     sw-requirements-clarifier / sw-value-judgment
  │
  ├── [规划层 Planning]
  │     sw-strategic-planner
  │       ├── sw-pre-planning-consultant
  │       ├── sw-plan-reviewer
  │       ├── sw-codebase-explorer
  │       └── sw-external-researcher
  │
  ├── [设计层 Design]
  │     sw-brainstorming
  │     sw-feature-designer → sw-service-designer × N → sw-e2e-designer
  │
  ├── [拆分层 Decomposition]
  │     sw-task-decomposer
  │
  ├── [执行层 Execution]
  │     sw-plan-executor
  │       └── sw-worktree-controller × N
  │             └── sw-tdd-agent
  │                   ├── sw-reviewer-logic / security / performance / context
  │     sw-receiving-review
  │
  ├── [测试层 Test]
  │     sw-integration-tester
  │
  ├── [交付层 Delivery]
  │     sw-delivery-manager
  │
  ├── [咨询层 Consultation]
  │     sw-strategic-advisor / sw-codebase-explorer / sw-external-researcher / sw-media-interpreter
  │
  └── [基础设施层 Infrastructure]
        sw-setup / sw-knowledge-agent / sw-systematic-debugging
        sw-verification-before-completion / sw-finishing-branch / sw-document-project
        sw-writing-skills / using-harness

Directory Layout