Conductor

Spec-driven development framework for Claude Code.

"Measure twice, code once" — 코드 작성 전 프로젝트 컨텍스트를 체계적으로 수립하고, 스펙 기반으로 구현을 진행합니다.

What is Conductor?

Conductor는 Claude Code의 slash command 플러그인으로, 소프트웨어 개발 프로세스를 체계적으로 관리합니다:

1. 프로젝트 컨텍스트 수립 — product definition, tech stack, workflow, code style guides를 문서화
2. Track 기반 작업 관리 — 기능/버그/작업을 Track 단위로 spec과 plan을 작성
3. TDD 워크플로우 — Red-Green-Refactor 사이클을 따르는 구현
4. Phase 체크포인트 — 각 Phase 완료 시 자동 테스트 + 수동 검증
5. 코드 리뷰 — 프로젝트 가이드라인에 기반한 구조화된 리뷰

Commands

Command	Description
/conductor-setup	프로젝트에 Conductor 환경 초기화
/conductor-new-track	새 Track(기능, 버그 수정, 작업) 생성
/conductor-implement	Track의 plan.md에 따라 구현 실행
/conductor-review	완료된 Track의 코드 리뷰
/conductor-status	프로젝트 전체 진행 상황 요약
/conductor-revert	Track/Phase/Task 단위 작업 되돌리기

Installation

Quick Install

curl -fsSL https://raw.githubusercontent.com/croquiscom/conductor/main/install.sh | bash

Manual Install

git clone https://github.com/croquiscom/conductor.git /tmp/conductor
cd /tmp/conductor
bash install.sh

What the installer does

1. ~/.claude/commands/에 conductor 커맨드 파일 복사
2. ~/.claude/conductor-context.md 공통 프로토콜 파일 설치
3. ~/.claude/templates/conductor/에 템플릿 파일 설치

How it works

1. Setup (/conductor-setup)

프로젝트 루트에서 실행하면 인터랙티브 Q&A를 통해 프로젝트 컨텍스트를 수립합니다:

conductor/
├── index.md              # 컨텍스트 인덱스
├── product.md            # 프로젝트 정의
├── product-guidelines.md # 개발 가이드라인
├── tech-stack.md         # 기술 스택
├── workflow.md           # 개발 워크플로우
├── tracks.md             # Track 레지스트리
└── code_styleguides/     # 코드 스타일 가이드
    └── *.md

• Brownfield 프로젝트: 기존 코드를 분석하여 tech stack 자동 감지
• Greenfield 프로젝트: 처음부터 인터랙티브하게 설정

2. New Track (/conductor-new-track)

작업 단위(Track)를 생성합니다. 인터랙티브하게 사양서(spec.md)와 구현 계획(plan.md)을 작성합니다:

conductor/tracks/<track_id>/
├── index.md        # Track 인덱스
├── spec.md         # 사양서 (요구사항, 수락 기준)
├── plan.md         # 구현 계획 (Phase → Task → Sub-task)
└── metadata.json   # Track 메타데이터

3. Implement (/conductor-implement)

plan.md에 따라 순차적으로 Task를 구현합니다:

• TDD 워크플로우 (Red → Green → Refactor)
• 각 Task 완료 시 커밋 + SHA 기록
• Phase 완료 시 자동 테스트 실행 + 사용자 수동 검증

4. Review (/conductor-review)

완료된 Track의 코드를 프로젝트 가이드라인에 따라 리뷰합니다:

• Plan/Spec 준수 여부 검증
• Code style guide 위반 검사
• 보안 스캔
• 테스트 커버리지 확인
• Critical/High/Medium/Low 등급의 리뷰 리포트 생성

5. Status (/conductor-status)

프로젝트 전체 진행 상황을 대시보드 형태로 보여줍니다.

6. Revert (/conductor-revert)

Track, Phase, Task 단위로 이전 작업을 안전하게 되돌립니다. Git revert를 사용하며, plan.md 상태도 함께 롤백합니다.

Templates

templates/ 디렉토리에 기본 템플릿이 포함되어 있습니다:

• workflow.md — TDD 기반 개발 워크플로우
• code_styleguides/ — 언어별 코드 스타일 가이드
  • general.md — 범용 스타일 가이드
  • kotlin.md — Kotlin/Spring Boot
  • typescript.md — TypeScript
  • python.md — Python

/conductor-setup 실행 시 프로젝트에 맞게 커스터마이즈됩니다.

Customization

커스텀 스타일 가이드 추가

~/.claude/templates/conductor/code_styleguides/에 새로운 언어별 .md 파일을 추가하면 /conductor-setup 시 자동으로 인식됩니다.

Workflow 수정

~/.claude/templates/conductor/workflow.md를 수정하여 기본 워크플로우를 변경할 수 있습니다. 또는 프로젝트별로 conductor/workflow.md를 직접 편집할 수 있습니다.

Requirements

• Claude Code CLI
• Git

License

MIT