완료라고 쓰기 전에 검사하기: 연재 상태 JSON에 9개 테스트를 붙였습니다

소개

CTO 스터디의 하네스 실험 방향을 참고해, 글쓰기 규칙을 더 늘리는 대신 프로그램으로 확인할 수 있는 상태 조건을 검사해봤습니다. 대상은 공개 연재의 회차 기록입니다. 글이 좋아 보인다는 이유로 실행·게시까지 완료됐다고 기록하는 것을 막고 싶었습니다.

진행 방법

Codex로 Python 표준 라이브러리만 사용하는 pipeline 파이썬 파일를 만들었습니다. 사람이 읽는 목적·예외는 AGENTS 문서에, 회차 상태는 episodes JSON 파일에, 구조 판정은 코드에 두었습니다.

회차 ID·제목·독자 질문·다음 행동을 확인하고 중복 ID와 알 수 없는 상태를 오류로 표시합니다. 결과 기사라면 근거 참조가 있어야 하고, 게시 상태라면 HTTPS URL이 있어야 합니다.

예고 원고 3편을 합성 상태 데이터로 넣어 다음 행동 3개를 출력했습니다. 이후 중복 ID, 다음 행동 누락, 근거 없는 결과 기사, URL 없는 게시 상태, 잘못된 URL, 알 수 없는 상태 등을 포함해 9개 unittest를 실행했습니다.

이번 실습의 조건을 다시 적용하기 위한 재현용 요청문입니다.

연재 회차 JSON의 상태 검사기를 만들어줘. 입력 원본을 바꾸지 말고 다음 행동을 출력해줘. 중복 ID, 누락, 근거 없는 결과 기사, URL 없는 게시완료를 오류로 잡아줘. 검사 통과와 근거의 진실성·콘텐츠 품질을 구분하고 정상/잘못된 입력을 테스트해줘.

결과와 배운 점

실행 결과는 정상 예시 3개에서 valid=true, 다음 행동 3개 출력이었고 9개 테스트가 모두 통과했습니다. 테스트용 잘못된 입력은 검사를 확인하려고 만든 합성 사례이며 실제 운영 사고 기록은 아닙니다.

한계도 테스트로 드러냈습니다. 근거 참조에 “unverified-reference”라는 문자열만 넣어도 형식 검사는 통과합니다. 근거가 존재한다고 기록된 것과 그 근거가 사실인지 확인한 것은 다릅니다. 이를 명시한 테스트도 포함했습니다.

이번 결과는 결정적인 상태 검사 실험입니다. Claude Code hook 설치, 독립 리뷰어, 글 품질 검증은 수행하지 않았습니다. 다음에는 참조 파일이 실제로 존재하는지 확인하는 단계와 내용 검토를 분리하려 합니다.

도움 받은 글

해당 스터디 공식 소개와 커리큘럼

공통 프로젝트의 출발점: 연재 원고 3편 제작·검토 기록

evidence.png
158.87KB

1
지피터스 뉴스레터

이번 주 AI, 딱 쓸 것만

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