최근 며칠 동안 저는 AI와 함께 매일 Qiita에 기사를 작성하고 있습니다.
원고와 이미지가 완성되면, 공개 전에 검사 스크립트를 실행합니다.
검사 결과에는 매번 다음과 같은 WARNING이 표시되었습니다.
WARNING: CURRENT_CONTEXT의 충돌 복사본이 있습니다
WARNING: 공개 준비 재고는 1개입니다. 연속 발행 시작 기준은 7개입니다
반면, 공개 전 최종 검사는 다음과 같이 끝납니다.
이미지 URL도 표시되고, 기사 중복도 없으며, Qiita에의 공개도 성공했습니다.
그 때문에 저는 WARNING을 보면서 매일 발행을 계속했습니다.
하지만 같은 경고가 매일 나오자 점차 배경 글자처럼 보이게 되었습니다.
오늘 2026년 11월 20일은 이 WARNING을 기사의 소재로 삼았습니다. 경고를 없앤 성공담이 아닙니다. 왜 검사는 통과하는지, 실제로 무엇이 남아있는지, 지금 당장 막아야 할 문제와 미해결 문제를 어떻게 구분할지를 확인한 기록입니다.
먼저, 검사 스크립트 check_pipeline.py의 움직임을 확인했습니다.
스크립트는 검사 결과를 다음 두 가지로 나누고 있습니다.
마지막 종료 조건은 다음과 같은 생각에 기반합니다.
ERROR가 1건 이상 있음 → 종료 코드 1로 실패
WARNING만 존재 → 종료 코드 0으로 성공
즉, WARNING은 '문제가 없다'는 의미가 아닙니다.
'현재 처리를 즉시 중단해야 하는 조건에는 해당하지 않는다'는 의미입니다.
실제로 기사 공개를 멈추게 하는 ERROR에는 다음과 같은 것들이 있습니다.
- 금일 공개 후보가 복수임
- 직전 기사가
published가 아님
- 공개 파일이 존재하지 않음
- 첫 번째 제목과 관리표의 제목이 일치하지 않음
- 미완료 또는 확인 대기 표시 마커가 본문에 남아있음
- 태그가 5개를 초과함
- 이미지가 상대 경로로 되어 있음
- 공개 이미지가 부족함
- 공개되었는데 기사 ID나 URL이 없음
이러한 항목들은 오늘 기사를 안전하게 공개할 수 있는지에 직접적으로 관련됩니다.
반면, 이번에 표시된 두 가지 WARNING은 현재의 1건을 즉시 게시할 수 없는 상태는 아닙니다. 따라서 검사는 성공합니다.
오늘 실제로 파일을 목록화했습니다.
정본으로 사용할 파일은 다음 1건입니다.
그 외에, 파일명에 [conflicted]가 붙은 복사본이 6건 있었습니다.
CURRENT_CONTEXT [conflicted].md
CURRENT_CONTEXT [conflicted 2].md
CURRENT_CONTEXT [conflicted 3].md
...
갱신 일시는 2026년 7월 24일부터 28일이었습니다. 정본인 CURRENT_CONTEXT.md는 9월 3일에 업데이트되었습니다.
줄 수도 확인했습니다.
| 종류 | 건수 | 줄 수 |
|---|
| 충돌 복사본 | 6 | 139~165행 |
| 정본 | 1 | 200행 |
파일의 해시도 비교했습니다.
충돌 복사본 6건 중 2건은 같은 내용이었으나, 나머지는 다른 해시였습니다. 정본 역시 모든 충돌 복사본과는 다른 내용입니다.
즉, 단순히 같은 파일이 이름을 바꿔서 중복된 것만이 아닙니다. 과거의 다른 상태가 남아있습니다.
프로젝트 규칙에서는 현재 위치의 정본으로 CURRENT_CONTEXT.md를 사용합니다.
정본은 존재하며, 검사 스크립트도 정본이 없는 경우에는 ERROR로 처리됩니다.
정본 없음 → ERROR
정본은 있으나 충돌 복사본도 있음 → WARNING
오늘 기사 제작에서는 충돌 복사본을 현재 위치로 사용하지 않았습니다. 공개 관리표, 전일 원고, 정본 규칙, 검사 스크립트를 확인했습니다. 따라서 충돌 복사본이 존재한다는 것만으로 오늘 기사의 공개를 멈출 필요는 없다고 판단할 수 있습니다.
다만, 경고가 불필요하다는 의미는 아닙니다.
충돌 복사본을 AI가 실수로 정본으로 읽을 가능성이 있습니다. 또한, 정본에 통합되지 않은 내용이 있는지 현재의 확인만으로는 단정할 수 없습니다.
이번에 진행한 것은 건수, 갱신 일시, 줄 수, 해시의 확인까지입니다.
확인한 것: 정본 1건, 충돌 복사본 6건, 내용은 모두 동일하지 않음
확인하지 않은 것: 각 차이분의 의미, 삭제해도 되는지 여부, 정본에 미반영된 내용
따라서 이 기사를 작성하기 위해 경쟁 복사본(競合コピー)을 삭제하거나 정본에 통합하지는 않았습니다.
공개 관리표에는 다음과 같은 방침이 있습니다.
이는 매일 공개를 시작하기 위한 기준으로, 공개 준비가 완료된 기사를 7편 보유하는 목표입니다.
하지만 현재의 실태는 다릅니다.
오늘의 기사를 만들기 전에 관리표를 확인했을 때, ready 상태인 기사는 0편이었습니다.
과거 날짜에 draft 상태인 기사가 2편 있지만, 이는 ready가 아니기 때문에 공개 준비 재고로 계산되지 않습니다.
매일 아침 그날의 기사를 만들어서 ready 상태로 만들면 재고는 1편이 됩니다. 이 1편을 사람이 승인하여 공개하면 다시 0편이 됩니다.
아침: ready 0편
오늘의 기사 준비: ready 1편
공개 후: ready 0편
...
즉, WARNING은 일시적인 표시가 아닙니다.
현재의 '당일에 1편을 만들고 그날 확인하여 공개하는' 실태와 '7편의 재고를 보유한 후에 매일 공개한다'는 방침이 일치하지 않음을 보여줍니다.
공개 준비 재고가 목표 미만이라도, 오늘의 기사 자체가 불완전하다고 단정할 수는 없습니다.
오늘의 1편에 대해서는 다음 조건을 개별적으로 확인할 수 있습니다.
원고가 있음
이미지가 있음
이미지 URL을 열 수 있음
...
이 때문에 재고 1/7은 WARNING이며, 오늘의 게시를 막는 ERROR는 아닙니다.
하지만 매일 여유 있게 공개를 지속한다는 방침으로 볼 때는 미달 상태입니다.
저는 지금까지 매일의 기사를 당일에 만들고, 확인한 후에 공개해 왔습니다. 적어도 최근까지는 그 운영 방식으로 공개가 계속되고 있습니다.
반면, 7편의 재고를 만드는 운영은 실현되지 못하고 있습니다.
이 글에서는 재고 목표를 달성했다고 쓰지 않습니다. 또한, 목표 7편이 필요하지 않다고 단정하지도 않습니다.
확인할 수 있었던 것은 방침과 현재의 운영에 차이가 있다는 점입니다.
오늘의 확인을 통해 경고를 다음 세 가지 종류로 나누어 읽기로 했습니다.
형식상으로는 WARNING이지만, 오늘의 기사의 사실이나 공개 정보에 영향을 준다면 공개를 중단합니다.
어떤 것이 정본인지 판단할 수 없음
기사에 사용된 사실이 경쟁하고 있음
이미지나 본문에 미확인 정보가 있음
이번에는 정본이 지정되어 있으며, 기사의 사실 확인에 경쟁 복사본을 사용하지 않았습니다.
현재의 1편에 직접적인 영향을 주지 않더라도, 방치하면 미래의 오독으로 이어질 문제입니다.
경쟁 복사본 6건은 이 종류입니다.
차이점을 확인하고 필요한 내용을 정본에 통합하며 불필요한 복사본을 정리하려면, 기사 공개와는 별도의 작업이 필요합니다.
이번에는 미실시 상태입니다.
공개 준비 재고 1/7은 이 종류입니다.
단순히 파일을 지운다고 해결되는 문제는 아닙니다.
재고 7편을 실제로 만드는 것
당일 제작을 현재의 운영으로 인정하는 것
목표의 의미나 수치를 재검토하는 것
어떤 것을 선택할지는 운영 방침에 따른 판단입니다. 오늘의 기사 제작만으로 결정할 수 없습니다.
WARNING이 거슬리기 때문에 표시되지 않도록 코드를 변경하는 것만으로는 문제가 해결되지 않습니다.
예를 들어, 다음 변경을 하면 화면은 조용해집니다.
경쟁 복사본의 검출을 삭제하는 것
ready_buffer_target을 1로 변경하는 것
WARNING을 출력하지 않는 것
하지만 그러면 '정본 후보가 여러 개 남아 있음', '방침과 실태가 어긋남'이라는 사실이 보이지 않게 됩니다.
이번에는 검사 코드를 변경하지 않았습니다. 경쟁 복사본도 삭제하지 않았습니다. 재고 목표도 7로 유지했습니다.
경고를 해소한 것이 아니라, 경고가 가리키는 상태를 확인한 것입니다.
같은 WARNING이 매일 표시되면 다음과 같은 방식으로 읽히기 쉽습니다.
어제도 나왔었지
어제도 공개할 수 있었잖아
오늘도 같으니까 괜찮겠지
이것은 경고의 내용이 아니라, 익숙해진 것을 안전의 근거로 삼는 것입니다.
어제와 같은 문구라도 파일의 수나 내용은 달라져 있을 가능성이 있습니다. 재고 부족 역시, 하루만의 부족과 장기간 지속되는 방침 미달에서는 의미가 다릅니다.
따라서 반복되는 WARNING에는 적어도 다음을 남겨야 합니다.
무엇을 확인했는지
오늘의 공개에 영향을 주는지
누가 판단할지
...
오늘의 기사에서는 처음 4가지까지 확인했습니다. 다음에 재검토할 날짜나 담당자는 아직 정하지 않았습니다.
AI가 검사 결과를 반환했을 때, 다음과 같이 요청할 수 있습니다.
WARNING을 지난번과 같으니 무시하지 말고 현재의 실체를 확인해 주세요.
오늘의 작업을 멈추게 하는 문제, 별도 작업으로 해결하는 문제, 방침과 실태의 차이로 나누어 주세요.
확인된 사실과 아직 판단하지 못한 것을 나누어 보고해 주세요.
...
중요한 것은 'WARNING니까 계속한다' 또는 'WARNING니까 전부 멈춘다' 중 어느 한쪽으로 단정하지 않는 것입니다.
경고가 무엇을 의미하는지 읽어보고, 오늘 작업에 미치는 영향을 확인합니다.
오늘 매일의 공개 전 검사에서 익숙해진 두 가지 WARNING을 다시 살펴보았습니다.
확인된 내용은 다음과 같습니다:
- 검사 코드는 ERROR가 있을 경우에만 실패하며, WARNING만 있는 경우에는 계속 진행한다.
CURRENT_CONTEXT의 원본은 존재한다 - 경쟁 복사본이 6건 있으며, 모두 같은 내용은 아니다.
- 원본과 경쟁 복사본 간의 차이점 정리나 삭제는 아직 수행하지 않았다.
- 오늘 기사 제작 전 공개 준비 재고는 0건이었다.
- 오늘 기사를 준비하면 1건이 되고, 목표는 7건이다.
- 당일 제작 및 당일 공개 실태와 7건의 재고 유지 방침은 일치하지 않는다.
- 오늘 1건을 공개하는 조건은 다른 검사에서 개별적으로 확인할 수 있다.
- 경고를 숨기기 위한 코드 변경은 수행하지 않았다.
WARNING은 즉시 중단하라는 명령이 아닙니다.
하지만 무시해도 좋은 배경 표시도 아닙니다.
첫걸음은 반복적으로 발생하는 경고를 발견했을 때, AI에게 다음 질문을 던지는 것입니다.
이 경고는 오늘 작업을 멈추게 하는 문제인가요? 아니면 미해결 상태로 기록해야 할 문제인가요?
검사가 OK라고 해도, 경고가 사라진 것은 아닙니다. 무엇을 확인했고, 무엇을 미해결 상태로 남겼는지까지 기록해야 비로소 다음 판단에 사용할 수 있습니다.