<img src="assets/roundtable-banner.png" alt="UniOps Quantum Cycle" width="100%"> <a href="https://github.com/VarakornUnicornTech/UniOpsQC/releases"><img src="https://img.shields.io/badge/version-2.0.0-0d6efd?style=flat-square" alt="Version"></a> <img src="https://img.shields.io/github/license/VarakornUnicornTech/UniOpsQC?style=flat-square" alt="License"> <img src="https://img.shields.io/github/stars/VarakornUnicornTech/UniOpsQC?style=flat-square&color=f0a500" alt="Stars"> <img src="https://img.shields.io/github/forks/VarakornUnicornTech/UniOpsQC?style=flat-square" alt="Forks"> <img src="https://img.shields.io/github/last-commit/VarakornUnicornTech/UniOpsQC?style=flat-square" alt="Last Commit"> <img src="https://img.shields.io/badge/Claude%20Code-compatible-7c3aed?style=flat-square" alt="Claude Code compatible"> <img src="https://img.shields.io/badge/made%20in-Thailand%20🇹🇭-e63946?style=flat-square" alt="Made in Thailand"> <a href="https://discord.gg/SwYzZjru"><img src="https://img.shields.io/badge/Discord-Join%20Community-5865F2?style=flat-square&logo=discord&logoColor=white" alt="Discord"></a> ภาษาไทย / Thai: <a href="README.th.md">อ่าน README ภาษาไทย</a>

📊 Presentation <a href="docs/UniOpsPresent-EN.pdf"> <img src="docs/present-preview-en.png" width="47%" alt="UniOpsQC Presentation — English"> </a>   <a href="docs/UniOpsPresent-TH.pdf"> <img src="docs/present-preview-th.png" width="47%" alt="UniOpsQC Presentation — ภาษาไทย"> </a> <a href="docs/UniOpsPresent-EN.pdf"><img src="https://img.shields.io/badge/📊_View_Presentation-English-0d6efd?style=flat-square" alt="Presentation EN"></a>   <a href="docs/UniOpsPresent-TH.pdf"><img src="https://img.shields.io/badge/📊_View_Presentation-ภาษาไทย-e63946?style=flat-square" alt="Presentation TH"></a>

[!NOTE] Governance for Claude Code — ship with confidence, not just speed. A structured multi-team AI governance framework that turns Claude Code into a coordinated engineering organization with specialized teams, approval gates, automated policy enforcement, and full audit trail.

By Unicorn Tech Integration Co., Ltd.

Why UniOps Quantum Cycle?
Quick Start
Three Ways to Use
VSCode Extension
Teams
Skills
Rules & Hooks
Project Structure
Policies
Customization
Requirements

🤔 Why UniOps Quantum Cycle?

<table> <tr> <td align="center" width="20%">🏗️ 5 Teams 16 specialized personas</td> <td align="center" width="20%">📋 Phase Gates Ticket-driven workflow</td> <td align="center" width="20%">🔍 Full Audit Trail Every decision logged</td> <td align="center" width="20%">⚡ 21 Skills Ready-made slash commands</td> <td align="center" width="20%">🛡️ Policy Engine 9 enforced standards</td> </tr> </table>

| | Vanilla Claude Code | UniOps Quantum Cycle | |---|---|---| | Structure | Single assistant | ✅ 5 teams + 16 personas | | Planning | 🔧 Ad hoc | ✅ Phase dispatch + ticket gates | | Code Review | 🔧 Manual | ✅ 2-pass + cross-layer trace | | Shipping | 🔧 Manual git | ✅ /git pr with rebase + governance gates | | QA | 🔧 Manual | ✅ Playwright MCP + smoke test gates | | Retrospective | ❌ None | ✅ /git lookback — git + session data + decision audit | | Governance | ❌ None | ✅ Full hierarchy + approval gates | | Audit Trail | ❌ None | ✅ Every decision logged + traceable | | Multi-Team | ❌ No | ✅ 4 teams + parallel execution | | Setup | — | ⚡ ~30 seconds |

🚀 Quick Start

Install via Claude Code (Recommended)

Copy and paste into Claude Code:

🇬🇧 English:

Install UniOps Quantum Cycle from https://github.com/VarakornUnicornTech/UniOpsQC into my current project. Follow the Getting Started guide at https://github.com/VarakornUnicornTech/UniOpsQC/wiki/Getting-Started

🇹🇭 Thai / ภาษาไทย:

ติดตั้ง UniOps Quantum Cycle จาก https://github.com/VarakornUnicornTech/UniOpsQC ลงใน project ปัจจุบัน ตาม Getting Started ที่ https://github.com/VarakornUnicornTech/UniOpsQC/wiki/Getting-Started

