클로드 코드 검사기와 write-post로 내 지난 글을 채점했습니다

내 지난 글부터 넣어봤습니다

2026-10-14, 3주차 스터디 날입니다. 지난주에 저는 동료 글 182편을 읽고 "블로그 자동화의 빈 곳은 뒷단(검증·발행·성과 되먹임)"이라는 글을 올렸습니다. 그런데 정작 제 글은 검증하지 않았더라고요. 그래서 이번 주에는 제 지난 글을 검사기 두 개에 넣어 봤습니다.

  • 검사기 1: 이번 주에 Claude Code로 만든 사례글 검사기 gate.mjs (센서 8개)

  • 검사기 2: 지피터스 공식 사례글 스킬 write-post의 발행 전 검사

  • 지난주 원고 그대로: 내 검사기 FAIL 1, WARN 3 / write-post 막힘 8

  • 고친 뒤: 내 검사기 FAIL 0, WARN 0 / write-post 막힘 3

182편을 읽고 "남의 글"의 패턴은 잘 찾았는데, 제 글에는 그 패턴이 그대로 남아 있었습니다.

둘 다 잡은 것: 63자 제목과 틀 이름 소제목

  • 제목이 63자였습니다. write-post 기준은 25자에서 35자, 제 검사기는 50자 넘으면 반려합니다.

  • 소제목 6개가 "소개", "진행 방법"처럼 양식 이름 그대로였습니다. 베스트 사례를 분석한 자료에서 "틀 빈칸을 추상어로 채운 글은 지친다"고 경고한 바로 그 모양이었습니다.

하나만 잡은 것

write-post만 잡은 것

  • 긴 줄표 1개, 숫자 범위에 쓴 물결표, 굵은 글씨 경계의 문장부호

  • 이건 지피터스 편집기에 붙여넣을 때 깨지는 것들입니다. 제 검사기에는 이 기준이 없었습니다.

제 검사기만 잡은 것

  • 전부를 단정하는 표현 3줄. 182편을 다 정독한 것도 아닌데 "끝까지 만든 사람이 없다"는 식으로 썼습니다.

  • "확인 필요" 표시 잔존 검사. 이건 지난주 글에 진우랩 님이 남긴 댓글에서 온 센서입니다. "확인 안 된 사실은 확인 필요 표시를 박아 두고 사람이 채우게 한다"는 방법을 그대로 검사 규칙으로 만들었습니다. 제가 찾아 본 범위에서는 write-post에 이 검사가 없었습니다.

8개 기준을 코드로 옮긴 방법

Claude Code에서 구현은 codex에게 맡기고, 저는 테스트와 실제 원고로 확인했습니다. 보낸 요청의 핵심은 이랬습니다.

센서 8개. 각각 PASS / WARN / FAIL / SKIP과 근거 줄 번호를 출력한다.
FAIL이 하나라도 있으면 종료 코드 2.
맨 마지막 줄: 형식 검사 결과입니다. 사실관계가 맞다는 뜻은 아닙니다.

테스트 8개는 한 번에 통과했습니다. 그런데 제 지난 원고에 돌려 보니 날짜 검사가 작성 메모 줄의 날짜를 보고 통과시키고 있었습니다. 제목과 메모 사이의 빈 줄 하나 때문에 메모를 본문으로 읽은 거였습니다. 테스트는 통과했는데 실제 원고에서 버그가 나온 셈이라, 고친 뒤 다시 확인했습니다.

write-post를 뜯어보고 배운 것

공식 스킬이라 설계가 궁금해서 설치본을 읽어 봤습니다. 가져온 원칙은 셋입니다.

  • 사람에게 묻는 횟수를 숫자로 정해 둔다. 첫 글 다섯 번, 두 번째부터 세 번.

  • 검사 통과와 사실 통과를 구분한다. "종료 코드 0은 형식 검사를 지났다는 뜻이지 사실이 맞다는 뜻이 아니다." 제 검사기 마지막 줄도 여기서 가져왔습니다.

  • 자기가 쓴 글은 학습 재료에서 뺀다. 성과 되먹임을 만들 때 꼭 지켜야 할 원칙이라 메모해 뒀습니다.

숫자는 아직 검사하지 못했습니다

  • 숫자 센서는 기준 파일(facts.json)이 있어야 돕니다. 지난 원고에는 기준 파일이 없어서 SKIP이었습니다.

  • 두 검사기 모두 "그 숫자가 사실인지"는 보지 못합니다. 형식만 봅니다.

  • 고친 뒤에도 write-post 막힘 3개가 남았습니다. 물결표와 굵은 글씨 경계는 원고를 다시 다듬어야 하고, 1개("알려주세요."를 찌꺼기로 판정)는 오탐으로 봤습니다.

  • 검사기가 종료 코드 2를 내는 것까지는 확인했지만, 아직 Claude Code 훅에 연결해 발행을 실제로 막게 하지는 않았습니다.

다음 주에 할 일

  • 검사기를 훅에 연결해서, 반려된 원고는 발행 단계로 못 넘어가게 하기

  • 숫자는 기준 파일 한 곳에서만 가져오게 하고, 본문 숫자와 대조하기

  • 이 검사기를 블로그 글에도 써 보기. 제 MVP인 블로그 하네스의 첫 부품입니다.

혹시 write-post나 다른 검사로 초안을 돌려 보신 분이 있다면, 어떤 경고가 실제로 쓸모 있었는지 댓글로 알려 주시면 다음 주 센서에 반영해 보겠습니다.

참고한 글

2
1개의 답글
지피터스 뉴스레터

이번 주 AI, 딱 쓸 것만

매주 월요일 오후,
읽고 바로 써먹을 AI 소식만