UniOpsQC

ภาษาไทย / Thai: อ่าน README ภาษาไทย

📊 Presentation

[!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.

Table of Contents

• 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?

🚀 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.

💻 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.

Two Versions — What Each Shows

The extension panel displays two version numbers:

[!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):

👥 Teams

graph TD
    Commander["👑 Commander<br/>(You)"]
    AM["🎯 Overseer<br/>AM · MT · AS"]
    MON["🏗️ Monolith<br/>Backend · DB · Cloud"]
    SYN["⚡ Syndicate<br/>API · Security"]
    ARC["🎨 Arcade<br/>Frontend · UI"]
    CI["🔬 Cipher<br/>Forensics · Recovery"]

    Commander --> AM
    Commander --> CI
    AM --> MON
    AM --> SYN
    AM --> ARC

    style Commander fill:#f0a500,color:#000,stroke:#f0a500
    style AM fill:#1e6fb5,color:#fff,stroke:#1e6fb5
    style MON fill:#1a7a4a,color:#fff,stroke:#1a7a4a
    style SYN fill:#b52020,color:#fff,stroke:#b52020
    style ARC fill:#7c3aed,color:#fff,stroke:#7c3aed
    style CI fill:#444,color:#fff,stroke:#666

⚡ Skills

Persona Skills

Framework Management

📐 Rules (Path-Scoped)

Policy rules in .claude/rules/ load automatically based on file context:

🪝 Hooks (Automated Enforcement)

Hooks are defined in .claude/settings.json under the "hooks" key. Scripts live in hooks/scripts/.

[!WARNING] Windows note: Hook scripts require Git Bash or WSL. Ensure bash and jq are available in your PATH. Scripts use #!/usr/bin/env bash shebangs and Unix path separators.

🎭 Playwright MCP (Browser Automation)

Verification Scholars can use Playwright for UX Smoke Test Gates and User Journey Walkthroughs. Configuration: .mcp.json at project root.

📁 Project Structure

your-project/
├── .claude/
│   ├── CLAUDE.md                # Core policy (entry point)
│   ├── ProjectEnvironment.md    # Project registry
│   ├── settings.json            # Permissions + hooks + protected file rules
│   ├── agents/                  # 5 team agent definitions
│   ├── rules/                   # 7 path-scoped rule files
│   ├── skills/                  # 21 slash command skills
│   │   ├── git/                 # Unified VCS: status, commit, pr, sync, lookback
│   │   │   └── checklists/      # Critical, informational, suppressions
│   │   ├── audit/               # Multi-domain gap bug finder
│   │   └── ...
│   ├── policies/                # 9 detailed policy files (§1–§9)
│   └── team_chat/               # Team communication logs + Cipher diagnostics
├── hooks/                       # Hook scripts (config in .claude/settings.json)
│   └── scripts/                 # check-git-workflow.sh, check-ticket-exists.sh, log-file-change.sh
├── .mcp.json                    # Playwright browser automation
├── plugin.json                  # Plugin manifest
└── RoundTable/                  # Session logs (created at runtime)

📋 Policy Reference

🔧 Customization

📦 Requirements

• Claude Code CLI installed
• Claude API access (Anthropic API key)

👤 Author

Unicorn Tech Integration Co., Ltd.

• Website: unicorntechint.com
• GitHub: @VarakornUnicornTech
• Discord: Join our community
• Location: Bangkok, Thailand

⚖️ License

MIT License — see LICENSE for details.

UniOps Quantum Cycle v2.0.0
Built with ❤️ by Unicorn Tech Integration Co., Ltd. · Bangkok, Thailand 🇹🇭

Getting Started · Contributing · Changelog · Discord · License