diff --git a/CHANGELOG.md b/CHANGELOG.md index 1be8060..07358c4 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,7 +4,12 @@ ## [Unreleased] +### Fixed +- Phase 5-5 / 체크리스트: "Phase 1" → "Phase 0" 컨텍스트 확인 (orchestrator-template과 일치) +- orchestrator-template: Incremental QA 공통 규칙 추가 + ### Added +- Phase 6-7 사용자 핸드오프 (트리거 예문·skill name·산출물 경로) - 신규 에이전트/스킬 생성 전 중복 검토 단계 (Phase 3-0, Phase 4-0) - `references/agent-design-patterns.md` "에이전트 재사용 설계" 섹션 - `references/skill-writing-guide.md` §9 "스킬 재사용 설계" diff --git a/skills/harness/SKILL.md b/skills/harness/SKILL.md index 83a09c3..c900665 100644 --- a/skills/harness/SKILL.md +++ b/skills/harness/SKILL.md @@ -286,8 +286,8 @@ Phase마다 다른 모드를 섞어 구성한다. 자주 쓰이는 조합: - "{도메인}의 {부분작업}만 다시" - "이전 결과 기반으로", "결과 개선" -**2. 오케스트레이터 Phase 1에 컨텍스트 확인 단계 추가:** -워크플로우 시작 시 기존 산출물 존재 여부를 확인하여 실행 모드를 결정한다: +**2. 오케스트레이터 Phase 0에 컨텍스트 확인 단계 추가:** +워크플로우 **시작부(Phase 0)**에서 기존 산출물 존재 여부를 확인하여 실행 모드를 결정한다 (Phase 1 준비보다 먼저 실행): - `_workspace/` 존재 + 사용자가 부분 수정 요청 → **부분 재실행** (해당 에이전트만 재호출) - `_workspace/` 존재 + 사용자가 새 입력 제공 → **새 실행** (기존 _workspace를 `_workspace_prev/`로 이동) - `_workspace/` 미존재 → **초기 실행** @@ -358,6 +358,15 @@ Phase마다 다른 모드를 섞어 구성한다. 자주 쓰이는 조합: - 오케스트레이터 스킬에 `## 테스트 시나리오` 섹션 추가 - 정상 흐름 1개 + 에러 흐름 1개 이상 기술 +#### 6-7. 사용자 핸드오프 + +하네스 구축·검증이 끝나면 사용자에게 **다음 세션에서 어떻게 깨울지** 안내한다 (CLAUDE.md 포인터 등록과 별개): + +1. **트리거 예문 2~3개** — 도메인별 자연어 (초기 실행 + 후속 수정) +2. **오케스트레이터 skill name** — `.claude/skills/{orchestrator}/SKILL.md` 경로 +3. **산출물 위치** — `_workspace/` 및 최종 출력 경로 +4. **재실행 키워드** — "다시 실행", "부분 수정", "업데이트" 등 description에 이미 포함된 표현을 사용자에게 알려줌 + ### Phase 7: 하네스 진화 하네스는 한 번 만들고 끝나는 정적 산출물이 아니다. 사용자 피드백에 따라 계속 진화하는 시스템이다. @@ -445,7 +454,8 @@ Phase마다 다른 모드를 섞어 구성한다. 자주 쓰이는 조합: - [ ] 트리거 검증 (should-trigger + should-NOT-trigger) 완료 - [ ] **CLAUDE.md에 하네스 포인터 등록** (트리거 규칙 + 변경 이력) - [ ] **CLAUDE.md 변경 이력에 에이전트/스킬 추가/삭제/수정 기록** -- [ ] **오케스트레이터 Phase 1에 컨텍스트 확인 단계** (초기/후속/부분 재실행 판별) +- [ ] **오케스트레이터 Phase 0에 컨텍스트 확인 단계** (초기/후속/부분 재실행 판별) +- [ ] **Phase 6-7 사용자 핸드오프** (트리거 예문·skill name·산출물 경로 안내) ## 참고 diff --git a/skills/harness/references/orchestrator-template.md b/skills/harness/references/orchestrator-template.md index df5023b..8b1d612 100644 --- a/skills/harness/references/orchestrator-template.md +++ b/skills/harness/references/orchestrator-template.md @@ -264,6 +264,22 @@ description: "{도메인} 오케스트레이터 (하이브리드). {키워드}. --- +## QA 에이전트 포함 시 공통 규칙 (Incremental QA) + +`SKILL.md` Phase 3: QA는 **전체 완성 후 1회가 아니라 각 모듈 완성 직후** 점진적으로 실행한다. + +**템플릿 A/B 적용:** + +| 템플릿 | 적용 방법 | +|--------|----------| +| **A (팀)** | Phase 3 각 모듈 Task 완료 직후 QA 팀원 TaskCreate — "Phase 4 통합 전" 폭포수 QA 금지 | +| **B (서브)** | 각 Agent 반환 직후 QA 서브 에이전트 1회 — 통합 Phase 전에 모듈별 검증 | +| **C (하이브리드)** | 생성 Phase=서브, 검증 Phase=팀 — Phase 4 단독 "전체 완성 후 통합 검증" 문구 사용 금지 | + +오케스트레이터 Phase 4 제목을 "통합"으로 두더라도, QA가 포함되면 **모듈별 incremental QA** 단계를 Phase 3~4 사이에 명시한다. + +--- + ## 작성 원칙 1. **실행 모드를 먼저 명시** — 오케스트레이터 상단에 "에이전트 팀" / "서브 에이전트" / "하이브리드" 중 하나 명시. 하이브리드면 Phase별 모드 표 필수