evolve

1# Harness Evolve — 하네스 진화 메커니즘
2 
3하네스는 고정물이 아니라 진화하는 시스템이다. 이 스킬은 "무엇이 먹혔고 무엇이 안 먹혔는가"의 델타를 포착해 하네스에 되먹여, 다음 실행이 측정 가능하게 더 나아지도록 한다.
4 
5```
6초기 하네스 ──▶ 실 프로젝트 사용 ──▶ 현재 하네스
7                                        │
8                                        ▼ (evolve로 델타 포착)
9                                  피드백 일반화 → 에이전트·스킬·오케스트레이터 반영
10                                        │
11                                        ▼
12                                  변경 이력 갱신 → 다음 실행은 더 나은 초안에서 시작
13```
14 
15## 워크플로우
16 
17### Phase 1: 델타 수집
18 
191. `.claude/agents/`, `.claude/skills/`, `CLAUDE.md`(변경 이력 테이블)를 읽는다
202. git 저장소라면 하네스 파일들의 변경 이력을 조회한다 (`git log --oneline -- .claude/ CLAUDE.md`) — 초기 구성 대비 무엇이 언제 왜 바뀌었는지 파악
213. `_workspace/`가 있으면 최근 실행의 중간 산출물을 훑어 실제 실행 흔적을 확인한다:
22   - 오케스트레이터가 정의한 경로에 산출물이 실제로 있는가 (없으면 워크플로우가 우회되었거나 죽은 코드)
23   - 산출물 품질이 스킬이 명시한 형식/기준을 따르는가
244. 사용자에게 피드백을 요청한다 (이미 피드백을 제공했다면 생략):
25   - "결과에서 개선할 부분이 있나요?"
26   - "에이전트 구성이나 워크플로우에 바꾸고 싶은 점이 있나요?"
27   - 피드백이 없으면 강요하지 않는다. 단, 아래 관찰 신호가 있으면 선제적으로 개선을 제안한다
28 
29**관찰 기반 진화 신호 (피드백이 없어도 제안):**
30- 같은 유형의 수정 요청이 2회 이상 반복된 흔적
31- 에이전트가 반복적으로 실패/재시도한 패턴
32- 사용자가 오케스트레이터를 우회해 수동으로 작업한 흔적 (오케스트레이터 트리거 실패 의심 → description 확장 후보)
33- 오케스트레이터에 v1 유물(TeamCreate/TeamDelete/실험 플래그)이 남아 있음 → harness 스킬의 마이그레이션 절차 안내
34 
35### Phase 2: 피드백 유형 분류 및 수정 대상 매핑
36 
37| 피드백 유형 | 수정 대상 | 예시 |
38|-----------|----------|------|
39| 결과물 품질 | 해당 에이전트의 스킬 | "분석이 너무 피상적" → 스킬에 깊이 기준 추가 |
40| 에이전트 역할 | 에이전트 정의 `.md` | "보안 검토도 필요" → harness 스킬로 에이전트 추가 안내 |
41…