conductor

Claude Conductor for Claude Code

Measure twice, code once.

Conductor is a Claude Code plugin that enables Context-Driven Development. It turns Claude Code into a proactive project manager that follows a strict protocol to specify, plan, and implement software features and bug fixes.

Instead of just writing code, Conductor ensures a consistent, high-quality lifecycle for every task: Context -> Spec & Plan -> Implement.

The philosophy behind Conductor is simple: control your code. By treating context as a managed artifact alongside your code, you transform your repository into a single source of truth that drives every agent interaction with deep, persistent project awareness.

Features

• Plan before you build: Create specs and plans that guide the agent for new and existing codebases.
• Maintain context: Ensure AI follows style guides, tech stack choices, and product goals.
• Iterate safely: Review plans before code is written, keeping you firmly in the loop.
• Work as a team: Set project-level context for your product, tech stack, and workflow preferences that become a shared foundation for your team.
• Build on existing projects: Intelligent initialization for both new (Greenfield) and existing (Brownfield) projects.
• Codebase Pattern Analysis: Automatically detect and document existing code patterns, architecture conventions, and testing practices for brownfield projects.
• Smart revert: A git-aware revert command that understands logical units of work (tracks, phases, tasks) rather than just commit hashes.
• Universal File Resolution Protocol (UFRP): Flexible file organization with dynamic path resolution via index files, allowing customization of your project structure.
• Pattern Reference Layer: Reusable best-practice patterns that are automatically surfaced during implementation based on task context.
• AI-Optimized Templates: Dual-format patterns and styleguides with AI Quick Reference sections, plus a searchable snippet library.
• Skill Ecosystem: Extensible skill plugin architecture with reference skills for typescript-best-practices, api-design, and testing-strategies that provide domain-specific guidance.
• Quality Intelligence: Automated anti-pattern detection and coverage analysis with actionable test suggestions during implementation.
• Decision Logging: Architecture Decision Record (ADR) logging that captures the "why" behind implementation choices for self-documenting codebases.

Installation

From the Marketplace (Recommended)

# Add the marketplace
/plugin marketplace add rbarcante/claude-conductor

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

Manual Installation

# Option 1: Project-specific installation
cp -r claude-conductor ~/.claude/plugins/conductor

# Option 2: Use with --plugin-dir flag
cc --plugin-dir /path/to/claude-conductor

Usage

Conductor is designed to manage the entire lifecycle of your development tasks.

Note on Token Consumption: Conductor's context-driven approach involves reading and analyzing your project's context, specifications, and plans. This can lead to increased token consumption, especially in larger projects or during extensive planning and implementation phases.

1. Set Up the Project (Run Once)

When you run /conductor:setup, Conductor helps you define the core components of your project context. This context is then used for building new components or features by you or anyone on your team.

• Product: Define project context (e.g. users, product goals, high-level features).
• Product guidelines: Define standards (e.g. prose style, brand messaging, visual identity).
• Tech stack: Configure technical preferences (e.g. language, database, frameworks).
• Workflow: Set team preferences (e.g. TDD, commit strategy). Uses workflow.md as a customizable template.

Generated Artifacts:

• conductor/product.md
• conductor/product-guidelines.md (includes codebase patterns for brownfield)
• conductor/tech-stack.md
• conductor/workflow.md
• conductor/code_styleguides/
• conductor/docs/ (pattern documentation for brownfield projects)
• conductor/tracks.md
• conductor/index.md (navigation index)

/conductor:setup

2. Start a New Track (Feature or Bug)

When you're ready to take on a new feature or bug fix, run /conductor:newTrack. This initializes a track — a high-level unit of work. Conductor helps you generate two critical artifacts: