Skip to content

fix: Phase 0 consistency, incremental QA, and user handoff #44

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mythkiven wants to merge 1 commit into
base: main
Choose a base branch
from
Open

fix: Phase 0 consistency, incremental QA, and user handoff #44

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 "스킬 재사용 설계"
Expand Down
16 changes: 13 additions & 3 deletions skills/harness/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -286,8 +286,8 @@ Phase마다 다른 모드를 섞어 구성한다. 자주 쓰이는 조합:
- "{도메인}의 {부분작업}만 다시"
- "이전 결과 기반으로", "결과 개선"

**2. 오케스트레이터 Phase 1에 컨텍스트 확인 단계 추가:**
워크플로우 시작 시 기존 산출물 존재 여부를 확인하여 실행 모드를 결정한다:
**2. 오케스트레이터 Phase 0에 컨텍스트 확인 단계 추가:**
워크플로우 **시작부(Phase 0)**에서 기존 산출물 존재 여부를 확인하여 실행 모드를 결정한다 (Phase 1 준비보다 먼저 실행):
- `_workspace/` 존재 + 사용자가 부분 수정 요청 → **부분 재실행** (해당 에이전트만 재호출)
- `_workspace/` 존재 + 사용자가 새 입력 제공 → **새 실행** (기존 _workspace를 `_workspace_prev/`로 이동)
- `_workspace/` 미존재 → **초기 실행**
Expand Down Expand Up @@ -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: 하네스 진화

하네스는 한 번 만들고 끝나는 정적 산출물이 아니다. 사용자 피드백에 따라 계속 진화하는 시스템이다.
Expand Down Expand Up @@ -445,7 +454,8 @@ Phase마다 다른 모드를 섞어 구성한다. 자주 쓰이는 조합:
- [ ] 트리거 검증 (should-trigger + should-NOT-trigger) 완료
- [ ] **CLAUDE.md에 하네스 포인터 등록** (트리거 규칙 + 변경 이력)
- [ ] **CLAUDE.md 변경 이력에 에이전트/스킬 추가/삭제/수정 기록**
- [ ] **오케스트레이터 Phase 1에 컨텍스트 확인 단계** (초기/후속/부분 재실행 판별)
- [ ] **오케스트레이터 Phase 0에 컨텍스트 확인 단계** (초기/후속/부분 재실행 판별)
- [ ] **Phase 6-7 사용자 핸드오프** (트리거 예문·skill name·산출물 경로 안내)

## 참고

Expand Down
16 changes: 16 additions & 0 deletions skills/harness/references/orchestrator-template.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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별 모드 표 필수
Expand Down