AI/docs/PHASE_WORKFLOW.md

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를 진행하지 않는다.
• 현재 요청 범위를 넘어서는 작업을 하지 않는다.

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

---