v1.8.3 — 지식 신설: 독자 중심 목소리 + 입문 독자 렌즈 (doc-reviewer 4번째 축)
- 일자: 2026-09-07
- 종류: Patch (knowledge 1건 신설 — 미해결 링크 해소, doc-reviewer 절차·평가축 보강, clarity 원칙 포인터)
배경
20편 2차 검수에서 사용자가 새 관점을 요구했다 — "하네스와 루프 엔지니어링은 IT 전문가도 이해하기 어려운 파트. AI에 관심 있는 IT 입문자(AI를 이미 잘 아는 사람이 아닌) 관점에서 전개가 매끄럽고 이해가 쉬운가." 정원에는 전제 친절도·독자 친화성은 있었지만 이 렌즈는 없었고, [[writing-modes]]가 참조하던 reader-centered-voice 지식도 실제로는 없는 파일이었다(2026-07 이후 미해결 링크).
변경 사항
| 대상 | 내용 |
|---|---|
harness/knowledge/reader-centered-voice.md (신규) | §1 독자 호명 규칙(정식화) · §2 입문 독자 렌즈 — 여섯 점검(은유 자족성 / 핵심 개념 조기 정의 / 미정의 전문어 밀도 / 시리즈 회수 밀도 / 건너뛰기 안내 / "쉽게 말해") · 척도 입문자 통과율 1~5 · 처방 패턴 5(낱말 박스·회수 압축·쉽게 말해·도구 세부 격리·표 앞 한 줄) · 검수 절차 |
harness/agents/doc-reviewer.md | 실행 절차에 5단계(입문 독자 렌즈) 삽입, 보고 형식에 블록 추가, 평가 기준에 4번째 축 "입문자 통과율", 관련 지식 링크 |
harness/knowledge/doc-clarity-principles.md | 독자 친화성 아래 렌즈 포인터 — 기존 3축(숙련 독자)과의 경계 명시 |
harness.config.json | 1.8.2 → 1.8.3 |
첫 적용
20편 게시본 2차 검수 §입문 독자 렌즈 — 통과율 2/5, 개선 후보 E1~E7 (harness/logs/full-review/2026-09-07-10-30-200-second-review.md)
유의
- 렌즈는 명확성/구조 축을 대체하지 않는다 — "숙련 독자가 한 번에 닿는가"와 "입문 독자가 이탈하지 않는가"는 다른 질문이다
- 처방은 삭제가 아니라 다리(정의·요약·안내)다 — 시리즈 은유와 본문의 깊이는 유지한다