AgentHub

One Person, One Software Company.

Build a virtual development team with Claude Code, and use Harness Engineering to keep AI working with discipline.

Website · Claude Code Mastery · Quick Start

English | 繁體中文

AgentHub is not another AI chat interface.

It is a Harness Engineering system that lets you build a virtual development team with Claude Code — complete with a PM, Tech Lead, frontend developer, backend developer, and designer — and manage them like a real boss.

You give the orders. Agents execute. Hooks enforce quality. Skills standardize process. FileWatcher syncs in real time.

No prompt prayers. No "hope the AI remembers the rules." Rules live in Hooks. Agents that break them get blocked. It's that simple.

You Use Claude Code to Write Code — But Have You Ever Run Into This?

• Every new session wipes the lessons learned from the last one
• You tell the AI "don't force push," and it forgets again next time
• You spend 30 minutes crafting the perfect prompt, and the AI only follows the first three rules
• When multiple Agents work in parallel, no one knows who changed what

AgentHub doesn't solve "AI isn't smart enough." It solves "smart AI without discipline."

Why Is This Not "Just Another AI Wrapper"?

Most AI tools follow this logic: write better prompts → pray the AI complies.

AgentHub follows a different logic: replace text prayers with architectural constraints.

A good validator with a bad workflow beats a good workflow without a validator. This isn't a slogan — it's math: 5 steps at 80% success each = 33% overall. Add a validator that allows retries = 99%.

Core Architecture: Harness Engineering

Just like a race car needs more than a great engine — it needs seatbelts, guardrails, and a pit stop process.

Skill — Standardized Workflows

Reusable workflow templates that automatically load the relevant guidance when an Agent runs them.

• /sop-execute — L2 execution SOP: mandatory spec loading → implement → acceptance verification
• /sop-plan — L1 planning SOP: context loading → complexity analysis → Plan Mode decision → task breakdown
• /sop-review — L1 review SOP: load standards → code review → approve or reject
• /sop-deploy — Deploy SOP: quality checklist → pre-deploy → Gate G5
• /task-dispatch — Boss creates a task with one command, automatically written to the dev plan
• /review — Auto-detects the step and selects the appropriate review type
• /pre-deploy — Pre-deployment automated checks (CI / environment variables / Docker)
• /harness-audit — Periodic health scan scoring against seven core principles
• ...a total of 24 built-in Skills

Hook — Automated Interceptors

Not after-the-fact reminders — real-time blocking. Dangerous operations are stopped the moment they happen.

• PreToolUse: checks before command execution (blocks kill-port / --no-verify / force push main / malformed commit messages)
• PostToolUse: alerts after file modification (if a core service changes, forces .knowledge/ doc sync)
• Stop: validates before finishing (tests + type checks must pass, or the Agent cannot stop; also detects missing global Skills)

FileWatcher — Real-Time Sync

Markdown files are the database. Edit a .tasks/ file and the GUI updates instantly.

.tasks/T5.md is modified
    → chokidar detects the change
    → markdown-parser parses the file
    → DB upsert
    → eventBus broadcasts
    → Vue reactive update
    → GUI reflects the change instantly

Gate — Quality Checkpoints

G0 (Requirements Confirmation) → G1 (Design Review) → G2 (Code Review) → G3 (QA Acceptance) → G4 (Documentation Review) → G5 (Deploy Readiness) → G6 (Production Release)

You cannot proceed without passing. Not enforced by willpower — enforced by architecture.

What Does It Look Like?

An Electron desktop app with a dark theme.

Sessions — Agent Work Sessions

An embedded xterm.js terminal lets you interact with Claude Code Agents directly inside the GUI.

Task Board — Kanban-Style Task Management

A five-column kanban board with automatic status transitions. Click any card to see full task details.

Projects — Sub-Project Management

One-click Harness scaffolding with live display of task completion rate, active Sprint, and latest Gate status.

Agents — Team Member Overview

Every Agent has its own role definition, permission scope, and reporting chain.

Harness — Trigger Logs

Real-time Hook execution history with filtering, statistics, and rankings at a glance.

Team Structure

You are the Boss. Below you is your virtual software company — 9 departments, 46 Agents:

Chain of Command

Boss (You)
├── L1 Leadership (report directly to Boss)
│   ├── Product Manager        — Product strategy and roadmap
│   ├── Tech Lead              — Technical decisions and architecture
│   ├── Design Director        — UI/UX and design systems
│   ├── Marketing Lead         — Marketing strategy
│   ├── QA Lead                — Quality assurance
│   ├── Project Lead           — Project scheduling and milestones
│   ├── Operations Lead        — Studio operations
│   └── Company Manager        — Company-wide knowledge management
│
└── L2 Execution (report to L1, cannot escalate directly to Boss)

Full Department Roster

Product

Engineering

Design

Marketing

Testing

Project Management

Studio Operations

Bonus — Special Roles

Every Agent has its own role definition file (agents/definitions/), permissi