docs

docs/PHASE_PLANNING.md

@@ -0,0 +1,39 @@
+PHASE_PLANNING.md
+
+요청된 작업을 다음 순서로 진행한다.
+
+0. 이전 PHASE_INDEX.md 다른이름 으로 변경. (예 : 26_05_19_PHASE_INDEX.md)
+1. 요청된 작업 폴더 생성 (예 : 26_05_19_기능개선 )
+2. 해당 작업을 분석후 Phase 계획
+3. Phase별로 상세 작업 계획을 세운후 PHASE_INDEX.md 새로 생성후 작성. 작성 방법은 아래 # PHASE INDEX EXAMPLE 참조
+4. Phase별 상세작업 계획은 1에 의해 생성된 폴더아래  파일을 만들어 저장( 예 : phase_01_001_pipeline.md)
+5. 생성된 파일은 PHASE_INDEX.md의 해당 PHASE의 FILE: 에 기록
+
+
+# PHASE INDEX EXAMPLE
+
+---
+
+PHASE 1. Build Pipeline 화면
+FILE: ./26_05_19_기능개선/phase_01_001_pipeline.md
+
+1) Source Crawl, Page Clean [TODO]
+2) 각 단계별 상태, 진행률, 오류 수, 재실행 버튼 제공 [TODO]
+
+---
+
+PHASE 2. Page Analysis Viewer
+FILE: ./26_05_19_기능개선/phase_02_001_analysis_viewer.md
+
+1) 원문 HTML, 정제 텍스트, 추출 엔티티, 생성 클레임, 근거 문장을 한 화면에서 확인 [TODO]
+2) 클레임별 evidenceText와 sourceUrl 표시 [TODO]
+
+---
+
+PHASE 3. Claim Review 개선
+FILE: ./26_05_19_기능개선/phase_03_002_metadata_display.md
+
+1) candidate, approved, rejected, pending 상태 도입 [TODO]
+2) 신뢰도, 출처, 생성 방식, 검증 결과 표시[TODO]
+3) [object Object] 표시 문제 제거 [TODO]
+4) 사람이 읽을 수 있는 label/name/value 우선 표시 [TODO]

docs/PHASE_WORKFLOW.md

@@ -0,0 +1,123 @@
+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를 진행하지 않는다.
+- 현재 요청 범위를 넘어서는 작업을 하지 않는다.
+
+사용자가 명시적으로 진행을 요청한 작업만 수행한다.
+
+---