Full Review — 전체 문서 점검 워크플로우
"한 문서를 세 개의 눈으로 본다."
목적
기술 문서 하나를 세 명의 전문가가 각자의 관점에서 동시에 점검하고, 정원지기(tamer)가 종합 결과를 한 장의 리포트로 묶는다.
적용 대상
- Markdown 문서 (.md)
- 사용자가 명시한 파일 또는 디렉토리
- 미지정 시 — 사용자에게 대상 파일을 묻는다
참여 에이전트
| 순서 | 에이전트 | 보는 것 |
|---|---|---|
| 1 | [[doc-reviewer]] | 명확성, 구조, 독자 친화성 |
| 2 | [[style-enforcer]] | 문체 일관성, 표기 규칙, 톤 |
| 3 | [[terminology-keeper]] | 용어 일관성, 정의, 약어 |
실행 순서
대상 문서
│
▼
┌────────────────────────────────┐
│ Step 1: 사전 준비 │
│ - 대상 파일 확정 │
│ - 문서 유형 추정 (가이드/레퍼런스)│
└────────────┬───────────────────┘
│
▼
┌────────────────────────────────┐
│ Step 2: 3축 병렬 검토 │
│ ├── doc-reviewer 보고서 │
│ ├── style-enforcer 보고서 │
│ └── terminology-keeper 보고서 │
└────────────┬───────────────────┘
│
▼
┌────────────────────────────────┐
│ Step 3: 종합 리포트 │
│ - 우선순위가 높은 이슈 정렬 │
│ - 충돌 의견 조정 │
│ - 한 장 요약 │
└────────────┬───────────────────┘
│
▼
harness/logs/full-review/
{timestamp}-{title}.md
Step별 절차
Step 1: 사전 준비
- 사용자가 대상 문서를 지정했는지 확인
- 미지정 시 후보 제시 후 선택받음
- 문서의 H1, 첫 단락을 읽고 문서 유형 추정:
- 가이드/튜토리얼 / 레퍼런스 / 릴리스 노트 / README
Step 2: 3축 병렬 검토
세 에이전트를 가능한 한 동시 실행한다. 각 에이전트는 자신의 SKILL.md 절차를 따른다.
효율을 위해 단일 컨텍스트 안에서 세 에이전트를 순차로 호출해도 무방하나, Task 도구로 병렬 실행이 가능하면 그것을 우선한다.
Step 3: 종합 리포트
각 에이전트의 보고서를 통합한다.
통합 리포트 형식
# Full Review — {문서명}
## 한 줄 진단
{종합 한 줄}
## 우선순위 이슈 (Top 5)
1. [{영역}] {이슈} — 위치 {L}
2. ...
## 영역별 평가
### 명확성/구조 (doc-reviewer)
- 명확성: {A/B/C/D}
- 구조: {A/B/C/D}
- 독자 친화성: {1~5}
### 문체/표기 (style-enforcer)
- 문체 일관성: {A/B/C/D}
- 표기 정확도: {A/B/C/D}
- 톤 매칭: {1~5}
### 용어 (terminology-keeper)
- 용어 일관성: {A/B/C/D}
- 정의 명확성: {A/B/C/D}
- 약어 정의율: {1~5}
## 권장 다음 단계
- {액션 1}
- {액션 2}
로그 기록
- 엔진 실행 로그:
harness/logs/full-review/{yyyy-MM-dd-HH-mm-title}.md - 각 에이전트는 자체 로그를 별도로 남기지 않고, 엔진 통합 로그에 포함된다 (중복 방지)
종료 조건
다음 중 하나가 충족되면 종료:
- 모든 영역이 B 이상 + 모든 점수 ≥ 3
- 사용자가 "여기까지" 선언
한계
- 외부 링크 유효성은 검사하지 않는다
- 코드 블록의 실행 가능성은 검증하지 않는다 (코드 검수는 별도 에이전트 영역)