Skip to content
/

Conductor (fcoury)

conductor-fcoury · fcoury/conductor · ★ 25 · last commit 2025-12-23

Cross-tool CDD implementation running identical methodology on Claude Code, Gemini CLI, and Codex CLI with an auto-activating ambient skill.

Best whenAI development methodology should be tool-agnostic — the same context artifacts and workflow work regardless of which AI coding assistant a developer uses.
Skip ifTool-locked methodologies (should run on Claude Code, Gemini, and Codex)
vs seeds
superpowers' skill-only activation pattern), but the defining architectural innovation is cross-tool portability: one repo ships fo…
Primitive shape 6 total
Commands 5 Skills 1
00

Summary

Conductor (fcoury) — Summary

Conductor by Felipe Coury (fcoury) is the most cross-tool of all the CDD conductor variants: it explicitly ships for Claude Code (plugin), Gemini CLI (extension), and Codex CLI (prompt files + optional skill) in the same repository. The core methodology — Context-Driven Development via conductor/ directory with product.md, tech-stack.md, workflow.md, and track-based spec+plan lifecycle — matches the rbarcante/lackeyjb pattern, but fcoury makes it tool-agnostic by maintaining three separate integration points: .claude-plugin/, gemini-extension.json, and prompts/ + skills/conductor-development. The plugin ships 5 commands (setup, new-track, implement, status, revert) with an auto-activating conductor-development skill for ambient context injection. At 25 stars with last commit 2025-12-23, it is a community effort focused on portability. Compared to the seed superbasicstudio/claude-conductor (passive scaffold), fcoury adds commands, skills, and multi-tool distribution; compared to rbarcante (Python CLI + patterns), fcoury adds cross-tool support but removes the advanced features. The CODEX.md and GEMINI.md files are its distinguishing artifacts — no other conductor variant targets 3+ AI tools simultaneously.

01

Overview

Conductor (fcoury) — Overview

Origin

Philosophy

Same CDD philosophy as rbarcante/lackeyjb:

"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."

Tagline: "Measure twice, code once."

Key differentiation from other variants: multi-tool portability. From the README:

The plugin supports three AI coding tools:

  • Claude Code (.claude-plugin/, /conductor:* slash commands)
  • Gemini CLI (gemini extensions install, @conductor extension)
  • Codex CLI (~/.codex/prompts/, /prompts:conductor-*)

This positions fcoury's conductor as the "universal CDD implementation" — one methodology, three runtimes.

Integration points per tool

Claude Code

  • Install: /plugin marketplace add fcoury/conductor + /plugin install conductor@fcoury-conductor
  • Commands: /conductor:setup, /conductor:new-track, /conductor:implement, /conductor:status, /conductor:revert
  • Auto-skill: conductor-development activates when conductor/ directory exists

Gemini CLI

  • Install: gemini extensions install https://github.com/fcoury/conductor --auto-update
  • Commands: gemini-native (via gemini-extension.json)
  • File: GEMINI.md provides conductor context awareness

