kdygenesis — 프로젝트 메타 오케스트레이션

씨앗 하나에서 뿌리가 뻗어나가듯, 단일 진입점에서 프로젝트 체계를 자동 구축하는 메타 오케스트레이션 스킬입니다.

핵심 원칙

기본 경로

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 = {결정된 경로}
SKILLS_DIR = $GENERAL_PRO/03-skills
REUSABLE_TS = $GENERAL_PRO/02-reusable-code
REUSABLE_PY = $GENERAL_PRO/02-reusable-code-python
PHASES_DIR = $GENERAL_PRO/03-skills/kdygenesis/phases
REFERENCES_DIR = $GENERAL_PRO/03-skills/kdygenesis/references

인수 처리

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

Phase 흐름

Step 0-0: 체크포인트 확인  → --resume 또는 기존 _PROJECT_GENESIS.md 탐지
Phase 0: 기획 탐색        → 프로젝트 전체상 파악 (사용자 질문)
Phase 1: 청사진 조립       → 스킬 실행 DAG 생성 (기능→스킬 매핑)
Phase 2: 연쇄 실행 + 확산  → DAG 순서대로 실행 + 풀뿌리 확산
Phase 3: 스킬 등록         → 부족한 스킬 즉석 생성 (확산에서 촉발)
Phase 4: 완료 & 동기화     → 최종 검증 + inception + 기록

Step 0-0: 체크포인트 확인

--resume 인수 또는 기존 _PROJECT_GENESIS.md 존재 시 중단 지점에서 재개합니다.

if --resume:
  Read: docs/references/_PROJECT_GENESIS.md
  → 마지막 완료 Phase/Level 확인
  → Phase 0~1 재실행 없이 DAG 상태 복원
  → 미완료 스킬부터 Phase 2 재개
elif _PROJECT_GENESIS.md 파일이 이미 존재하고 상태가 미완료:
  AskUserQuestion: "이전 세션의 Genesis 계약이 있습니다. 재개/새로 시작?"
  → "재개" → 위 --resume 로직과 동일
  → "새로 시작" → 기존 파일 백업 후 Phase 0부터 정상 진행
else:
  Phase 0부터 정상 진행

Phase 0: 기획 탐색 (Project Discovery)

사용자에게 체계적으로 질문하여 프로젝트 전체상을 파악합니다. 상세 워크플로우: phases/discovery.md 참조

0-1. 프로젝트 유형 감지

Glob: package.json, pyproject.toml, CLAUDE.md, .git

• 기존 프로젝트: 위 파일 중 하나 이상 존재 → 기존 프로젝트 분석 모드
• 새 프로젝트: 빈 디렉토리 또는 일반 프로 내부 실행 → 프로젝트 생성 모드

기존 프로젝트인 경우: 프로젝트 루트 확인 후 기존 상태 분석부터 시작합니다. 새 프로젝트인 경우: 대상 디렉토리를 먼저 확인합니다.

0-2. 상세 기획 정보 수집

phases/discovery.md를 로드하여 체계적 질문을 수행합니다:

Read: $PHASES_DIR/discovery.md

수집 항목:

• 프로젝트 유형 (web/api/cli/library/mobile/hybrid)
• 기술 스택 (프레임워크, DB, 인증, 배포)
• 기능 인벤토리 (인증, 결제, 실시간, 파일 업로드 등)
• 규모 (MVP / Production / Enterprise)
• 페이지/화면 구성 (kdyweb 분류 활용)

0-3. 기존 자산 스캔 (자동)

Read: $REUSABLE_TS/README.md
Read: $REUSABLE_PY/README.md

02-reusable-code 인벤토리를 로드하여 활용 가능한 기존 자산을 파악합니다. 기존 프로젝트인 경우 프로젝트 코드도 분석합니다.

0-4. _PROJECT_GENESIS.md Phase 0 섹션 기록

수집된 정보를 대상 프로젝트의 docs/references/_PROJECT_GENESIS.md에 기록합니다.

Phase 1: 청사진 조립 (Blueprint Assembly)

Phase 0의 답변을 기반으로 스킬 실행 DAG를 생성합니다. 상세 워크플로우: phases/blueprint.md 참조

Read: $PHASES_DIR/blueprint.md
Read: $REFERENCES_DIR/feature-skill-map.md

1-1. 기능→스킬 매핑

references/feature-skill-map.md의 매핑 테이블을 기반으로 각 기능에 대응하는 스킬을 결정합니다.

1-2. GAP 분석

매핑되지 않는 기능을 추출하고 해결 전략을 분류합니다:

• EXTEND: 기존 스킬에 모드/참조 추가
• CREATE: 새 스킬 생성 필요 → Phase 3에서 처리
• MANUAL: 사용자가 직접 개발
• DEFER: 나중에 결정

1-3. 실행 DAG 생성

의존성 순서대로 스킬을 정렬하고 병렬 가능한 그룹을 식별합니다. kdyconvention 게이트를 코드 생성 후 자동 삽입합니다.

1-4. kdyconvention 레이어 사전 결정

