Ibrahim-3d/orchestrator-supaconductor

Multi-agent orchestration system for Claude Code with parallel execution, automated quality gates, Board of Directors, and bundled Superpowers skills

SupaConductor – AI 기반의 "서비스형 소프트웨어 엔지니어"

개요 – SupaConductor는 Anthropic의 Claude Code용 플러그인입니다(어댑터를 통해 Codex, Cursor, Google Antigravity, Windsurf, GitHub Copilot도 지원). 코딩 에이전트가 소규모 개발 팀처럼 작동하게 합니다. 자연어로 목표(예: "Google-OAuth 로그인 추가")를 입력하면 플러그인이 자동으로 다음을 수행합니다:

상세 사양 작성.
작업을 작업 의존성 그래프로 분해.
작업 실행(가능한 경우 병렬화).
내장 평가기 실행(UI/UX, 코드 품질, 통합, 비즈니스 로직).
실패 시 수정하고 모든 검사가 통과될 때까지 루프 반복.

이 모든 과정은 /orchestrator-supaconductor:로 시작하는 슬래시 명령어를 통해 오케스트레이션됩니다.

핵심 개념

개념	역할
Orchestrator	"평가 루프"(계획 → 계획 평가 → 실행 → 실행 평가 → 수정 → 완료)를 실행하는 중앙 컨트롤러.
Agents / Skills	계획, 코딩, 테스트, 평가를 수행하는 소규모 자율 작업자(15개 에이전트, 39개 스킬).
Evaluators	4가지 품질 검사 모듈(UI/UX, 코드 품질, 통합, 비즈니스 로직).
Board of Directors	5명의 가상 임원(아키텍트, 제품, 보안, 운영, 경험)이 중요한 결정에 대해 심의.
Lead Engineers	아키텍처, 제품, QA, 기술적 조언을 제공하는 가상 전문가.
`conductor/` folder	프로젝트 로컬 메타데이터(사양, 계획, 트랙 레지스트리, 결정 로그, 지식 패턴).

사용 방법

설치 – Claude Code 마켓플레이스를 통하거나, 리포지토리를 복제하고 scripts/build-platform-adapters.py를 실행하여 다른 호스트용 어댑터를 생성합니다.
초기 설정 – 프로젝트당 한 번 /orchestrator-supaconductor:setup을 실행합니다. conductor/ 디렉토리가 생성되며 코드베이스와 기술 스택에 대한 몇 가지 질문을 합니다.
목표 입력 – 예: /orchestrator-supaconductor:go Add Stripe payment integration with webhooks.
루프 관찰 – 플러그인이 자동으로 계획, 실행, 평가, 수정을 수행합니다. 진행 상황은 /orchestrator-supaconductor:status로 확인할 수 있습니다.
제어 모드 – conductor/config.json을 편집하여 agentic(완전 자율) 또는 human-in-the-loop(주요 단계에서 입력 대기) 모드를 선택합니다.

주요 명령어(빠른 참조)

명령어	기능
`:go <goal>`	설명된 기능/버그에 대한 전체 엔드투엔드 트랙 시작.
`:setup`	`conductor/` 폴더 및 초기 스프린트 부트스트랩.
`:status`	모든 활성 트랙과 현재 단계 나열.
`:implement`	현재 트랙의 평가 루프를 수동으로 진행.
`:board-meeting <topic>`	전체 가상 이사회 심의(서면 근거, 투표) 실행.
`:board-review <topic>`	빠른 이사회 평가(더 빠르고 세부 사항은 적음).
`:cto-advisor`, `:ux-designer`, …	아키텍처, 디자인 등에 대해 가상 임원에게 조언 요청.
`:loop-planner`, `:loop-executor`, `:loop-fixer`	루프의 각 단계를 개별적으로 실행하여 세밀하게 제어.

아키텍처 개요

/go <goal> → Orchestrator → (Plan → Eval-Plan → Execute → Eval-Exec → Fix) × n → Complete

각 단계는 전용 에이전트/스킬이 처리합니다.
병렬 디스패처가 독립적인 작업을 동시에 실행합니다.
평가기 결과가 오케스트레이터로 피드백되며, 최대 5회의 수정 주기 또는 3회의 계획 수정이 트리거될 수 있습니다.
결정 로그와 지식 파일은 사람이 감사할 수 있도록 conductor/ 하위에 일반 Markdown/JSON으로 저장됩니다.

비용 및 성능

Claude API를 사용하며, 계획/평가는 Opus, 실행은 Sonnet에서 작동합니다.
여러 에이전트가 활성화되어 있어 수동 Claude 대화보다 토큰 사용량이 약 3~5배 많지만, 시스템이 자동으로 비용을 최적화합니다(예: 일반 코딩에는 저렴한 모델 사용).
컨텍스트 사용은 모듈화되어 있어 활성 스킬만 약 5k 토큰의 프롬프트를 로드하므로, 메인 대화는 4k 토큰 이하로 유지됩니다.

대상 사용자

반복적인 기능 개발이나 버그 수정 주기를 자동화하려는 팀.
다중 파일 변경에 대해 "설정 후 잊기" 워크플로우를 선호하는 개인 개발자.
AI 강화 개발 파이프라인을 실험 중이며 플러그 앤 플레이 오케스트레이션 계층을 찾는 조직.

제한 사항

아주 작은 단일 파일 수정에는 적합하지 않습니다(오버헤드가 이점보다 큼).
지원되는 코딩 에이전트 호스트가 필요합니다(Claude Code가 기준이며, 나머지는 생성된 어댑터 필요).
수동 프롬프트보다 API 비용이 높으므로 사용량을 모니터링해야 할 수 있습니다.

커뮤니티 및 기여

토론, 이슈, 로드맵은 GitHub에서 호스팅됩니다.
AGPL-3.0 라이선스이며, MIT 라이선스인 Superpowers 라이브러리가 포함되어 있습니다.

결론 – SupaConductor는 코딩 에이전트를 소규모의 자율 관리형 엔지니어링 팀으로 바꿔주는 실용적인 오픈소스 오케스트레이션 계층입니다. Claude Code용으로 구축되었지만 다른 AI 코딩 어시스턴트를 위한 어댑터도 제공하므로, 기능을 한 번 설명하기만 하면 AI가 계획, 구현, 테스트, 품질 보증을 자동으로 처리합니다.