conductor

# Conductor

Context-driven development for AI coding agents. Measure twice, code once.

Conductor turns your AI coding agent into a disciplined project manager that follows a strict protocol: **Context → Spec & Plan → Implement**. Instead of jumping straight to code, every task goes through a lifecycle of defining context, writing specifications, creating phased plans, then implementing step-by-step with TDD and verification at each stage.

Based on the [Cursor CLI extension](https://github.com/cursor-cli-extensions/conductor) by the same name, rebuilt as a universal [Agent Skill](https://agentskills.io) compatible with any AI coding agent.

## Install

Copy the skill into your agent's skills directory:

```bash
# Universal (works with multiple agents)
git clone https://github.com/ai-startup/conductor.git ~/.agents/skills/conductor

# Claude Code
git clone https://github.com/ai-startup/conductor.git ~/.cursor/skills/conductor

# OpenAI Codex
git clone https://github.com/ai-startup/conductor.git ~/.codex/skills/conductor

# Cursor
git clone https://github.com/ai-startup/conductor.git ~/.cursor/skills/conductor

# Cursor CLI
git clone https://github.com/ai-startup/conductor.git ~/.cursor/extensions/conductor
```

See [INSTALL.md](INSTALL.md) for platform-specific details including Cursor, Aider, and project-level installs.

## Commands

| Command | Description |
|---------|-------------|
| **setup** | Initialize project with product context, tech stack, workflow, and first track |
| **newtrack** | Create a new feature/bug/chore track with interactive spec and phased plan |
| **implement** | Execute plan tasks following TDD workflow with commit discipline |
| **status** | Display progress overview across all tracks |
| **revert** | Git-aware revert at track, phase, or task level |
| **review** | Review code against project context, style guides, and specifications |

Command invocation varies by platform:

| Platform | Example |
|----------|---------|
| Claude Code |