[!TIP] Use "install" — not "read" or "explain". Saying "install" makes Claude go straight to setup without reading every policy file first.

Manual Install

[!NOTE] Replace C:/Projects/my-project in the commands below with the actual path to your project folder — the folder where you want to install UniOps Quantum Cycle.

Bash / Git Bash / macOS / Linux:

git clone https://github.com/VarakornUnicornTech/UniOpsQC.git .claude-template
cp -r .claude-template/.claude/ C:/Projects/my-project/.claude/
cp .claude-template/template-version.json C:/Projects/my-project/template-version.json
cp .claude-template/plugin.json C:/Projects/my-project/plugin.json
cp .claude-template/.mcp.json C:/Projects/my-project/.mcp.json
cp -r .claude-template/hooks/ C:/Projects/my-project/hooks/
rm -rf .claude-template

PowerShell (Windows):

git clone https://github.com/VarakornUnicornTech/UniOpsQC.git .claude-template
Copy-Item -Recurse .claude-template\.claude\ C:\Projects\my-project\.claude\
Copy-Item .claude-template\template-version.json C:\Projects\my-project\template-version.json
Copy-Item .claude-template\plugin.json C:\Projects\my-project\plugin.json
Copy-Item .claude-template\.mcp.json C:\Projects\my-project\.mcp.json
Copy-Item -Recurse .claude-template\hooks\ C:\Projects\my-project\hooks\
Remove-Item -Recurse -Force .claude-template

[!TIP] After installing, edit .claude/ProjectEnvironment.md with your project name and paths before starting Claude Code for the first time.

[!NOTE] Windows — Hook scripts require jq: Install via winget (winget install jqlang.jq) or Chocolatey (choco install jq), then restart your terminal. Without jq, hook scripts will not function.

Playwright MCP (optional): Required only if you want browser automation for UX smoke tests. Install Node.js and run npx playwright install inside your project.

🎯 Three Ways to Use UniOps Quantum Cycle

[!TIP] Each level is fully opt-in. Start at Level 1 and expand as your project grows.

<table> <tr> <td align="center" width="33%"> <h3>🚀 Level 1</h3> "I just want better shipping" Drop in <code>/git commit</code> and <code>/git pr</code>. No governance overhead — just better, safer shipping. </td> <td align="center" width="33%"> <h3>🏗️ Level 2</h3> "I want project structure" Use <code>/team-start</code>, <code>/phase-status</code>, <code>/bug-report</code>. Phase-based development without full team simulation. </td> <td align="center" width="33%"> <h3>🏛️ Level 3</h3> "I want full governance" Enable all hooks, activate agent teams, full session logging. Enterprise-grade traceability out of the box. </td> </tr> </table>

💻 VSCode Extension (UniOpsQC Hub)

UniOpsQC Hub is a companion VSCode extension that gives you a visual dashboard alongside Claude Code.

Install: Search for UniOpsQC Hub or RoundTable Hub in the VSCode Marketplace, or install extension ID unicorntech.roundhub.

What It Does

The extension does not run Claude Code — it is a command launcher and log viewer that works alongside the CLI.

| Button | What It Does | |--------|-------------| | Quick Actions | Copies a /command to your clipboard — paste it into Claude Code to run | | SESSION LOGS | Displays your RoundTable session log files for the active project | | FRAMEWORK STATUS | Shows the installed framework version (requires a .git repository) | | Push to Hub | Syncs your RoundTable logs to a cloud dashboard (subscription feature — not yet available) | | Update Preview | Copies the /template preview command to your clipboard — paste into Claude Code to run | | Refresh | Reloads the extension panel to reflect the latest file changes |

Two Versions — What Each Shows

The extension panel displays two version numbers:

| Version | What It Is | Where It Comes From | |---------|-----------|---------------------| | Framework version (e.g., v2.0.0) | The UniOpsQC template version | Read from your project's .git tags or template-version.json | | Extension version (e.g., v1.6.0) | The VSCode extension itself | The extension's own release version in the Marketplace |

[!TIP] The framework and extension are versioned independently. A newer extension does not mean a newer framework, and vice versa.

Centralized vs. Decentralized Projects

When you add a project in the extension, you will be asked for a Project Name and Project Root. UniOpsQC supports two project modes (set in .claude/ProjectEnvironment.md):

| Mode | When to Use | Root Path Points To | |------|-------------|---------------------| | Centralized | Greenfield or solo projects | The folder containing both .claude/ and your source code | | Decentralized | Pre-existing codebases | The planning hub folder (containing .claude/), which is separate from the source code |

👥 Teams

graph TD
    Commander["👑 Commander<br/>(You)"]
    AM["🎯 Overseer<br/>AM · MT · AS"]
    MON["🏗️ Monolith<br/>

UniOpsQC

Install / Use

README

Table of Contents