PHASE_WORKFLOW.MD

# PHASE WORKFLOW RULES

PHASE WORKFLOW MODE 진입 시 반드시 아래 순서를 따른다.

1. PHASE_INDEX.md 읽기
2. 현재 진행중 또는 TODO 상태의 작업 확인
3. 해당 phase 파일 읽기
4. 작업 수행
5. PHASE_INDEX.md의 해당 phase에 [완료] 상태 갱신
6. 작업 완료 후 반드시 정지

---

# PHASE INDEX RULES

PHASE_INDEX.md는:

- 전체 작업 상태 관리
- 현재 진행 상태 기록
- 다음 작업 위치 관리

만 담당한다.

상태 기록은 오직 PHASE_INDEX.md만 사용한다.
다른 파일에 작업 상태를 기록하지 않는다.

---

# PHASE FILE RULES

phase 파일은:

- 작업 명세서
- 구현 목표
- 작업 범위
- 수정 금지
- 구현 규칙

만 포함한다.

phase 파일은 상태 기록 용도로 사용하지 않는다.

---

# STATUS RULES

사용 가능한 상태:

- [TODO]
- [진행중]
- [완료]

---

## 진행중 상태 규칙

[진행중] 상태는:

- 작업이 중간에 중단된 상태
- 세션이 종료된 상태
- 다음 AI가 이어서 작업해야 하는 상태

를 의미한다.

이 경우 반드시 작업 전,후 PHASE_INDEX.md에 아래 예처럼 기록한다.

PHASE 3. Claim Review 개선
FILE: ./26_05_19_기능개선/phase_03_002_metadata_display.md

1) candidate, approved, rejected, pending 상태 도입 [완료]

2) 신뢰도, 출처, 생성 방식, 검증 결과 표시 [진행중]

- 완료:
  - confidence badge UI
  - source label
  - createdBy 표시

- 남은 작업:
  - validation result UI 연결
  - metadata tooltip

- 수정 파일:
  - ClaimList.tsx
  - ClaimDetailPanel.tsx

- 다음 작업:
  - validation result rendering 연결

3) [object Object] 표시 문제 제거 [TODO]
4) 사람이 읽을 수 있는 label/name/value 우선 표시 [TODO]

---

# PHASE COMPLETION RULE

페이즈 작업지시가 있었지만 모든 phase/subphase가 [완료] 상태일 경우:

- 새로운 phase를 자동 생성하지 않는다.
- 자동으로 roadmap를 확장하지 않는다.
- 다음 작업을 자동 진행하지 않는다.

반드시 아래 문장만 출력한다.

"모든 페이즈 작업 완료"

---

# USER CONTROL RULE

로드맵 진행 권한은 사용자에게 있다.

AI는:

- 다음 roadmap 작업을 자동 선택하지 않는다.
- 자동으로 다음 subphase를 진행하지 않는다.
- 현재 요청 범위를 넘어서는 작업을 하지 않는다.

사용자가 명시적으로 진행을 요청한 작업만 수행한다.

---