진화 명령

언제 쓰나

코드 구조를 개선하거나 발전시키고 싶을 때

---
name: evolve
description: 본능을 분석하고 진화된 구조를 제안하거나 생성합니다
command: true
---

# Evolve 명령

## 구현

인스톨 CLI를 플러그인 루트 경로를 사용하여 실행합니다:

```bash
python3 "${CLAUDE_PLUGIN_ROOT}/skills/continuous-learning-v2/scripts/instinct-cli.py" evolve [--generate]
```

또는 `CLAUDE_PLUGIN_ROOT`가 설정되지 않은 경우(수동 설치):

```bash
python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py evolve [--generate]
```

본능을 분석하고 관련된 본능을 더 높은 수준의 구조로 클러스터링합니다:
- **명령**: 사용자 호출 동작을 설명하는 본능일 때
- **스킬**: 자동으로 트리거되는 동작을 설명하는 본능일 때
- **에이전트**: 복잡한 다단계 프로세스를 설명하는 본능일 때

## 사용법

```
/evolve                    # 모든 본능을 분석하고 진화를 제안합니다
/evolve --generate         # 분석 출력 외에 진화된 파일을 생성합니다
```

## 진화 규칙

### → 명령 (사용자 호출)
사용자가 명시적으로 요청하는 동작을 설명하는 본능일 때:
- "사용자가 요청할 때..."에 대한 여러 본능
- "새로운 X를 생성할 때"와 같은 트리거가 있는 본능
- 반복 가능한 순서를 따르는 본능

예시:
- `new-table-step1`: "데이터베이스 테이블을 추가할 때, 마이그레이션을 생성합니다"
- `new-table-step2`: "데이터베이스 테이블을 추가할 때, 스키마를 업데이트합니다"
- `new-table-step3`: "데이터베이스 테이블을 추가할 때, 유형을 다시 생성합니다"

→ 생성: **new-table** 명령

### → 스킬 (자동 트리거)
자동으로 발생해야 하는 동작을 설명하는 본능일 때:
- 패턴 매칭 트리거
- 오류 처리 응답
- 코드 스타일 적용

예시:
- `prefer-functional`: "함수를 작성할 때, 함수형 스타일을 선호합니다"
- `use-immutable`: "상태를 수정할 때, 불변 패턴을 사용합니다"
- `avoid-classes`: "모듈을 설계할 때, 클래스 기반 설계를 피합니다"

→ 생성: `functional-patterns` 스킬

### → 에이전트 (깊이/분리 필요)
복잡한 다단계 프로세스를 설명하는 본능일 때:
- 디버깅 워크플로우
- 리팩토링 시퀀스
- 연구 태스크

예시:
- `debug-step1`: "디버깅할 때, 먼저 로그를 확인합니다"
- `debug-step2`: "디버깅할 때, 실패하는 구성 요소를 분리합니다"
- `debug-step3`: "디버깅할 때, 최소한의 재현을 생성합니다"
- `debug-step4`: "디버깅할 때, 테스트로 수정을 확인합니다"

→ 생성: **debugger** 에이전트

## 해야 할 일

1. 현재 프로젝트 컨텍스트를 감지합니다
2. 프로젝트 및 전역 본능을 읽습니다(프로젝트가 ID 충돌에서 우선합니다)
3. 본능을 트리거/도메인 패턴으로 그룹화합니다
4. 확인합니다:
   - 스킬 후보자(2개 이상의 본능이 있는 트리거 클러스터)
   - 명령 후보자(고신뢰도 워크플로우 본능)
   - 에이전트 후보자(큰, 고신뢰도 클러스터)
5. 프로젝트에서 전역으로 승격할 수 있는 후보자를 표시합니다(적용 가능할 때)
6. `--generate`가 전달되면 파일을 작성합니다:
   - 프로젝트 범위: `~/.claude/homunculus/projects/<project-id>/evolved/`
   - 전역 폴백: `~/.claude/homunculus/evolved/`

## 출력 형식

```
============================================================
  EVOLVE 분석 - 12개 본능
  프로젝트: my-app (a1b2c3d4e5f6)
  프로젝트 범위: 8 | 전역: 4
============================================================

고신뢰도 본능 (>=80%): 5

## 스킬 후보자
1. 클러스터: "테스트 추가"
   본능: 3
   평균 신뢰도: 82%
   도메인: 테스팅
   범위: 프로젝트

## 명령 후보자 (2)
  /테스트 추가
    원본: test-first-workflow [프로젝트]
    신뢰도: 84%

## 에이전트 후보자 (1)
  테스트 추가 에이전트
    3개의 본능을 커버합니다
    평균 신뢰도: 82%
```

## 플래그

- `--generate`: 분석 출력 외에 진화된 파일을 생성합니다

## 생성된 파일 형식

### 명령
```markdown
---
name: new-table
description: 마이그레이션, 스키마 업데이트 및 유형 생성과 함께 새로운 데이터베이스 테이블을 생성합니다
command: /new-table
evolved_from:
  - new-table-migration
  - update-schema
  - regenerate-types
---

# 새로운 테이블 명령

[클러스터링된 본능을 기반으로 생성된 내용]

## 단계
1. ...
2. ...
```

### 스킬
```markdown
---
name: functional-patterns
description: 함수형 프로그래밍 패턴을 적용합니다
evolved_from:
  - prefer-functional
  - use-immutable
  - avoid-classes
---

# 함수형 패턴 스킬

[클러스터링된 본능을 기반으로 생성된 내용]
```

### 에이전트
```markdown
---
name: debugger
description: 체계적인 디버깅 에이전트
model: sonnet
evolved_from:
  - debug-check-logs
  - debug-isolate
  - debug-reproduce
---

# 디버거 에이전트

[클러스터링된 본능을 기반으로 생성된 내용]
```

1. 1

   SKILL.md 저장

   아래 버튼으로 복사 → 다음 경로로 저장.

   SKILL.md 복사

   macOSLinuxWindows

   ~/.claude/skills/everything-claude-code-110/SKILL.md경로 복사
2. 2

   호출

   Claude Code 채팅창에서 자연어로 부르면 자동 발동:

   예) 코드 구조를 개선하거나 발전시키고 싶을 때

   트리거가 안 잡히면 SKILL.md의 description 줄에 더 구체적인 한국어 키워드를 추가해보세요.