outbid-dirigent

Outbid Dirigent

A headless Python control plane that reads a spec, analyzes the target repo, picks the optimal execution path, and autonomously works through every task.

No human in the loop. No interactive terminal. No waiting for input.

---

How It Works

                         +-----------+
                         |  SPEC.md  |
                         +-----+-----+
                               |
                         +-----v-----+
                         |  Analyze   |  Repo structure, language, history
                         +-----+-----+
                               |
                         +-----v-----+
                         |   Route    |  5 execution paths
                         +-----+-----+
                               |
              +-------+--------+--------+--------+-------+
              |       |        |        |        |
           +--v--+ +--v--+ +--v--+ +---v--+ +--v---+
           |Green| |Legcy| |Hybrd| |Test  | |Track |
           |field| |     | |     | |abilty| |ing   |
           +--+--+ +--+--+ +--+--+ +--+---+ +--+---+
              |       |        |        |        |
              |    +--v---+    |        |        |
              |    |Proteus|   |        |        |
              |    +--+---+    |        |        |
              |       |        |        |        |
              +---+---+--------+--------+--------+
                               |
                         +-----v-----+
                         |   Plan     |  Phased execution plan
                         +-----+-----+
                               |
                         +-----v-----+
                         |  Execute   |  One Claude Code process per task
                         +-----+-----+
                               |
                         +-----v-----+
                         |   Ship     |  Branch, push, PR
                         +-----------+

Quick Start

# Full autonomous run with existing spec
dirigent --spec .planning/SPEC.md --repo /path/to/repo

# Inline description — generates SPEC.md, asks 2-3 questions
dirigent --repo . "Add a dark mode toggle to the settings page"

# YOLO mode — no questions, best-effort spec from description + context
dirigent --repo . --yolo "Add a dark mode toggle"

# Auto-detect spec (searches .planning/SPEC.md, SPEC.md, .dirigent/SPEC.md)
dirigent --repo /path/to/repo

# With deep domain extraction (recommended for legacy migrations)
dirigent --spec .planning/SPEC.md --repo /path/to/repo --use-proteus

# Resume after interruption
dirigent --spec .planning/SPEC.md --repo /path/to/repo --resume

Installation

Via uvx (recommended)

No installation needed. Run directly:

uvx --from git+https://github.com/BIDEquity/outbid-dirigent.git dirigent \
  --spec .planning/SPEC.md --repo /path/to/repo

Via uv

uv tool install git+https://github.com/BIDEquity/outbid-dirigent.git

Via pip

pip install git+https://github.com/BIDEquity/outbid-dirigent.git

Development

git clone https://github.com/BIDEquity/outbid-dirigent.git
cd outbid-dirigent
uv sync

Coder Workspaces

resource "coder_script" "dirigent" {
  agent_id     = coder_agent.main.id
  script       = <<-EOF
    uv tool install git+https://github.com/BIDEquity/outbid-dirigent.git
  EOF
  display_name = "Install Dirigent"
  run_on_start = true
}

The repo ships with .devcontainer/devcontainer.json for VS Code / GitHub Codespaces.

Prerequisites

Requirement	Purpose
Python 3.10+	Runtime
Claude Code CLI	AI execution engine
ANTHROPIC_API_KEY env var	Authentication
GitHub CLI (gh)	Optional — auto-creates PRs

---

Routing Engine

The Dirigent automatically selects one of five execution paths based on repo analysis and spec content.

Route A — Greenfield

New features on existing or new projects.

Triggers: Spec contains "add", "build", "create", "implement", "new feature" — actively developed project (last commit < 90 days) — modern stack (TypeScript, JavaScript, Python, Go, Rust)

Pipeline:

Init (optional) --> Plan --> Execute --> Entropy Min (optional) --> Test (optional) --> Ship

Route B — Legacy

Refactors, migrations, rewrites.