03-실전

03 — 실전: 슬롭 진단과 청소

5분 진단 프로토콜

PR/문서/커밋이 슬롭인지 5분 안에 판정하는 절차.

1. 출처 검사 — 사실 주장이 있는가? 출처 링크가 있는가? 없으면 1점.
2. 이름–행위 검사 — 가장 큰 함수 1개를 골라 한 줄씩 읽는다. 이름과 행위가 일치하는가? 아니면 1점.
3. 불릿 비율 — 본문 중 불릿이 60%를 넘는가? 1점.
4. 테스트 의미 검사 — 테스트 1개를 골라 그 테스트가 실패할 수 있는 시나리오를 말로 설명할 수 있는가? 못하면 1점.
5. 자기 칭찬 검사 — 커밋 메시지/PR 설명에 comprehensive, robust, seamless, 포괄적, 강건한 등의 형용사가 있는가? 있으면 1점.

3점 이상 = 슬롭으로 판정 → 머지 거부 → ai-slop-cleaner 패스로 회부.

ai-slop-cleaner 패스

본 위키 빌드 파이프라인의 4번째 패스다. CLAUDE.md §10에 명시된 대로 writer → reviewer(document-specialist) → critic → ai-slop-cleaner → verifier 순서.

이 패스의 작업은 다음으로 한정된다.

• 자기 칭찬 형용사 제거
• 불릿 → 산문 변환(필요한 부분에 한해)
• 출처 없는 단정문에 [출처 필요] 마크 또는 삭제
• 이름–행위 불일치 함수에 // TODO: verify 코멘트 삽입(코드는 손대지 않음)

ai-slop-cleaner는 내용을 새로 쓰지 않는다. 청소만 한다. 새로 쓰는 것은 writer 패스의 일이다.

인간 게이트(Human Gate)

자동화된 슬롭 클리너로도 잡히지 않는 슬롭이 있다 — 의미적으로 그럴듯하지만 도메인적으로 틀린 진술. 이 경우 유일한 방어는 사람이다.

운영 규칙:

• 모든 published 챕터는 사람이 한 번 이상 통독한다. writer 패스 = LLM, verifier 패스 = LLM이지만, 최종 머지 승인은 사람.
• 사람 통독 없는 챕터는 status: draft 또는 status: writer-pass로 두고 published로 올리지 않는다. (CLAUDE.md §금지 10)

다음

• examples/ — 실제 슬롭 사례
• anti-patterns
• checklist