00 general-pro 상호 연결성 및 시너지 효과 분석

5대 핵심 시스템(01-dev-rules-system, 02-reusable-code, 02-reusable-code-python, 03-skills, 04-agents)의 상호 연결 구조와 시너지 효과를 분석한 연구 문서.

작성일: 2026-02-16 | 최종 갱신: 2026-02-17 분석 대상: 83+개 상호 연결

목차

1. 발견된 시너지 효과 (10가지)
2. 상호 연결성 매트릭스
3. 프로젝트 전체 생명주기
4. 고유 기술 패턴
5. 시스템 강점 요약
6. 연결 수 통계

1. 발견된 시너지 효과 (10가지)

시너지 #1: 코드 순환 생명주기 (Code Lifecycle Loop)

가장 핵심적인 시너지. 코드가 "프로젝트 → 라이브러리 → 프로젝트"로 순환하며 성장한다.

프로젝트 A (개발 완료)
    │
    ▼ /kdyextract (추출 + 정제)
    │
02-reusable-code/ (저장소에 축적)
    │
    ▼ /kdypick (선택 + 적용)
    │
프로젝트 B (새 프로젝트에 적용)
    │
    ▼ (개발 중 개선)
    │
    ▼ /kdyextract (개선된 버전 다시 추출)
    │
02-reusable-code/ (업데이트됨)
    │
    ▼ 다음 프로젝트들...

핵심 메커니즘:

관여 컴포넌트: kdyextract ↔ 02-reusable-code ↔ kdypick ↔ docs/rules/reusable-code.md

시너지 #2: 인셉션 패턴 (Skill Inception)

스킬 내부에서 조건에 따라 하부 워크플로우가 발동되고, 그 안에서 다시 참조 데이터를 로드하는 다층 구조.

kdyweb의 5레벨 인셉션:

Level 1: SKILL.md (진입점 — 6모드 분기)
    │
    ▼ [조건: 계약 유무 + 사용자 의도]
    │
Level 2: phases/{mode}.md (모드별 워크플로우)
    │ ├── init.md (9단계)
    │ ├── page.md (7단계)
    │ ├── verify.md (7단계, 10가지 이슈유형)
    │ ├── migrate.md (6단계)
    │ ├── component.md (6단계)
    │ └── evolve.md (5단계)
    │
    ▼ [각 Phase의 Step에서 필요 시 로드]
    │
