한국어 문서 검토 서비스 KWQA

고객에게 보내기 전의 메일 문안과 산출물을, 여러 프로젝트·AI 에이전트가 같은 기준으로 검사하게 만든 맥 로컬 검토 서비스(KWQA 0.1.1)다. textlint·Kiwi 가 문체·장문·용어 후보를 찾고, 교정본의 숫자·ID·URL·인용·코드가 원본과 같은지 비교한다. 문서를 고치거나 메일을 보내거나 외부 LLM 을 부르지 않는다.

여러 프로젝트·에이전트가 같은 검토 기능을 부르고, 지금 맥에서 구동하며, 연결된 다른 기기에서도 접근하되 메일 발송 기능은 두지 않는다는 요구를 냈다. 초기 설계의 「프로젝트 안 CLI 설치」를 독립 로컬 서비스 + CLI 클라이언트로 바꾸도록 요구했고, 「PRD 2회 검토 → 실행계획 2회 검토 → M1~M3」 검증 순서를 지정했으며, 교정 정책 개선안을 냈다. 구현은 Codex, PRD·계획·코드 검토는 Claude 가 맡았다.

• 정적 PASS 가 의미 검증으로 읽히지 않게 했다. 응답에 semantic_verified:false·delivery_authorized:false 와 다음 단계(독립 의미 검토)를 고정하고, 변경이 있으면 보호 값이 같아도 최소 REVIEW 로 둔다.
• 공용 서비스로 바꾸되 노출은 좁혔다. 여러 프로젝트가 같은 기준을 쓰도록 독립 서비스로 만들고, 앱은 loopback 에만 묶어 원격은 Tailscale Serve 의 HTTPS 경로 하나만 두기로 했다(공개 터널 미사용).
• 자동 LLM 호출·자동 재교정을 두지 않았다. 교정 권고 상한(2회)은 호출하는 에이전트가 관리하고, 교정 기준은 「최소 개입·맥락 보존」으로 실무 어조와 승인 용어를 지킨다.

• 기본 기능 고유 시험 97개 통과(2026-10-14, 로컬 맥), npm audit 0·pip check 정상.
• 프로젝트 맥락 기능 전체 회귀 219 통과, 운영 HTTP 10KiB × 20회 p95 1.416초(목표 10초 미만, 2026-10-15 실측).
• 방법론 compose 가 선택 항목으로 호출하고, 인증 심사 포털 기획의 문장 검사에 규칙 rev 1 → rev 13 으로 적용됐다.

• 실제 고객 문서 50건으로 자연스러움·의미·시간 개선을 재는 M4 는 승인 자료·사용자 평가가 없어 미측정이다. 다른 기기 원격 접속은 Tailscale 이 꺼져 있어 미검증이고, Windows·Linux 재시험은 하지 않았다.
• 독립 검토 판정은 Claude 의 원자료 표기이며, 방법론의 Codex 게이트를 거친 것이 아니다.

textlint · Kiwi(한국어 형태소 분석) · 교정본 보호 값 비교 · launchd 로컬 서비스 + CLI 클라이언트 · loopback 바인딩 + Tailscale Serve 경로(미검증) · 프로젝트별 맥락·문체 규칙