Codex CLI

  • Install: copy prompts/*.md to ~/.codex/prompts/
  • Commands: /prompts:conductor-setup, /prompts:conductor-new-track, etc.
  • Optional skill: skills/conductor-development/ copyable to ~/.codex/skills/
  • Documented in: CODEX.md
02

Architecture

Conductor (fcoury) — Architecture

Distribution

  • Type: Claude Code plugin + Gemini CLI extension + Codex prompt files
  • Install methods:
    • Claude Code: /plugin marketplace add fcoury/conductor && /plugin install conductor@fcoury-conductor
    • Gemini CLI: gemini extensions install https://github.com/fcoury/conductor --auto-update
    • Codex: copy prompts/*.md to ~/.codex/prompts/
  • Required runtime: Claude Code (primary) / Gemini CLI / Codex CLI (alternatives)

Directory structure

fcoury/conductor/
├── .claude-plugin/          # Claude Code plugin manifest
├── commands/                # 5 slash commands (Claude Code)
│   ├── conductor/           # Additional conductor skill files
│   ├── setup.md
│   ├── new-track.md
│   ├── implement.md
│   ├── status.md
│   └── revert.md
├── skills/
│   └── conductor-development/  # Auto-activating CDD skill
├── prompts/                 # Codex CLI prompt files
│   ├── conductor-setup.md
│   ├── conductor-new-track.md
│   ├── conductor-implement.md
│   ├── conductor-status.md
│   └── conductor-revert.md
├── templates/               # Project template files
├── gemini-extension.json    # Gemini CLI extension config
├── GEMINI.md               # Gemini CLI context file
├── CODEX.md                # Codex CLI documentation
├── CONTRIBUTING.md
└── LICENSE

Runtime directory (created at setup per project)

conductor/
├── product.md
├── product-guidelines.md
├── tech-stack.md
├── workflow.md
├── tracks.md
├── setup_state.json
├── code_styleguides/
└── tracks/<track_id>/
    ├── spec.md
    ├── plan.md
    └── metadata.json

Target AI tools

  • Primary: Claude Code
  • Secondary: Gemini CLI, Codex CLI
  • Cross-tool portability: medium-high (all three supported, prompt files differ)
03

Components

Conductor (fcoury) — Components

Commands (5 — Claude Code)

Command Purpose
/conductor:setup Initialize CDD environment
/conductor:new-track Create track with spec.md + plan.md
/conductor:implement Execute tasks with TDD
/conductor:status Show progress
/conductor:revert Git-aware undo

Skills (1)

Skill Activation Purpose
conductor-development When conductor/ dir exists, or when user mentions "tracks", "specs", or "plans" Ambient CDD methodology skill; ensures Claude follows TDD workflow and properly tracks task completion without explicit commands

Prompt files (5 — Codex CLI)

Prompt file Invoked as
prompts/conductor-setup.md /prompts:conductor-setup
prompts/conductor-new-track.md /prompts:conductor-new-track
prompts/conductor-implement.md /prompts:conductor-implement
prompts/conductor-status.md /prompts:conductor-status
prompts/conductor-revert.md /prompts:conductor-revert

Gemini CLI extension

  • gemini-extension.json — extension manifest for Gemini CLI
  • GEMINI.md — context file injected into Gemini sessions:

    "If a user mentions a 'plan' or asks about the plan, and they have used the conductor extension in the current session, they are likely referring to the conductor/tracks.md file or one of the track plans."

Templates

templates/ directory — project template files.

Hooks

None.

Sub-agents

None explicitly. The conductor-development skill provides ambient behavior rather than agent delegation.

Commands directory (commands/conductor/)

Additional skill files for conductor methodology embedded under the commands directory.

05

Prompts

Conductor (fcoury) — Prompts

Excerpt 1: commands/setup.md — Sequential resume protocol

## 1.1 BEGIN RESUME CHECK

**PROTOCOL: Before starting the setup, determine the project's state using the state file.**

1. **Read State File:** Check for the existence of `conductor/setup_state.json`.
   - If it does not exist, this is a new project setup. Proceed directly to Step 1.2.
   - If it exists, read its content.

2. **Resume Based on State:**
   - If `STEP` is "2.1_product_guide", announce "Resuming setup: The Product Guide is already complete." and proceed to **Section 2.2**.
   - If `STEP` is "3.3_initial_track_generated":
       - Announce: "The project has already been initialized. You can create a new track..."
       - Halt the `setup` process.

Technique: State-machine resume protocol — each step has a named state; setup can resume exactly from the last successful step. Announcement-then-proceed pattern for user transparency.


Excerpt 2: GEMINI.md — Minimal ambient context for Gemini

# Conductor Context

If a user mentions a "plan" or asks about the plan, and they have used the conductor extension in the current session, they are likely referring to the `conductor/tracks.md` file or one of the track plans (`conductor/tracks/<track_id>/plan.md`).

Technique: Minimal context disambiguation file injected at session start. Resolves the ambiguity of "plan" (could mean anything) in the Gemini context. This is the entire Gemini context file — radical brevity.


Excerpt 3: CODEX.md — Multi-tool installation instructions (structural)

# Conductor for Codex CLI

## Commands

After installing the prompt files, invoke commands using `/prompts:` prefix:

| Command | Description |
|---------|-------------|
| `/prompts:conductor-setup` | Set up Conductor environment for a project |
| `/prompts:conductor-new-track` | Create a new track (feature or bug fix) |
| `/prompts:conductor-implement` | Execute tasks from the current track's plan |
| `/prompts:conductor-status` | Display progress of all tracks |
| `/prompts:conductor-revert` | Revert a track, phase, or task |

Technique: Tool-specific documentation as separate .md files. Each tool gets its own documentation contract. The prompt content itself is shared (same methodology), only the invocation prefix changes.


Prompting techniques observed

  1. State-machine resumesetup_state.json with named step keys enables exact resume
  2. Minimal ambient injection (GEMINI.md) — single-paragraph disambiguation vs. full context dump
  3. Tool-agnostic prompt filesprompts/ directory mirrors commands/ with same content but different invocation prefix
  4. Auto-skill trigger conditions — skill activates on directory presence OR keyword mention OR task context
  5. Sequential section labels1.1 BEGIN RESUME CHECK, 2.0 PHASE 1, 3.0 PHASE 2 for clear agent navigation
09

Uniqueness

Conductor (fcoury) — Uniqueness

differs_from_seeds

Closest seed is superbasicstudio/claude-conductor (Archetype 4, passive scaffold), but fcoury adds 5 commands, 1 auto-activating skill, and multi-tool distribution. The key architectural delta from the seed is the conductor-development auto-skill (ambient methodology enforcement), and the cross-tool portability (GEMINI.md + Codex prompts). Among seeds, the auto-activating skill pattern most resembles superpowers (skills-only behavioral framework with ambient activation), but fcoury's skill is narrow (conductor methodology only) rather than a comprehensive behavioral framework. No other seed or variant in this batch targets 3 AI tools simultaneously in a single repo.

What makes fcoury conductor unique

  1. Triple-tool distribution — Claude Code + Gemini CLI + Codex CLI from one repo (no other conductor variant does this)
  2. Auto-skill ambient enforcementconductor-development activates on directory presence or keyword mention
  3. GEMINI.md — minimal (6-line) ambient context file for Gemini CLI disambiguation
  4. CODEX.md — dedicated documentation for Codex CLI installation and usage
  5. Tool-agnostic methodology — the core CDD content is the same; only the integration wrapper changes

Observable failure modes

  1. Stale multi-tool maintenance: keeping 3 tool integrations in sync is a maintenance burden; as of 2025-12-23, may lag behind Claude Code API changes
  2. 25 stars: very low adoption; uncertain maintenance trajectory
  3. No specialist agents: simpler than lackeyjb/rbarcante; less robust for complex brownfield projects
  4. No hooks: unlike lackeyjb, passive context management only via auto-skill (less reliable than explicit hooks)

Positioning

fcoury's conductor is uniquely positioned for teams that use multiple AI coding tools simultaneously (e.g., Claude Code for some team members, Codex for others). It enforces a shared project methodology regardless of which tool individual developers use.

04

Workflow

Conductor (fcoury) — Workflow

Phases

Phase Command Artifacts
1. Setup /conductor:setup (or /prompts:conductor-setup) conductor/product.md, conductor/tech-stack.md, conductor/workflow.md, conductor/tracks.md
2. Track Creation /conductor:new-track [description] conductor/tracks/<id>/spec.md, conductor/tracks/<id>/plan.md, conductor/tracks/<id>/metadata.json
3. Implementation /conductor:implement Updated plan.md, synchronized project context
4. Status /conductor:status (read-only)
5. Revert (optional) /conductor:revert Git history modification

Approval gates

  1. Spec+plan review: user reviews before /conductor:implement
  2. Phase verification: manual check at phase boundaries
  3. Interactive prompts: AskUserQuestion (Claude Code) / native interaction (other tools)

TDD enforcement

Workflow describes TDD cycle per task; the conductor-development skill ensures the agent follows TDD + tracks task completion even without explicit commands.

Auto-skill activation

The conductor-development skill activates automatically when:

  • A conductor/ directory exists in the project
  • The user mentions "tracks", "specs", or "plans" in their request
  • Working on tasks from a track's plan.md

This is ambient CDD enforcement — methodology is active even when users don't type slash commands.

Resume on interruption

conductor/setup_state.json supports setup resumption from the last successful step.

Cross-tool command mapping

Workflow step Claude Code Codex CLI Gemini CLI
Setup /conductor:setup /prompts:conductor-setup Gemini-native
New track /conductor:new-track /prompts:conductor-new-track Gemini-native
Implement /conductor:implement /prompts:conductor-implement Gemini-native
Status /conductor:status /prompts:conductor-status Gemini-native
Revert /conductor:revert /prompts:conductor-revert Gemini-native
06

Memory Context

Conductor (fcoury) — Memory & Context

State storage

Same file-based pattern as other CDD variants:

File Contents
conductor/product.md Product vision
conductor/product-guidelines.md Standards
conductor/tech-stack.md Technical preferences
conductor/workflow.md Development methodology
conductor/tracks.md Master track index
conductor/setup_state.json Setup resumption state
conductor/code_styleguides/ Style guides
conductor/tracks/<id>/spec.md Feature specification
conductor/tracks/<id>/plan.md Implementation plan
conductor/tracks/<id>/metadata.json Track state

Auto-skill ambient context

The conductor-development skill provides persistent ambient context across sessions:

  • Activates when conductor/ directory exists — no user action required
  • Activates on keyword mentions ("tracks", "specs", "plans")
  • Ensures methodology adherence even without slash commands

This is the closest equivalent to lackeyjb's SessionStart hook — but implemented as a skill rather than a hook.

Cross-session handoff

  • setup_state.json enables resume from last successful setup step
  • tracks.md provides persistent work-in-progress state
  • metadata.json per track preserves status

GEMINI.md ambient context

When using Gemini CLI, GEMINI.md provides minimal session context (plan disambiguation). Injected by the Gemini extension at session start — analogous to a SessionStart hook.

Memory persistence scope

  • Project-scoped: all state in conductor/ within the repo
  • No global state
07

Orchestration

Conductor (fcoury) — Orchestration

Multi-agent

No — no specialist agents (unlike lackeyjb's planner/implementer/reviewer). Commands implement logic directly.

Orchestration pattern

Sequential — setup → new-track → implement → status/revert.

Isolation mechanism

Git branches (inferred from workflow; no explicit worktrees).

Multi-model

No — single model per tool session.

Execution mode

Interactive loop — user-triggered commands. The conductor-development skill provides ambient enforcement between commands.

Prompt chaining

Yes — new-track produces spec.md + plan.md consumed by implement.

Auto-skill as ambient orchestration

The conductor-development skill is an unusual orchestration pattern: it is a standing instruction that activates based on context signals (directory presence, keyword mentions) rather than explicit invocation. This provides methodology enforcement between explicit command calls.

Cross-tool consistency

The same methodology is enforced across three tools via different mechanism types:

  • Claude Code: slash commands + auto-skill
  • Gemini CLI: extension commands + GEMINI.md ambient context
  • Codex CLI: /prompts:* prefix + optional skill file

The underlying workflow phases and artifacts are identical regardless of tool.

Crash recovery

Yes — setup_state.json for setup resumption.

08

Ui Cli Surface

Conductor (fcoury) — UI & CLI Surface

Dedicated CLI

No standalone binary.

Local UI

None.

IDE integration

Claude Code

  • Plugin installed via marketplace
  • Slash commands: /conductor:setup, /conductor:new-track, /conductor:implement, /conductor:status, /conductor:revert

Gemini CLI

  • Extension installed via gemini extensions install
  • gemini-extension.json defines Gemini-native commands
  • GEMINI.md provides ambient plan disambiguation

Codex CLI

  • Prompt files copied to ~/.codex/prompts/
  • Commands: /prompts:conductor-setup, /prompts:conductor-new-track, etc.
  • Optional skill: copy skills/conductor-development/ to ~/.codex/skills/conductor

Observability

  • tracks.md: master progress index
  • metadata.json: per-track machine-readable state
  • No hooks for passive change tracking (unlike lackeyjb)
  • No code review automation (unlike rbarcante)

Cross-tool portability rating

Medium — the same methodology runs on 3 tools, but each tool has its own installation method and invocation syntax. The content of the prompt files is shared; the wrappers differ.

Related frameworks

same archetype · same primary tool · same memory type

BMAD-METHOD ★ 48k

Provides a full agile delivery lifecycle with named expert-persona AI collaborators that elicit the human's best thinking rather…

Agent OS ★ 4.6k

Extracts implicit codebase conventions into token-efficient markdown standards files and injects them selectively into AI agent…

Claude Conductor ★ 367

Gives Claude Code a persistent, cross-linked, auto-analyzed documentation system so it retains codebase context across sessions.

Spec-Driver (Greenfield Spec-Driven Development) ★ 25

Prevents spec rot in AI-assisted development by making implementation changes flow back into evergreen, authoritative specs via…

Anthropic Knowledge Work Plugins ★ 16k

Role-specialized plugin bundles with live MCP connectors that turn Claude into a domain expert for enterprise knowledge workers.

Codex Integration for Claude Code (skill-codex) ★ 1.3k

Single Claude Code skill that handles Codex CLI invocation correctly (stdin blocking, thinking token suppression, session resume)…