위키독스 분석 보드 — 2026-06-21

개발자의 글쓰기는 문학이 아니라 전달이며, 팩트·구체성·독자 중심·짧은 문장으로 오해를 줄이는 실용 도구다 — 저자는 11년차 게임 개발자 출신으로 실무 글쓰기(버그리포트·코드리뷰·README·기술블로그)를 114챕터에 걸쳐 템플릿화

이 책 형님한테 진짜 가치 있다. adopt 후보 2개(글쓰기 품질 평가 체계·퇴고 프로토콜), improve 3개(사실/의견 분리·추상→구체 변환·독자 수준 보정), skip 3개(팀 개발 템플릿·문장 리듬·협업 문서) — 핵심 가치는 '블로그 자동화 파이프라인에 구조적 글쓰기 품질 평가와 편집 단계를 정착시킬 수 있는 검증된 프레임워크'다. 단, 책의 60%는 팀 개발자용이라 형님 도메인과 무관하고, 남은 40%도 이미 Pre-Write Protocol·humanizer가 부분 커버 중이라 적용 범위는 좁지만 깊다.

1. ADOPT 글쓰기 품질 평가 체계 (10-point checklist)
   ~/.hermes/scripts/content_quality_check.py 신규 생성 — 10-point 평가 기준을 구현하고, blog-writer-naver PostToolUse hook에 연동하여 블로그 초안 자동 평가 (점수 + 개선 포인트). MEMORY.md의 sycophancy 피드백을 반영해 '좋아 보이는 글 감별' 로직 포함
2. IMPROVE 사실/의견/추측 구분 체계
   blog-writer-naver/SKILL.md의 Pre-Write Protocol Phase 2에 '사실/의견/추측 태깅' 단계 추가. 문장별 태그를 마크다운 주석으로 삽입(<!--fact-->/<!--opinion-->/<!--speculation-->)하는 규칙. humanizer에 '추측성 표현 감지+경고문 삽입' 로직 보강
3. IMPROVE 추상표현→구체정보 변환 (abstraction buster)
   humanizer/SKILL.md에 'abstraction_buster' 모듈 추가 — '좋다·나쁘다·빠르다·느리다·많다·적다·개선·향상·최적화' 키워드 감지 시 구체화 요구 플래그. ~/.hermes/scripts/abstraction_detector.py 생성하여 5W1H 누락 체크. blog-writer-naver PostToolUse hook에 연동
4. IMPROVE 독자 지식수준 기반 설명량 조절 (reader calibration)
   blog-writer-naver/SKILL.md에 'reader_level' 파라미터 추가 (beginner/intermediate/expert). obsidian-keywords의 keyword dictionary(855개)를 활용해 독자 수준 대비 난이도 높은 용어 자동 식별 → 용어 설명 자동 삽입. Pre-Write Protocol Phase 1에 '독자 페르소나 정의 및 지식 갭 체크' 추가
5. ADOPT 퇴고 프로토콜 — 글은 삭제하는 일이다
   ~/.hermes/scripts/post_write_editor.py 신규 생성 — Chapter 73-75의 삭제 기준을 구현: (1) 목적 불일치 문장 탐지 (2) 반복 문장 식별 (3) 핵심 메시지 없이 분량만 채우는 문장 플래그. blog-writer-naver 파이프라인의 Stage 6-7 사이에 'Editing Stage' 삽입. SKILL.md에 editing_prompt 템플릿 추가