session-orchestrator은(는) 무엇을 하나요?
임시 Claude Code / Codex / Cursor 세션을 반복 가능한 루프로 전환합니다 — 연구 → 계획 → 웨이브 실행 → 종료. 병렬 하위 에이전트, 웨이브 간 품질 게이트, 이중 GitHub+GitLab 통합, F2 메모리 + Persona-Panel + gsd-패턴 채택. 37개의 스킬 · 18개의 명령어 · 13개의 에이전트 · 7360개의 테스트.
개요
session-orchestrator는 AI 에이전트 세션을 구조화된 워크플로우로 오케스트레이션하는 포괄적인 스킬입니다. 이는 소프트웨어 개발 생명주기(SDLC)의 각 단계를 정형화된 프로세스로 변환하여, 개발자가 일관된 품질과 효율성을 유지하며 작업할 수 있도록 설계되었습니다.
주요 기능
- 연구 단계: 코드베이스 분석, 요구사항 수집, 기술적 조사 수행
- 계획 단계: 작업 분할, 의존성 분석, 실행 계획 수립
- 웨이브 실행 단계: 병렬 하위 에이전트를 통한 코드 생성, 수정, 리팩토링
- 종료 단계: 결과 검증, 문서화, Git 커밋 및 푸시
웨이브 실행
wave-execute 단계는 여러 하위 에이전트를 동시에 실행하여 생산성을 극대화합니다. 각 웨이브는 다음 구성 요소를 포함할 수 있습니다:
- 메인 에이전트: 전체 워크플로우를 조정
- 서브 에이전트: 특정 작업을 병렬로 처리 (예: 유닛 테스트 작성, API 구현)
- 품질 게이트: 각 웨이브 종료 시 자동 코드 검토 및 테스트 실행
통합
이 스킬은 다음과 같은 주요 플랫폼과 통합됩니다:
- GitHub: Pull Request 생성, 코드 리뷰 자동화, CI/CD 트리거
- GitLab: Merge Request 생성, GitLab CI 연동
- F2 메모리: 장기 컨텍스트 유지 및 세션 간 학습
- Persona-Panel: 역할 기반 에이전트 동작 (예: 리더, 리뷰어, 개발자)
- gsd-패턴: 효율적인 작업 분해 및 실행을 위한 패턴 라이브러리
명령어
session-orchestrator는 18개의 명령어를 제공합니다. 주요 명령어는 다음과 같습니다:
| 명령어 | 설명 |
|---|---|
/session init | 새 세션 초기화 |
/session research | 연구 단계 실행 |
/session plan | 계획 단계 실행 |
/session wave | 웨이브 실행 단계 시작 |
/session close | 세션 종료 및 정리 |
/agent spawn <type> | 특정 유형의 하위 에이전트 생성 |
/memory save | 현재 컨텍스트를 F2 메모리에 저장 |
/quality check | 현재 웨이브의 품질 검사 실행 |
에이전트
이 스킬은 13개의 사전 정의된 에이전트를 포함합니다:
- Orchestrator Agent - 전체 워크플로우 관리
- Research Agent - 코드베이스 및 요구사항 분석
- Planner Agent - 작업 분할 및 의존성 그래프 생성
- Wave Executor Agent - 병렬 작업 실행 조정
- Code Generator Agent - 새 코드 생성
- Refactor Agent - 기존 코드 리팩토링
- Test Agent - 유닛 및 통합 테스트 작성
- Quality Gate Agent - 코드 리뷰 및 품질 검사
- Doc Agent - 문서화 및 주석 생성
- Git Agent - Git 작업 관리
- Memory Agent - F2 메모리 저장 및 검색
- Persona Agent - 역할 기반 에이전트 동작
- Pattern Agent - gsd-패턴 적용
사용 예시
기본 워크플로우
# 세션 초기화
/session init --project my-app
# 연구 단계 실행
/session research --scope api-layer
# 계획 수립
/session plan --detail high
# 첫 번째 웨이브 실행 (병렬 에이전트 3개)
/session wave --parallel 3 --focus implementation
# 품질 검사
/quality check --strict
# 두 번째 워크웨이브 실행
/session wave --parallel 2 --focus testing
# 세션 종료
/session close --commit "Implement API layer" --branch feat/api-v2
설치
이 스킬을 사용하려면 다음 단계를 따르세요:
SKILL.md파일을 프로젝트 루트에 복사합니다.- 필요한 종속성을 설치합니다:
pip install -r requirements.txt # Python 프로젝트의 경우
npm install # Node.js 프로젝트의 경우
- 환경 변수를 설정합니다:
export GITHUB_TOKEN=your_github_token
export GITLAB_TOKEN=your_gitlab_token
export F2_MEMORY_PATH=./memory
테스트
이 스킬은 7360개의 테스트를 포함하여 높은 신뢰성을 보장합니다. 테스트는 다음 범주로 구성됩니다:
- 유닛 테스트: 개별 컴포너트 테스트
- 통합 테스트: 워크플로우 통합 테스트
- 엔드-투-엔드 테스트: 전체 세션 시뮬레이션
- 품질 게이트 테스트: 품질 검사 로직 검증
기여
기여는 환영합니다! Pull Request를 열기 전에 기여 가이드라인을 읽어주세요.
라이선스
MIT