Codex로 기술 블로그를 쓸 때 AI와 사람이 나눠야 할 일

이 블로그는 Codex의 도움을 받는다.

숨길 이유는 없다.
대신 AI가 만든 문장을 그대로 기술 경험처럼 발행하지는 않는다.

한 문장부터

AI에는 구조와 반복 작업을 맡기고, 로그와 경험과 최종 판단은 사람이 확인한다.

AI에 맡기기 좋은 일

• 저장소에서 관련 글 찾기
• frontmatter 형식 맞추기
• 긴 메모를 짧은 목차로 정리하기
• 중복 문장과 내부 링크 확인하기
• 코드 예제의 들여쓰기와 설명 정리하기
• 제목과 description 후보 만들기

이런 일은 규칙이 비교적 분명하다.

사람이 직접 확인할 일

• 실제로 어떤 증상이 있었는가
• 어떤 로그와 패킷을 봤는가
• 어떤 설정을 바꿨는가
• 바꾼 뒤 문제가 재현되지 않았는가
• 제품과 프로젝트 정보를 공개해도 되는가

AI는 이 부분을 그럴듯하게 채울 수 있다.
그래서 더 위험하다.

확인할 수 없는 내용은 다음 표시로 남긴다.

[HUMAN-LOG]
[HUMAN-EXPERIENCE]
[HUMAN-TIP]
[HUMAN-IMAGE]

이 표시는 작성 중 확인하거나 채울 지점을 뜻한다.
게시 전에는 내용을 직접 보강하거나 표시를 제거한다. 확인되지 않은 경험이나 결과가 사실처럼 보이면 설명을 보완하거나 해당 내용을 빼고 공개한다.

내가 사용하는 순서

1. 해결하려는 질문을 한 문장으로 적는다.
2. 관련 코드와 기존 글을 Codex가 찾게 한다.
3. Quick Note인지 Deep Dive인지 먼저 정한다.
4. AI가 초안과 파일 변경을 만든다.
5. 로그, 숫자, 명령, 링크를 사람이 확인한다.
6. 불필요한 배경 설명을 지운다.
7. 핵심 판단과 공개 범위를 확인하고, 수정한 내용이 있으면 게시글과 updated_date에 반영한다.

기술 글은 길다고 더 정확해지지 않는다.
AI 초안은 특히 같은 결론을 여러 방식으로 반복하는 경향이 있다.

검토 여부를 별도의 게시 상태로 만들지는 않는다. content/posts/의 글은 공개되므로 발행 전에 사실, 링크, 로그와 공개 범위를 확인한다.

게시물별 상태 표시는 사용하지 않는다

AI 참여나 사람 검토 여부를 게시물 frontmatter 또는 상단 배지로 표시하지 않는다. AI는 초안과 편집을 보조할 수 있지만, 기술 판단과 실제 경험은 작성자가 확인하고 책임진다. 확인할 수 없는 과거 글의 AI 참여 여부를 소급해 단정하지도 않는다.

한 줄 요약

Codex는 기술 글을 빠르게 정리해 주지만, 현장 경험과 기술 결론을 확인하고 책임지는 일은 DevBJ가 맡는다.