Phase 0에서 파악한 스택 정보로 kdyconvention 활성 레이어를 미리 결정합니다:

1-5. 사용자 승인

AskUserQuestion으로 DAG와 GAP 해결 전략을 확인받습니다. 확산 예산도 설정합니다 (기본: depth=3, spawn=10).

출력: _PROJECT_GENESIS.md Phase 1 섹션

Phase 2: 연쇄 실행 + 풀뿌리 확산

DAG 순서대로 스킬을 실행하되, 새로운 needs에 적응적으로 대응합니다. 상세 워크플로우: phases/execution.md 참조 확산 프로토콜: references/expansion-protocol.md 참조

Read: $PHASES_DIR/execution.md

2-1. DAG 실행 루프

확산 상태 초기화:
  current_depth = 0
  spawn_count = 0
  depth_limit = 3
  spawn_limit = 10

WHILE DAG에 미실행 스킬 존재:
  1. 의존성 충족된 스킬 선택
  2. 코드 컨벤션 참조 로드 (코드 생성 스킬인 경우)
  3. 스킬 실행
  4. 실행 후 평가:
     - 코드 생성됨? → kdyconvention 자동 발동
     - 새 GAP 발견? → 풀뿌리 확산 프로토콜 (Step 2-5)
  5. _PROJECT_GENESIS.md 진행 상황 기록
  6. 다음 스킬로 진행

2-2. kdyconvention 게이트

코드가 생성되는 모든 스킬 실행 후 kdyconvention을 자동 발동합니다:

kdyconvention 발동 (--scope 생성된 파일):
  ├── CRITICAL 보안 → security-reviewer 자동 발동
  ├── HIGH >= 3 → code-reviewer 추천 발동
  ├── IMPORTANT >= 5 → 자동 수정 실행
  └── MINOR만 → 보고서만 출력

kdygenesis가 직접 리뷰하지 않고 kdyconvention에 위임합니다.

2-3. 풀뿌리 확산 프로토콜

실행 중 GAP 발견 시:

Read: $REFERENCES_DIR/expansion-protocol.md

1. 확산 예산 확인 (depth < limit? spawn < limit?)
2. Gap 유형 분류 (SKILL_GAP / CODE_GAP / REFERENCE_GAP / CONVENTION_GAP)
3. 예산 내 → 자동 실행 (승인 불필요)
4. 예산 초과 → AskUserQuestion으로 승인
5. Phase 3 진입 → DAG 갱신 → 루프 복귀

Phase 3: 스킬 등록 (Skill Registration)

풀뿌리 확산에서 필요한 새 스킬을 생성하고 등록합니다. 상세 워크플로우: phases/registration.md 참조 체크리스트: references/skill-creation-checklist.md 참조

Read: $PHASES_DIR/registration.md

3-1. 스킬 스코프 자동 판단

범용성 점수 기반으로 글로벌/로컬 배치를 결정합니다:

• 점수 >= 2 → 03-skills/{name}/SKILL.md (글로벌)
• 점수 < 2 → .claude/skills/{name}/SKILL.md (프로젝트 로컬)

3-2. 스킬 생성 + 리뷰

skill-writing-best-practices를 준수하여 SKILL.md를 생성하고, code-reviewer 에이전트로 검증합니다.

3-3. DAG 갱신 후 Phase 2로 복귀

Phase 4: 완료 & 동기화 (Completion & Sync)

전체 체인 실행 완료 후 시스템 정합성을 보장합니다. 상세 워크플로우: phases/completion.md 참조

Read: $PHASES_DIR/completion.md

4-1. 최종 검증

kdyconvention을 전체 생성 코드 범위로 실행합니다 (통합 검증). Phase 2에서 파일별로 이미 실행했지만, 최종 통합 검증을 수행합니다.

4-2. 시스템 동기화

• /inception 발동 → _COMPONENT_MAP.md 갱신
• CLAUDE.md 갱신 (신규 스킬 테이블 추가)

4-3. Genesis 계약 완료

_PROJECT_GENESIS.md 최종 상태를 기록합니다:

• 실행된 스킬 목록 + 결과
• 생성된 스킬 목록 + 위치
• 확산 로그 (depth/spawn 사용량)
• 코드 리뷰 결과 요약
• 남은 TODO 목록

4-4. 다음 단계 권장

## 다음 단계

1. {kdyweb page로 추가할 페이지 목록}
2. {개발 시작 권장 영역}
3. {나중에 처리할 DEFER 항목}

엣지 케이스 처리

Superpowers 연계

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

kdyswarm 위임 조건

다음 조건이 모두 충족될 때 /kdyswarm으로 위임을 권장한다:

• Phase 1 DAG에 동일 레벨 독립 스킬이 5개 이상
• 프로젝트 규모가 Production 또는 Enterprise

관련 스킬/에이전트

사용 예시

# 새 프로젝트 시작
/kdygenesis

# 기존 프로젝트에 체계 적용
/kdygenesis

# 이전 세션에서 중단된 DAG 지점부터 재개
/kdygenesis --resume