conductor

Conductor Plugin

Measure twice, code once.

Conductor is a plugin for AI coding agents (including Antigravity and Claude Code) that enables Spec-Driven Development. It turns your agent 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.

---

🛠 Installation Guide

Conductor is packaged as a standard agent plugin, compatible across modern AI coding agents. Choose the installation method for your environment below.

1. Antigravity

A. End-User Installation (Recommended)

Install directly from GitHub in a single command:

agy plugins install https://github.com/gemini-cli-extensions/conductor

B. Developer Installation (Live-Sync Global Link)

If you are a developer or contributor who wants to fork the repository, write custom skills, or modify rule configurations, clone the repository locally and link it:

1. Clone the repository:

   git clone https://github.com/gemini-cli-extensions/conductor.git
   cd conductor
   

2. Link globally for Antigravity:

   mkdir -p ~/.gemini/config/plugins/ && ln -sfn "$(pwd)" ~/.gemini/config/plugins/conductor
   

Why this method? Creating a symlink acts as a live development link. Any edits you make in your local Git branch are instantly loaded in real-time without reinstalling!

C. Workspace-Level Isolation

If you want to isolate Conductor strictly inside a specific Git project:

1. Create the local plugins directory in your target project's root:

   mkdir -p .agents/plugins/
   

2. Link Conductor to your local project:

   ln -sfn /absolute/path/to/cloned/conductor .agents/plugins/conductor
   

---

2. Claude Code

End-User Installation

Register the marketplace repository and install the Conductor plugin directly in your Claude Code session:

/plugin marketplace add gemini-cli-extensions/conductor
/plugin install conductor

---

🔄 Uninstallation

To safely remove Conductor from your environment:

• Antigravity:
  • CLI Installation: Run agy plugins uninstall conductor
  • Global Link: Run rm -f ~/.gemini/config/plugins/conductor
  • Workspace Link: Run rm -f .agents/plugins/conductor
• Claude Code: Run /plugin remove conductor and /plugin marketplace remove gemini-cli-extensions/conductor

---

🚀 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.
• Smart revert: A git-aware revert command that understands logical units of work (tracks, phases, tasks) rather than just commit hashes.

---

🎨 Adaptive User Experience (UX Layer)

Conductor natively adapts its user interface to match the specific visual capabilities of your active developer environment (IDE chat box, terminal console, or web editor).

This is powered by the integrated View Layer UX Adapter:

• Interactive GUI Modals: If your host editor supports visual interactive dialog elements, Conductor will automatically capture selections, decision interviews, and track options as native graphical modal dialog windows.
  • rules/: Custom adapter rules tailored for visual IDE environments (like Antigravity).
• Graceful CLI Fallback: If you are operating in a plain text terminal console (such as Claude Code), Conductor automatically detects the console environment and adapts all interactive steps into clean, structured text-based choice menus with bracketed numbers (e.g., [1] Option A, [2] Option B).