Cursor Agent Triad System

A multi-agent architecture combining Claude Code strategy with Cursor CLI execution for maximum code quality and cost efficiency.

What is the Triad Pattern?

Claude Code (Opus/Sonnet)     Cursor Bridge (Haiku)     Cursor CLI
  Strategy & Analysis    -->   CLI Dispatcher     -->  Code Generation
  "Design the approach"        "Route to cursor"        "Write the code"

The Triad Pattern splits AI-assisted development into three specialized roles:

Claude Strategy Agent — Designs the approach using reasoning-heavy models (Opus/Sonnet)
Cursor Bridge Agent — Lightweight Haiku dispatcher that routes to CLI
Cursor CLI — Composer 1.5 or Codex models do the actual implementation

Why This Pattern?

Cost optimization: 80% Composer (cheap) + 20% Codex (targeted QC)
Cross-model validation: Different models catch different error classes
Separation of concerns: Strategy vs. implementation vs. review
Credit efficiency: Bridge agents use cheap Haiku; expensive models only for real work

Quick Start

# 1. Clone
git clone https://github.com/your-username/cursor-agent-triad-example.git
cd cursor-agent-triad-example

# 2. Make scripts executable
chmod +x bin/*

# 3. Verify
./bin/cursor-agent-status

Example Triads

Triad	Domain	Claude Agent	Cursor Agent
API Designer	Web/Backend	API architecture strategy	Endpoint implementation
Test Engineer	Testing/QA	Test architecture strategy	Test generation + fixes
Sequence Analyst	Bioinformatics	Analysis workflow design	FASTA processing + alignment

Documentation

Architecture Deep-Dive — How the system works
Triad Pattern — Step-by-step walkthrough
Customization Guide — Add your own triads
Cost Optimization — Budget strategy
Setup Guide — Detailed installation

Architecture Overview

                    +-------------------+
                    |   Task Input      |
                    +-------------------+
                            |
                    +-------------------+
                    | subagent-router   |
                    | (auto-classify)   |
                    +-------------------+
                       /           \
              Strategy              Implementation
                 |                       |
    +-------------------+    +-------------------+
    | Claude Agent      |    | Cursor Bridge     |
    | (Opus/Sonnet)     |    | (Haiku)           |
    | Design approach   |    | CLI dispatcher    |
    +-------------------+    +-------------------+
                                     |
                        +-------------------------+
                        |    cursor-agent CLI      |
                        +-------------------------+
                           /                  \
                +----------------+    +----------------+
                | Codex          |    | Composer 1.5   |
                | (Generate)     |    | (Review)       |
                +----------------+    +----------------+
                           \                  /
                        +-------------------------+
                        |  QC-Validated Output     |
                        +-------------------------+