document-reviewlisted

# Document Review 문서 세트를 시나리오로 추적해 갭·모호함·불일치를 찾아 수정한다. **특정 경로나 문서 종류에 의존하지 않는다.** 사용자가 명시하거나 현재 세션에서 확인 가능한 문서를 대상으로 삼는다. ## Step 1 — 평가 대상 문서 파악 트리거 시 아래 순서로 평가 대상을 결정한다. 1. **사용자가 경로를 명시한 경우** → 해당 경로의 모든 `.md` 파일을 읽는다. ```bash find <지정_경로> -name "*.md" | sort ``` 2. **현재 세션에서 이미 논의된 문서가 있는 경우** → 그 문서들을 평가 대상으로 삼는다. 3. **아무것도 없는 경우** → 사용자에게 경로를 요청한다. > "평가할 하네스 문서의 경로를 알려주세요. (예: ~/Documents/Dev-Vault/code-harness)" 모든 문서를 읽은 후 목록을 출력하고 Step 2로 진행한다. --- ## Step 2 — 시나리오 정의 사용자에게 아래 질문을 한다: > "어떤 상황을 시나리오로 검증할까요? > > 예시: > - 새 개발자가 프로젝트에 처음 합류해 하네스를 구축하는 상황 > - 기존 개발자가 버그 이슈를 받아 수정 후 PR을 생성하는 상황 > - QA 피드백을 받아 브랜치에 추가 커밋하는 상황 > - 세션을 종료하고 다음 세션을 시작하는 상황 > > 직접 설명해도 됩니다." 사용자 답변을 받으면 아래 세 항목을 정리해 확인한다: | 항목 | 내용 | |------|------| | **페르소나** | 누가 이 문서를 읽는가 (새 개발자 / 기존 개발자 / 에이전트 등) | | **트리거** | 어떤 요청·상황으로 시나리오가 시작되는가 | | **기대 결과** | 시나리오 끝에 무엇이 완료되어야 하는가 | 사용자가 확인하면 Step 3으로 진행한다. --- ## Step 3 — 시나리오 추적 정의된 시나리오로 문서를 Phase별로 추적하며 검증한다. 각 Phase마다 세 가지 기준으로 평가한다: | 기준 | 질문 | |------|------| | **명확성** | 에이전트가 다음 행동을 알 수 있는가? | | **완전성** | 필요한 정보·명령이 모두 있는가? | | **일관성** | 문서 간 교차 참조(Q번호, 경로, 링크)가 맞는가? | --- ## Step 4 — 이슈 분류 발견한 이슈를 아래 기준으로 분류한다. | 등급 | 기준 | 처리 | |------|------|------| | 🔴 차단 | 이 이슈가 있으면 시나리오 특정 Phase를 진행할 수 없음 | 즉시 수정 | | 🟡 혼동 | 진행은 되지만 에이전트가 잘못된 결정을 내릴 수 있음 | 즉시 수정 | | 🟢 개선 | 없어도 동작하지만 있으면 더 명확함 | 사용자 판단 후 수정 | **이슈 목록을 먼저 출력하고 사용자에게 확인**받은 뒤 Step 5로 진행한다. 이슈 출력 형식: ``` [평가 결과] 발견된 이슈: 🔴 N개 / 🟡 N개 / 🟢 N개 🔴 차단 1. [