kdyswarm — 병렬 멀티에이전트 개발 오케스트레이션

N개 에이전트를 DAG 순서로 병렬 발사하여 대규모 기능을 동시 구현하는 스킬입니다. 4계층 가이드라인(L1~L4)으로 에이전트를 정렬하고, 워크트리 격리로 충돌을 방지하며, 의존성 순서로 통합합니다.

핵심 원칙

기본 경로

GENERAL_PRO 결정 순서:
1. 환경변수 GENERAL_PRO_PATH
2. CWD가 00-general-pro* 내부이면 해당 루트
3. ~/{develop,dev}/00-general-pro-web 존재 탐색
4. 실패 시 AskUserQuestion: "00-general-pro-web 경로를 입력해주세요"

GENERAL_PRO = {결정된 경로}
PHASES_DIR = $GENERAL_PRO/03-skills/kdyswarm/phases
REFERENCES_DIR = $GENERAL_PRO/03-skills/kdyswarm/references

인수 처리

사용자가 제공한 인수: $ARGUMENTS

Phase 흐름

Phase 0: 컨텍스트 탐지  → 프로젝트/스택/규모 감지 + 파라미터 확정
Phase 1: 가이드라인 생성  → L1(표준) + L2(코딩 지침) 생성
Phase 2: 작업 분해       → 기능 분해 + 에이전트 배정 + DAG + L3/L4 생성
Phase 3: 사용자 확인     → 전체 계획 표시 + 승인 게이트
Phase 4: 병렬 실행       → Agent × N (워크트리 격리, 백그라운드)
Phase 5: 통합           → DAG 순서 머지 + 충돌 해결 + 연결
Phase 6: 검증           → tsc → kdyconvention → kdyconecttest → kdye2e
Phase 7: 보고서         → 실행 요약 + 비용 + 검증 + TODO + 아카이브

Phase 0: 컨텍스트 탐지

상세: phases/context-detection.md 참조

1. 체크포인트 확인: --resume 또는 기존 .kdyswarm/ 감지
2. 프로젝트 루트 탐지: package.json / pyproject.toml 등으로 루트 결정
3. 스택 감지: 시그니처 파일로 스택/프레임워크 자동 결정
4. 규모 측정: 소스 파일 수 → S/M/L/XL (references/scale-matrix.md)
5. 인수 파싱: --auto, --budget, --teams 등 처리
6. 엔진 확인: Agent 도구 / Agent Teams 가용성
7. 체크포인트 초기화: _CHECKPOINT_KDYSWARM.md 생성

Phase 1: 가이드라인 생성

상세: phases/guideline-generation.md 참조 템플릿: references/guideline-templates.md 참조

1. L1 프로젝트 표준: CLAUDE.md + docs/rules/ + 빌드 설정에서 추출
2. L2 공통 코딩 지침: parallel-dev-coding-conventions.md + 스택별 규칙
3. L3/L4: Phase 2 이후 생성 (에이전트 확정 필요)
4. 저장: .kdyswarm/guidelines/

Phase 2: 작업 분해

상세: phases/task-decomposition.md 참조

1. 기능 인벤토리: 사용자 요청 + 프로젝트 구조 분석
2. 독립 단위 분해: 단일 책임 + 최소 의존 원칙
3. 에이전트 배정: 규모별 에이전트 수 + 모델 배분 (references/model-distribution.md)
4. 소유권 맵: 🔴🟡🟢 3등급 자동 분류 (references/ownership-protocol.md)
5. DAG 구축: L0(계약)→L1(기반)→L2(독립)→L3(통합)
6. L3/L4 생성: 에이전트별 미션 + 인터페이스 계약
7. 비용 추정: references/cost-calculator.md 공식 적용

Phase 3: 사용자 확인

상세: phases/user-confirmation.md 참조

• 전체 계획 표시: 규모, 에이전트, 모델, 비용, DAG, 소유권
• --auto → 승인 건너뜀
• --dry-run → 계획만 출력하고 종료
• 사용자: 진행 / 수정 / 중단

Phase 4: 병렬 실행

상세: phases/parallel-execution.md 참조

engine:agent (기본)

DAG 레벨별 순회:
  L0 → 순차 (계약 확정)
  L1 → 제한 병렬
  L2 → 최대 병렬 (Agent × N, isolation:worktree, run_in_background)
  L3 → 순차 (통합)

각 에이전트 프롬프트 = L1 + L2 + L3(본인) + L4(관련 계약)

engine:teams (선택)

TaskCreate × N + Mailbox 모니터링

안전 장치

• 타임아웃: 모델별 제한 (opus 10분, sonnet 5분, haiku 2분)
• 실패 복구: 1회 자동 재시도, 2회 실패 시 건너뜀
• 3연속 실패: AskUserQuestion → 계속/중단
• 비용 ceiling: 초과 시 경고 + 선택지

Phase 5: 통합

상세: phases/integration.md 참조 머지 전략: references/merge-strategy.md 참조

1. 소유권 검증: 에이전트별 변경 파일 vs 소유권 맵
2. DAG 순서 머지: L0→L1→L2→L3 순차 git merge --no-ff
3. 충돌 해결: 자동(네임스페이스 비충돌) / 반자동 / 수동
4. 타입/Import 연결: Mock→실제, Provider 등록, Route 연결
5. 워크트리 정리: 머지 완료 워크트리 제거

Phase 6: 검증

상세: phases/validation.md 참조

순차 검증 파이프라인:

tsc/mypy → kdyconvention → kdyconecttest → kdye2e

• 각 단계 실패 시 자동 수정 시도
• 수정 불가 → TODO 기록
• 전체 미해결 시 AskUserQuestion

Phase 7: 보고서

상세: phases/report.md 참조

• 실행 요약: 에이전트별 결과, 소요 시간
• 비용 실적: 추정 vs 실적 비교 (references/cost-calculator.md)
• 검증 결과: 각 검증 단계 상태
• 미완료 TODO: 에이전트/사유/권장 조치
• 다음 권장 작업: inception, kdyupdate 등
• 아카이브: .kdyswarm/ 유지, 체크포인트 완료 표시

Superpowers 연계

이 스킬 실행 중 아래 superpowers 원칙을 적용한다.

예외사항

다음은 kdyswarm의 문제가 아닌 것입니다:

• 프로젝트 초기 구조 생성: kdygenesis 또는 kdysetting 사용
• 단일 기능 구현: 에이전트 1개 수준이면 직접 구현이 효율적
• 코드 추출/패키징: kdyextract 사용
• 기존 코드 리팩토링: kdyconvention 사용

관련 스킬/에이전트

사용 예시

# 기본 실행 — 프로젝트 분석 후 병렬 개발
/kdyswarm 대시보드 + API + 인증 모듈 구현

# 예산 제한
/kdyswarm 결제 시스템 구현 --budget 10

# 계획만 확인
/kdyswarm 전체 리빌드 --dry-run

# 자동 모드 (확인 없이 실행)
/kdyswarm CRUD 5개 모듈 --auto

# 이전 실행 재개
/kdyswarm --resume

# 규모 강제 + 에이전트 수 지정
/kdyswarm --scale L --agents 8

주의사항

• 비용: 에이전트 수 × 모델에 따라 비용이 발생합니다. --dry-run으로 먼저 확인 권장
• 워크트리: Git 워크트리를 사용하므로 uncommitted 변경사항은 미리 커밋해주세요
• 체크포인트: 중단 시 _CHECKPOINT_KDYSWARM.md에 진행 상태가 저장됩니다
• 소유권: 에이전트 간 파일 충돌은 소유권 맵으로 방지하지만, 100% 보장은 아닙니다