conductor

Claude Conductor

Context-Driven Development framework for Claude Code.

Inspired by Conductor for Gemini CLI

Overview

Conductor enables Context-Driven Development - a methodology where context is treated as a managed artifact alongside code. It provides:

• Pre-implementation Planning: Generate specs and plans before coding
• Test-Driven Development: Enforced Red-Green-Refactor cycles
• Context Management: Maintain style guides, tech stack, product goals
• Iterative Safety: Review plans before execution with checkpoints
• Intelligent Reversion: Git-aware rollback of logical work units

Installation

Development / Testing

Load the plugin directly using the --plugin-dir flag:

claude --plugin-dir /path/to/conductor

Verify installation:

# Start Claude Code with the plugin
claude --plugin-dir /path/to/conductor

# Type /conductor: to see available commands
/conductor:

You should see the 5 conductor commands listed.

Production (via GitHub Marketplace)

Add the GitHub repository as a marketplace and install:

# Add this repository as a marketplace
/plugin marketplace add lackeyjb/claude-conductor

# Install the plugin
/plugin install conductor@claude-conductor

Symlink Installation (Alternative)

# Create plugins directory if it doesn't exist
mkdir -p ~/.claude/plugins

# Symlink the conductor plugin
ln -s /path/to/conductor ~/.claude/plugins/conductor

Commands

/conductor:setup

Initialize Conductor environment for a project.

Usage:

/conductor:setup [brownfield|greenfield]

Arguments:

• brownfield - Skip detection, treat as existing project
• greenfield - Skip detection, treat as new project

What it does:

1. Detects project maturity (brownfield vs greenfield)
2. Creates conductor/ directory with context files
3. Interactively generates product.md, tech-stack.md, workflow.md
4. Creates first track with specification and plan

Example:

> /conductor:setup

Existing project detected. I'll analyze it to understand the current state.
Found: package.json, src/, .git

What do you want to build? [describe your first feature]

---

/conductor:new-track

Create a new feature, bug, or chore track.

Usage:

/conductor:new-track [description]

Arguments:

• description - Brief description of the work (optional, will prompt if not provided)

What it does:

1. Infers track type (feature/bug/chore) from description
2. Delegates to planner agent for interactive Q&A
3. Generates spec.md with requirements
4. Generates plan.md with TDD-structured tasks
5. Creates track directory and updates tracks.md

Example:

> /conductor:new-track Add user authentication with OAuth

Creating feature track...
I have some questions to clarify the requirements:
1. Which OAuth providers should be supported?
2. Should we include "remember me" functionality?
...

---

/conductor:implement

Execute tasks following TDD workflow.

Usage:

/conductor:implement [<track-name>] [--all]

Arguments:

• <track-name> - Partial name to select specific track (optional, selects next incomplete)
• --all - Run all phases instead of one at a time

What it does:

1. Selects next incomplete track (or specified track)
2. Single-phase mode (default): Shows interactive phase selection, implements one phase at a time
3. All-phases mode (--all): Implements all remaining phases continuously
4. Delegates each task to implementer agent
5. Follows TDD cycle: Red → Green → Refactor
6. Creates atomic commits with git notes
7. Triggers phase verification at phase boundaries
8. Creates checkpoints with reviewer agent

Examples:

> /conductor:implement

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  PHASE SELECTION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Track: User Authentication

  [x] Phase 1: Setup                    [complete]
  [ ] Phase 2: Backend API              [in progress - 2/5 tasks]
  [ ] Phase 3: Frontend Integration     [pending]

  Which phase would you like to implement?

  A) Phase 2: Backend API (recommended)
  B) Phase 3: Frontend Integration
  C) All remaining phases

> /conductor:implement --all

Running all remaining phases for track 'User Authentication'.
Current task: Implement JWT validation

[RED] Writing failing test...
[GREEN] Implementing to pass...
[REFACTOR] Cleaning up...

Task complete. Commit: feat(auth): Implement JWT validation [a1b2c3d]

---

/conductor:status

Display project progress report.

Usage:

/conductor:status

What it does:

1. Parses all tracks and plans
2. Calculates completion percentages
3. Identifies current focus (in-progress track/phase/task)
4. Lists any blockers
5. Shows next actions