Conductor#

A structured workflow for agentic development — plan, track, and implement features using AI coding assistants.

Inspired by Google's Conductor extension for Gemini CLI, this is a multi-tool port that works with Claude Code and OpenCode (and any tool that supports markdown-based skill/command systems).

How it relates to Google's Conductor#

Google released Conductor as a Gemini CLI extension implementing "Context-Driven Development" — the idea that project context should live in persistent Markdown files alongside your code, not lost in chat history.

This project takes the same core philosophy and workflow:

Concept	Google's Conductor	This Conductor
Target tool	Gemini CLI only	Claude Code + OpenCode
Installation	`gemini extensions install`	`./install.sh` or drop-in SKILL.md
Context storage	`conductor/` directory with Markdown	Same
Work units	Tracks with spec + plan	Same
Commands	`/conductor:setup`, `:newTrack`, etc.	`/conductor-setup`, `-new-track`, etc.
Progress tracking	Checkbox tasks in `plan.md`	Same
Git integration	Commit per task/phase, git-aware revert	Same

The workflow is identical: setup your project context, create tracks for features/bugs/chores, implement tasks from a plan, review against the spec, and revert by logical unit when needed.

Installation#

Choose one of these methods:

Method 1: One-Shot SKILL.md (Easiest)#

Copy-paste this command to fetch and execute the installer:

curl -fsSL https://tangled.org/metaend.eth.xyz/open-conductor/raw/main/conductor-install.md -o /tmp/conductor-install.md && echo "Now give /tmp/conductor-install.md to your AI and say: Run this skill"

Or inline (paste this directly in Claude Code or OpenCode):

Fetch https://tangled.org/metaend.eth.xyz/open-conductor/raw/main/conductor-install.md and execute it as a skill to install Conductor

Then run /conductor-setup to configure.

Perfect for: Quick setup without leaving your editor.

Method 2: Bash Installer#

Clone the repository and run the installer:

# Clone the repository
git clone https://tangled.org/metaend.eth.xyz/open-conductor.git

# Run the installer in your project
/path/to/conductor/install.sh

# Or specify a target
./install.sh /path/to/your/project

Perfect for: CI/CD pipelines, automated setups, or if you prefer traditional shell scripts.

What it creates#

your-project/
├── conductor/
│   └── commands/          # 6 directive files (core logic)
├── .claude/
│   └── skills/            # 6 Claude Code skill wrappers
└── .opencode/
    └── commands/           # 6 OpenCode command wrappers

Prerequisites#

A git repository
An AGENTS.md or CLAUDE.md file describing your project's tech stack, conventions, and architecture (required before running /conductor-setup)

Usage#

After installing, open your project in Claude Code or OpenCode and run:

1. Setup (once per project)#

/conductor-setup

Interactively configures commit frequency, test coverage targets, TDD preference, and task summary format. Creates conductor/config.md and conductor/tracks.md.

2. Create a track#

/conductor-new-track Add user authentication

Generates a track with:

spec.md — what to build and acceptance criteria
plan.md — phased tasks with checkboxes
metadata.json — tracking info

3. Implement#

/conductor-implement

Works through tasks in the plan, updating checkboxes and committing per your config.

4. Check progress#

/conductor-status

Shows completion percentages across all tracks.

5. Review#

/conductor-review

Verifies implementation against the spec's acceptance criteria and project conventions.

6. Revert#

/conductor-revert

Git-aware rollback by track, phase, or individual task.

Design#

The core logic lives in conductor/commands/*.md — plain Markdown directive files that any AI tool can follow. The .claude/skills/ and .opencode/commands/ files are thin wrappers that point to these directives, making it easy to add support for other tools.

License#

Apache 2.0

Clone this repository