name	conductor
description	Use when the user wants to setup a new project, create a new feature, write a spec, plan a feature, fix a bug with a plan, start a new track, check project status, implement next task, or revert changes. Also use when user mentions "conductor", "track", or "spec-driven development". If conductor is not yet configured in the project, start with setup.

Conductor

Conductor is a Context-Driven Development (CDD) framework that transforms AI agents into proactive project managers. The philosophy is "Measure twice, code once" - every feature follows a strict protocol: Context -> Spec & Plan -> Implement.

Core Concepts

Track: A unit of work (feature or bug fix) with its own spec and plan
Spec: Detailed requirements document (spec.md)
Plan: Phased task list with checkboxes (plan.md)
Workflow: Rules for task lifecycle, TDD, commits, and quality gates

Directory Structure

When initialized, Conductor creates this structure in the project:

conductor/
├── product.md              # Product vision and goals
├── product-guidelines.md   # UX/brand guidelines
├── tech-stack.md           # Technology choices
├── workflow.md             # Development workflow rules
├── tracks.md               # Master list of all tracks
├── code_styleguides/       # Language-specific style guides
├── tracks/                 # Active tracks
│   └── <track_id>/
│       ├── metadata.json
│       ├── spec.md
│       └── plan.md
└── archive/                # Completed tracks

Available Commands

Command	Purpose
Setup	Initialize Conductor in a project (new or existing)
New Track	Create a new feature/bug track with spec and plan
Implement	Execute tasks from a track's plan following TDD workflow
Status	Show progress overview of all tracks
Revert	Git-aware rollback of tracks, phases, or tasks

Protocol References

The detailed protocols are in TOML format. Read the prompt field from each file:

Action	Protocol File
Setup project	`commands/conductor/setup.toml`
Create new track	`commands/conductor/newTrack.toml`
Implement tasks	`commands/conductor/implement.toml`
Check status	`commands/conductor/status.toml`
Revert changes	`commands/conductor/revert.toml`

How to read: Each .toml file has a prompt field containing the full protocol instructions.

Task Status Markers

[ ] - Pending
[~] - In Progress
[x] - Completed

Key Workflow Principles

The Plan is Source of Truth: All work tracked in plan.md
Test-Driven Development: Write tests before implementing
High Code Coverage: Target >80% coverage
Commit After Each Task: With git notes for traceability
Phase Checkpoints: Manual verification at phase completion

When to Use Each Protocol

"set up conductor" or "initialize project" -> Read commands/conductor/setup.toml
"new feature", "new track", "plan a feature" -> Read commands/conductor/newTrack.toml
"implement", "start working", "next task" -> Read commands/conductor/implement.toml
"status", "progress", "where are we" -> Read commands/conductor/status.toml
"revert", "undo", "rollback" -> Read commands/conductor/revert.toml

Assets

Code Styleguides: templates/code_styleguides/ (general, go, python, javascript, typescript, html-css)
Workflow Template: templates/workflow.md

Critical Rules

Validate every tool call - If any fails, halt and report to user
Sequential questions - Ask one question at a time, wait for response
User confirmation required - Before writing files or making changes
Check setup first - Verify conductor/ exists before any operation
Agnostic language - Do not suggest slash commands like /conductor:xxx. Instead, tell the user to ask you directly (e.g., "to start implementing, just ask me" instead of "run /conductor:implement")

conductor

Install Skill

SKILL.md