mrgnhnt96/impa-review

Impa review

자체 잠금 세션에서 기술 문서 검토를 시작하고 보고서를 반환합니다. 작성자 없이도 모든 문서에서 작동합니다. 발견 사항만 반환합니다. "검토 후 수정"을 요청해도 문서나 코드를 편집하지 않습니다.

method.md, checklist.md 또는 reference/ 내의 어떤 파일도 읽지 마세요. 검토자가 직접 로드하며, 이 세션에서 해당 파일들을 제외하는 것이 핵심입니다.

이 세션에서 이 문서를 작성했거나 변경했다면, round.md의 절차를 따르세요.

단계

1. 브리프를 "${TMPDIR:-/tmp}"/impa/<project>/direct-<n>/brief-1.md에 작성합니다. <n>은 마지막 폴더보다 1 큰 값입니다. 브리프는 사실만 담고 절대 당신의 의견을 포함하지 않습니다. 따라서 먼저 문서를 읽지 마세요.

   impa review 방법으로 기술 문서를 검토합니다. 어떤 파일도 편집하지 마세요.
   
   프로젝트: <절대 경로>
   문서: <사용자가 지정한 절대 경로, 또는 "직접 찾기">
   기타 출처: <사용자가 지정한 의존성 또는 형제 저장소의 절대 경로, 또는 "없음">
   문서 계획: <프로젝트에 .impa/plan.md가 있으면 해당 절대 경로, 또는 "없음">
   이번 라운드의 요청 (사용자 말로): "<프롬프트>"
   범위: <사용자가 지정한 범위, 또는 "전체 문서 세트">
   마지막 라운드에서 아직 열린 사항: 없음
   사람에게 전달: 없음
   
   방법의 보고서를 반환합니다. 범위 밖에서 우연히 발견한 문제가 있으면 언급하지만, 일부러 찾지 마세요.
   

2. 백그라운드에서 시작합니다. 기타 출처의 각 경로에 대해 --add-dir을 추가합니다.

   impa review --brief <brief> --add-dir <project>
   

   대규모 문서 세트에는 --timeout <분>이 필요할 수 있습니다. 기본값은 20분입니다.

3. 명령어가 1로 종료되면 검토가 완료되지 않은 것이며, review-1.md는 부분적입니다. review-1.json이 없거나 Error: spawn으로 시작하는 error가 있으면 시작할 수 없습니다. 명령어 출력을 읽고 fallback을 사용하세요. 그렇지 않으면 더 큰 --timeout으로 한 번 더 실행합니다. 그래도 실패하면 review-1.json의 error와 함께 검토가 완료되지 않았음을 사용자에게 알립니다.

4. 그 외의 경우 브리프 옆에 있는 review-1.md만 읽습니다. 작성된 그대로 반환하고, 명령어가 출력한 줄의 비용(cost)을 함께 전달한 후 중단합니다. 사용자가 요청하지 않는 한 발견 사항에 대해 조치하지 마세요. 수정은 이 단계 이후 별도 단계입니다. review-1.json에서 verdict가 비어 있으면 평결 행이 없는 것이므로 보고서를 신뢰할 수 없다고 말합니다.

impa가 PATH에 없거나 시작할 수 없으면 round.md의 섹션 3에 있는 fallback을 사용합니다. 그것도 시작할 수 없으면 검토가 실행되지 않았음을 사용자에게 알립니다. 이 세션에서 절대 검토하지 마세요.