Level 3: references/*.md (참조 데이터 6종)
    │ ├── common-pages.md (7종 분류)
    │ ├── shared-variables.md (스택별 패턴)
    │ ├── connection-patterns.md (연결 패턴)
    │ ├── page-companions.md (동반 파일)
    │ ├── seo-metadata.md (메타데이터)
    │ └── component-registry.md (컴포넌트 → kdypick 매핑)
    │
    ▼ [초기화/마이그레이션 시]
    │
Level 4: contract/*.md (계약 템플릿)
    │ ├── _WEB_CONTRACT_TEMPLATE.md
    │ └── _MIGRATION_CHECKLIST.md
    │
    ▼ [50+ 페이지 프로젝트 시]
    │
Level 5: strategies/large-project.md (대규모 전략)

인셉션의 핵심: 파일을 동적으로 Read하여 컨텍스트에 주입하는 방식. Claude의 컨텍스트 윈도우를 효율적으로 사용하면서도, 필요한 순간에 정확한 지식을 로드한다.

시너지 #3: 스킬 연쇄 발동 (Skill Chain Triggers)

하나의 스킬이 완료되면 자동/추천으로 다음 스킬을 트리거하는 연쇄 구조.

자동 연쇄 (사용자 승인 불필요):
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
kdyweb (init)    ──자동──→ kdyweb (verify)
kdyweb (migrate) ──자동──→ kdyweb (verify)
kdyweb (evolve)  ──자동──→ kdyweb (verify) [변경 범위만]
kdyweb (page)    ──내장──→ 미니 verify [추가된 페이지만]

추천 연쇄 (사용자에게 다음 단계 제안):
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
kdysetting       ──추천──→ kdyweb (init)   ──추천──→ kdypick
kdyweb (init)    ──추천──→ kdypick (기반 컴포넌트)
kdyextract       ──참조──→ code-reviewer 기준

권장 전체 워크플로우:

kdysetting → kdyweb(init) → kdypick → [개발] → kdyextract → code-reviewer → kdyclean

시너지 #4: 에이전트-스킬 교차 참조 (Agent-Skill Cross-Reference)

에이전트와 스킬이 서로의 지식/기준을 활용하는 패턴.

특별 패턴 — URL 유무에 따른 스킬/에이전트 분기:

사용자가 URL을 알고 있음 → /crawler-code-generator (스킬, 빠름)
사용자가 URL을 모름     → web-crawler-builder (에이전트, 5단계 파이프라인)

시너지 #5: 컴포넌트 레지스트리 브릿지

kdyweb의 component-registry.md가 페이지 유형 → 필요 컴포넌트 → kdypick 경로를 매핑하여 스킬 간 다리 역할.

kdyweb (component 모드)
    │
    ▼ Read references/component-registry.md
    │
    ├── "대시보드" 페이지 → StatCard, RecentActivity, QuickActions 필요
    │                       → kdypick 기반: Card, Button
    │
    ├── "목록" 페이지 → {Resource}Table, {Resource}Filter 필요
    │                   → kdypick 기반: Table, Input, Select
    │
    └── "폼" 페이지 → {Resource}Form, FormActions 필요
                      → kdypick 기반: Input, Select, Textarea, Button

동기화 규칙 (component-registry.md 하단에 명시):

kdypick 매핑은 02-reusable-code/에 실제 존재하는 컴포넌트만 기재. 프로젝트 특화 컴포넌트 추가 시 먼저 /kdyextract로 등록 후 테이블에 추가.

이것이 만드는 순환:

kdyextract → 02-reusable-code에 등록 → component-registry에 추가 → kdyweb이 참조 → kdypick으로 적용

시너지 #6: 계약 기반 이중 통합

두 종류의 "계약" 시스템이 서로 다른 레벨에서 프로젝트를 관리.

교차점 (kdyweb SKILL.md에 명시):

병렬 개발 시 계약 파일 잠금: _WEB_CONTRACT.md는 한 터미널만 수정 가능.

시너지 #7: 품질 게이트 다층 연동

코드 품질이 여러 단계에서 서로 다른 도구로 검증되며, 기준이 공유된다.

┌─ 컨벤션 검증: kdyconvention (Layer 0~4 다층 규칙 체계)
│  └── Layer 0: 하드룰 (재정의 불가, H-01~H-04 등)
│  └── Layer 1~4: 글로벌 → 스택별 → 재사용 → 프로젝트 고유 (충돌 시 상위 우선)
│  └── 자동 수정 가능 항목: H-02, TS-02, TS-03, PY-02, RC-02
│  └── 임계값 기반 에이전트 에스컬레이션:
│       ├── CRITICAL 보안 ──→ security-reviewer 자동 발동
│       ├── HIGH 3+ ──→ code-reviewer 추천 발동
│       └── IMPORTANT 5+ ──→ 자동 수정 실행
│
├─ 추출 시: kdyextract Phase 4-A (code-reviewer 기준 참조)
│  └── 4항목: 정확성, 보안, 유지보수성, 컨벤션
│  └── 등급: A(통과) / B(개선→Phase 6에서 자동 수정) / C(거부 권장)
│
├─ 리뷰 시: code-reviewer 에이전트 (원본 6가지 검토 항목)
│  └── 6항목: 정확성, 보안, 성능, 유지보수성, 표준 준수, 품질 규칙
│  └── 05-code-quality/react-best-practices/ (45개 React 규칙)
│
├─ 웹 구조: kdyweb verify (10가지 이슈유형)
│  └── 풀뿌리 검증: 기계적 탐색 → 필요성 검증 (2단계)
│  └── 3단계 심각도: Critical / Important / Minor
│
├─ 보안: security-reviewer 에이전트 (OWASP Top 10)
│  └── Critical 이슈 → docs/logs/ 아카이브
│
└─ 컨벤션: docs/rules/reusable-code.md (공통 코딩 규칙)
   └── TS/Python 양쪽 통일 규칙 (메타데이터, 네이밍, import 순서)
   └── kdyextract, kdypick, code-reviewer 모두 이 파일 참조

kdyconvention ↔ kdygenesis 연동:

kdygenesis가 코드를 생성하는 모든 스킬 실행 후 kdyconvention을 자동 삽입하여, 품질 게이트가 파이프라인에 기계적으로 편입됩니다. kdyconvention의 Layer 0 하드룰은 어떤 프로젝트에서도 재정의할 수 없으므로, kdygenesis 오케스트레이션 하에서도 최소 보안/품질 기준이 보장됩니다.

시너지 #8: 개발 규칙의 폭포수 전파 (Rules Cascade)

01-dev-rules-system의 규칙이 스킬/에이전트를 통해 모든 프로젝트에 전파된다.

01-dev-rules-system/ (규칙 원본)
    │
    ├── 02-project-template/ ──→ kdysetting이 복사 ──→ 모든 프로젝트에 CLAUDE.md + docs/ 구조
    │                        (13개 명령어 + 10개 규칙 + Claude 훅 자동화)
    │
    ├── 05-code-quality/ ──→ code-reviewer가 참조 ──→ 리뷰 시 45개 React 규칙 적용
    │                    ──→ kdyextract Phase 4-A가 간접 참조
    │
    ├── 06-tech-rd/ ──→ Spike→POC→Integration→Iteration 방법론
    │               ──→ Python R&D 세션 프로토콜 + 계약 정의
    │
    ├── 07-parallel-dev/ ──→ kdyweb이 Stage 7 연동 ──→ 병렬 개발 환경에서 계약 통합
    │                    ──→ kdysetting이 선택적 복사 ──→ contracts/ 구조 생성
    │                    (7단계 + 4라운드 보강, 27개 누락 변수 해결)
    │
    └── docs/rules/reusable-code.md ──→ kdyextract/kdypick/code-reviewer 모두 참조
                                    ──→ 코드 라이브러리 통일 컨벤션 유지
                                    (TS + Python 양쪽 규칙 통합)

2. 상호 연결성 매트릭스

2.1 읽기/쓰기 관계 (전체)

2.2 스킬→스킬 연쇄

자동 연쇄:
  kdyweb (init)    ──자동──→ kdyweb (verify) ──추천──→ kdypick
  kdyweb (migrate) ──자동──→ kdyweb (verify)
  kdyweb (evolve)  ──자동──→ kdyweb (verify)
  kdyweb (page)    ──내장──→ 미니 verify
  kdygenesis       ──자동──→ kdysetting (항상 첫 번째)
  kdygenesis       ──자동──→ kdyconvention (코드 생성 후마다)
  kdygenesis       ──자동──→ inception (완료 시)

조건부 연쇄:
  kdygenesis       ──조건──→ kdyweb (웹 프로젝트 시)
  kdygenesis       ──조건──→ kdypick (재사용 코드 필요 시, 기능별 반복)
  kdygenesis       ──조건──→ kdye2e (Production+ 규모 시)
  kdygenesis       ──조건──→ kdyimagemid/anti (이미지 필요 시)

추천 연쇄:
  kdysetting          ──추천──→ kdyweb (init)
  kdyweb (init/page)  ──추천──→ kdypick (기반 컴포넌트)
  kdyweb (component)  ──선택──→ kdyweb (verify)
  kdyextract (Phase 4-A) ──참조──→ code-reviewer 검토 기준

컨벤션 위임:
  kdyconvention ──CRITICAL 보안──→ security-reviewer (자동 발동)
  kdyconvention ──HIGH 3+──→ code-reviewer (추천 발동)
  kdyconvention ──Phase 6-B──→ verify-implementation (verify-convention 생성)

2.3 에이전트-스킬 교차 참조

3. 프로젝트 전체 생명주기

3.1 통합 다이어그램

경로 A: 수동 실행 (개별 스킬 직접 호출)

┌──────────────────────────────── 프로젝트 생명주기 ────────────────────────────────┐
│                                                                                    │
│  1단계: 체계 구축              2단계: 웹 구조 초기화         3단계: 코드 가져오기    │
│  ┌──────────┐                 ┌──────────┐                 ┌──────────┐            │
│  │kdysetting│───추천──→       │  kdyweb  │───추천──→       │ kdypick  │            │
│  └────┬─────┘                 │  (init)  │                 └────┬─────┘            │
│       │                       └────┬─────┘                      │                  │
│  01-dev-rules                 자동 │                     02-reusable-code           │
│  → CLAUDE.md                  ┌────┴─────┐              → src/에 적용               │
│  → docs/ 구조                 │  verify  │                                         │
│                               └──────────┘                                         │
│                                                                                    │
│  4단계: 개발                   5단계: 검증/리뷰                                     │
│  ┌──────────┐                 ┌───────────────┐  ┌───────────────┐                 │
│  │  kdyweb  │                 │kdyconvention   │  │ code-reviewer │                 │
│  │(page/comp│                 │ (품질 게이트)  │──→ security-rev │                 │
│  │ onent)   │                 └───────┬───────┘  └───────┬───────┘                 │
│  └────┬─────┘                         │                  │                          │
│       │                               ▼                  ▼                          │
│  자동 미니verify              자동 수정 +            docs/logs/                     │
│                               에이전트 위임          아카이브                        │
│                                                                                    │
│  6단계: 코드 추출              7단계: 정리            8단계: 세션 종료              │
│  ┌──────────┐                 ┌──────────┐          ┌──────────┐                   │
│  │kdyextract │───참조──→      │ kdyclean │          │   /cs    │                   │
│  │          │ code-reviewer   └──────────┘          └──────────┘                   │
│  └────┬─────┘ 기준                                   docs/handover/                │
│       ▼                                                                            │
│  02-reusable-code/ (축적) → 다음 프로젝트 kdypick으로 재사용 (순환)                │
│                                                                                    │
└────────────────────────────────────────────────────────────────────────────────────┘

경로 B: 자동 오케스트레이션 (/kdygenesis)

┌──────────────────────── kdygenesis 오케스트레이션 ─────────────────────────────────┐
│                                                                                    │
│  /kdygenesis                                                                       │
│       │                                                                            │
│  Phase 0: 기획 탐색 (사용자 질문 → 프로젝트 전체상 파악)                           │
│       │                                                                            │
│  Phase 1: 청사진 조립 (기능→스킬 매핑 → 적응적 DAG 생성)                           │
│       │                                                                            │
│  Phase 2: 연쇄 실행 + 풀뿌리 확산                                                  │
│       │                                                                            │
│       ├── kdysetting ──→ kdyweb ──→ kdypick(auth) ──→ kdypick(ui) ──→...          │
│       │                                                                            │
│       ├── 각 코드 생성 후 ──→ kdyconvention 자동 발동 (품질 게이트)                 │
│       │                          └── 자기반성 → security-reviewer / code-reviewer  │
│       │                                                                            │
│       └── GAP 발견 시 ──→ Phase 3 (스킬 생성) ──→ Phase 2 복귀                     │
│                                                                                    │
│  Phase 4: 완료 & 동기화                                                            │
│       ├── kdyconvention (최종 통합 검증)                                            │
│       └── inception (의존성 맵 갱신)                                               │
│                                                                                    │
│  ※ 경로 A의 수동 흐름을 DAG로 자동 실행 + 풀뿌리 확산                              │
│                                                                                    │
└────────────────────────────────────────────────────────────────────────────────────┘

3.2 단계별 상세

4. 고유 기술 패턴

4.1 동적 지식 로딩 (Dynamic Knowledge Loading)

스킬이 Read 도구로 자기 자신의 하위 파일을 읽어 컨텍스트에 주입하는 패턴. Claude의 컨텍스트 윈도우를 효율적으로 사용.

SKILL.md 진입 → 조건 판단 → Read phases/init.md → 실행 중 Read references/common-pages.md

장점: 전체 스킬 지식(kdyweb의 경우 15+개 파일)을 한번에 로드하지 않고, 필요한 순간에 필요한 지식만 로드.

적용 범위:

• kdyweb: 5레벨 인셉션 (SKILL → phases → references → contract → strategies)
• kdyextract: Phase별 순차 로드 (비교 → 품질검증 → 정제)
• kdypick: 프로젝트 상태에 따라 Phase 0-A 또는 Phase 1 분기 로드

4.2 품질 게이트 상속 (Quality Gate Inheritance)

code-reviewer의 6가지 검토 기준이 kdyextract에서 4항목으로 간소화되어 재사용.

code-reviewer (원본 6항목)
    │ 정확성, 보안, 성능, 유지보수성, 표준 준수, 품질 규칙
    │
    ▼ kdyextract Phase 4-A (파생 4항목)
    │ 정확성, 보안, 유지보수성, 컨벤션
    │
    ▼ A/B/C 등급 판정
      A: 통과 → Phase 5로 진행
      B: 개선 필요 → Phase 6에서 자동 수정 후 진행
      C: 거부 권장 → 사용자에게 알림

4.3 컨텍스트 감지 자동 분기 (Context-Aware Branching)

스킬이 프로젝트 상태를 자동 감지하여 적절한 모드로 분기.

4.4 이중 계약 시스템 (Dual Contract System)

웹 구조 계약(kdyweb)과 코드 계약(Stage 7)이 서로 다른 레벨에서 프로젝트를 보호하며, kdyweb init Phase 0-A에서 Stage 7 contracts/를 감지하여 연동.

웹 계약 (_WEB_CONTRACT.md)        코드 계약 (src/contracts/*.ts)
    │                                  │
    ├── 페이지 목록 + 라우트            ├── 함수 시그니처
    ├── 페이지 간 연결성                ├── 타입 3-Tier 계층
    ├── 공유 레이아웃                   ├── import 규칙
    └── 동반 파일 (API, loading 등)     └── 네이밍 규칙
         │                                  │
         └──── kdyweb init 0-A에서 ────────┘
               Stage 7 contracts/ 감지 시 연동

시너지 #9: 메타 오케스트레이션 (kdygenesis)

기존 8가지 시너지를 "지휘"하는 상위 시너지. kdygenesis가 프로젝트 시작 시 모든 스킬을 적응적으로 연결합니다.

kdygenesis (메타 오케스트레이터)
    │
    ├── #1 코드 순환 생명주기
    │   → kdygenesis가 extract/pick 타이밍 자동 결정
    │
    ├── #2 인셉션 패턴
    │   → kdygenesis 자체가 5레벨 인셉션 (SKILL→phases→refs→contract→strategies)
    │   → 풀뿌리 확산이 인셉션의 동적 버전 (실행 중 새 레벨 생성)
    │
    ├── #3 스킬 연쇄 발동
    │   → kdygenesis가 연쇄를 설계(DAG)하고 실행
    │   → 고정 파이프라인이 아닌 적응적 체인
    │
    ├── #4 에이전트-스킬 교차
    │   → kdyconvention이 자기반성으로 에이전트 조건부 위임
    │   → kdygenesis → kdyconvention → code-reviewer/security-reviewer
    │
    ├── #5 컴포넌트 레지스트리
    │   → kdygenesis Phase 1에서 레지스트리 기반 기능→스킬 매핑
    │
    ├── #7 품질 게이트 다층
    │   → kdygenesis가 매 스킬 실행 후 kdyconvention 게이트 삽입
    │   → kdyconvention의 Layer 0~4가 스택별 규칙 자동 활성화
    │   → 임계값 기반 에이전트 에스컬레이션 (기계적→판단 기반)
    │
    └── #8 규칙 전파
        → kdygenesis가 프로젝트 시작 시 규칙 세트 결정
        → kdyconvention이 해당 규칙의 실시간 검증 담당

핵심 메커니즘 — 자기반성의 인셉션 효과:

kdyconvention의 "자기반성"과 kdygenesis의 "풀뿌리 확산"은 동형 패턴:

공통 원리: "자기 능력의 경계를 인식하고, 더 적합한 도구를 호출한다" 이것이 시스템 전체의 메타 인셉션: 스킬이 자신의 한계를 아는 스킬.

관여 컴포넌트: kdygenesis → 전체 스킬/에이전트 생태계 (6+ 스킬, 3+ 에이전트)

시너지 #10: 적응적 DAG 구축 + 풀뿌리 확산

kdygenesis만의 고유 패턴. 기존 연쇄 발동(시너지 #3)이 고정 파이프라인이라면, kdygenesis의 DAG는 프로젝트 특성에 따라 동적으로 구성됩니다.

기존 연쇄 (#3):   kdysetting → kdyweb → kdypick → [고정]
적응적 DAG (#10): kdygenesis가 Phase 0 분석 결과로 DAG를 설계

예시 1 (웹 프로젝트):
  kdysetting → kdyweb → kdypick(auth) → kdypick(ui) → [개발] → kdyconvention

예시 2 (API 전용):
  kdysetting → kdypick(api) → kdypick(db) → [개발] → kdyconvention

예시 3 (풀뿌리 확산 발생):
  kdysetting → kdyweb → [GAP 발견: 결제 기능]
    → Phase 3: 결제 스킬 생성 → DAG에 삽입 → Phase 2 복귀

풀뿌리 확산의 안전 장치:

관여 컴포넌트: kdygenesis (Phase 1 DAG 설계 + Phase 2 실행 + Phase 3 확산)

시너지 #11: 연구자료 누적 순환 (Research Accumulation Loop)

08-research-vault를 중심으로 HWPX 연구자료가 주제별로 누적되며, 여러 인텔리전스/리서치 스킬이 양방향으로 연동된다.

HWPX 파일 입수
    │
    ▼ 분석 카드 작성
08-research-vault/{topic}/analyses/
    │
    ├── kdyintel ──→ 보고서 주제와 교차 참조, 기회 카드와 연구자료 매핑
    ├── kdynotebook ──→ 리서치 결과를 분석 카드로 변환하여 누적
    ├── kdywave ──→ Wave 산출물을 주제별 분석 카드로 아카이빙
    └── kdyspike ──→ 스파이크 기술 검증 결과를 연구자료로 저장
    │
    ▼ 3건+ 누적 시
08-research-vault/{topic}/synthesis/
    │
    ├── 교차 분석: 분석 카드 간 공통점/차이점
    ├── 시계열 변화: 시간에 따른 정책/기술 변화 추적
    └── 미해결 질문: 추가 연구 필요 영역 도출
    │
    ▼ 인사이트 피드백
    ├── kdyidea ──→ 아이디어 기획 시 기존 연구자료 참조
    └── kdynext ──→ 건강 진단 시 vault 점검

핵심 가치: 일회성 분석이 아닌 주제별 지식 누적. 동일 주제에 대한 분석이 쌓일수록 종합 문서의 인사이트 품질이 향상되는 복리 효과.

관여 컴포넌트: 08-research-vault, kdyintel, kdynotebook, kdywave, kdyspike, kdyidea, kdynext

5. 시스템 강점 요약

6. 연결 수 통계

컴포넌트별 연결 밀도

관련 문서

• 연쇄 의존성 맵 — 스킬/에이전트 간 의존성 요약
• 코딩 컨벤션 — TS/Python 통일 규칙
• Claude Code 공식 스펙 — Skills, Hooks, MCP, Agent Teams

최종 갱신

• 2026-03-25: 08-research-vault 통합 — 시너지 #11(연구자료 누적 순환) 추가, 강점 요약 1행, 통계 332+→346+ 갱신
• 2026-03-08: kdyselfreflection 연결 통계 83+→265+ 갱신 (_COMPONENT_MAP.md 최신 값 반영)
• 2026-02-17: 정합성 수정 — 시너지 #10 추가 (적응적 DAG+풀뿌리 확산), 매트릭스 2.1에 kdygenesis·kdyconvention·manage-skills·verify-impl·kdye2e·kdyimagemid·inception 행 추가, 연쇄 2.2에 kdygenesis 자동/조건부/컨벤션 위임 체인 추가, 에이전트 교차 2.3에 kdygenesis·kdyconvention 관계 5건 추가, 생명주기 3.1을 경로 A(수동)/B(자동) 이중 다이어그램으로 갱신, 3.2에 kdyconvention·kdygenesis 행 추가, 시너지 #7에 kdyconvention 상세 보강
• 2026-02-17: kdygenesis 메타 오케스트레이션 시너지 #9 추가, 통계 갱신 (45→83+), 컴포넌트 밀도에 kdygenesis·kdyconvention 추가
• 2026-02-16: 초판 작성 (8가지 시너지, 45+개 연결 분석)