Bicameral Conductor Template

The Cognitive Architect's Standard Template
Deterministic Orchestration for the Agentic Age

1. Executive Summary

This repository is the official Template for the Bicameral Conductor Ecosystem, a software architecture designed for the era of Google Antigravity and Gemini 3.0.

It represents a profound Ontological Shift in software engineering: moving from "Stochastic Generation" (probabilistic code completion) to "Deterministic Orchestration" (stateful, planned execution).

The Core Value

We are no longer merely "prompting" models. We are architecting autonomous, stateful agents. This template enforces a rigorous separation of concerns:

1. Strategy (Conductor): The "Architect" (You) defining Intent via persistent Markdown artifacts.
2. Execution (Antigravity): The "Engineering Team" (Agents) executing Plans via rigorous TDD loops.

2. The Bicameral Architecture

The central innovation of this framework is the Neural Bridge—a protocol that connects high-level strategic intent with low-level tactical execution, solving the problems of "Context Drift" and "Builder Bias."

The "Bridge Protocol"

This template includes a pre-configured conductor_bridge.py service.

• Watches: The conductor/ directory recursively (Your Strategy).
• Synchronizes: Changes to .agent/rules/conductor-active.md (The Agent's Context).
• Dynamic Context: Automatically detects the active track in tracks.md and injects its specific spec.md and plan.md into the Agent's brain stem in real-time.
• Ensures: The agent always operates on the latest version of your global strategy and local tactical plans.

3. Directory Structure

/
├── conductor/              # THE STRATEGY LAYER (Human Domain)
│   ├── product.md          # Vision & North Star
│   ├── tech-stack.md       # Constraints & Allowlist
│   ├── tracks.md           # Registry of Work (The "Kanban")
│   └── tracks/             # Context-Isolated Work Units
│       └── <track_id>/
│           ├── spec.md     # Requirements
│           ├── plan.md     # TDD Plan
│           └── metadata.json # State Machine
│
├── .agent/                 # THE EXECUTION LAYER (Agent Domain)
│   ├── rules/              # "Always On" Context
│   │   └── conductor-active.md # Generated by the Bridge
│   │   └── system_override.md  # The "Bicameral Persona"
│   └── workflows/          # Deterministic Scripts
│
├── src/                    # Source Code
├── tests/                  # Test Suite
├── conductor_bridge.py     # THE NEURAL BRIDGE SERVICE
└── augmentation_script.sh  # Utility to repair/init agent structure

4. Getting Started

Prerequisites

• Gemini CLI with the conductor extension installed.
• Python 3.12+

Installation

1. Clone this Template:

   git clone https://github.com/your-org/bicameral-conductor-template.git my-new-project
   cd my-new-project

2. Install Bridge Dependencies:

   pip install -r requirements.txt

3. Initialize Conductor:

   /conductor:setup

   Follow the interactive prompt to define YOUR product vision.

4. Activate the Bridge: Open a separate terminal and run:

   python conductor_bridge.py

   Keep this running. It is the heartbeat of your project.

5. Workflow: SCTDD

This template enforces Spec/Context/Test-Driven Development:

1. New Track: /conductor:newTrack "Add User Auth" → Generates spec.md.
2. Plan: Conductor generates plan.md.
3. Implement: /conductor:implement → Agent reads plan, writes FAILING test, then writes code.
4. Verify: Agent marks task as [x] only after tests pass.

6. Knowledge Integration (MCP)

This architecture is designed to work with the Model Context Protocol (MCP). The agent uses mcp.json to connect to persistent memory, allowing it to retain "Episodic Memory" (past decisions) and "Procedural Memory" (skills) across sessions.

7. Blueprint Compliance

This template adheres to the specifications in "The Cognitive Architect: A Comprehensive Technical Analysis of the Bicameral Conductor Ecosystem."