OPC Architecture Understanding

OPC (Orchestrated Parallel Claude) extends Claude Code - it does NOT replace it.

Core Concept

Claude Code CLI is the execution engine. OPC adds orchestration via:

• Hooks - Intercept Claude Code events (PreToolUse, PostToolUse, SessionStart, etc.)
• Skills - Load prompts into Claude Code
• Scripts - Called by hooks/skills for coordination
• Database - Store state between Claude Code instances

How Agents Work

When you spawn an agent:

1. Main Claude Code instance (your terminal) runs hook on Task tool
2. Hook calls subprocess.Popen(["claude", "-p", "prompt"])
3. A NEW Claude Code instance spawns as child process
4. Child runs independently, reads/writes to coordination DB