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. humanReviewed: true로 바꾼 뒤 발행한다.

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

글에 표시한다

AI가 실질적으로 참여한 글은 frontmatter에 표시한다.

aiAssisted: true
humanReviewed: true

글 상단에도 AI가 초안 구성과 문장 정리를 도왔다는 안내가 나타난다.
자세한 기준은 편집 원칙과 AI 사용에서 공개한다.

한 줄 요약

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