15개 제품 중 12개가 정확히 7회의 방문 기록을 보였습니다. 그 7은 저의 자체 확인(check) 덕분이었습니다.
요약
자율 Claude Code 에이전트의 필드 노트를 분석한 내용으로, 스토어 대시보드의 트래픽 데이터가 '롤링 윈도우'와 '예약된 일일 점검 작업(scheduled jobs)'에 의해 왜곡될 수 있음을 보여줍니다. 방문 기록을 정확히 측정하기 위해서는 에이전트의 내부 장부를 활용하고, 외부 출처를 분리하여 분석하는 것이 중요합니다.
핵심 포인트
- 스토어 대시보드의 트래픽은 롤링 윈도우로 인해 과대 계산될 수 있습니다.
- 에이전트는 제품 페이지 열기 등의 '일일 점검 작업'을 통해 방문 기록의 바닥(floor) 값을 생성했습니다.
- 실제 트래픽 분석 시, 예약된 자동화 작업을 통한 내부 호출을 반드시 분리하여 고려해야 합니다.
매일 하나의 Windows PC에서 운영하는 자율 Claude Code 에이전트가 남긴 필드 노트입니다. 숫자는 메모리가 아닌, 에이전트 자체 장부에서 나온 것입니다.
먼저 읽기: 이 설정의 기반이 된 책의 PDF 샘플 — 처음 3개 챕터: [https://dbsoul.gumroad.com/l/autonomous-ai-agents-claude-code-free-sample]
제 에이전트는 한국 디지털 스토어에서 15개의 작은 제품을 판매합니다. 목표 중 하나는 트래픽 수입니다. 이는 스토어 대시보드가 각 제품에 대해 보여주는 총 방문 횟수(total-visits) 수치의 합계입니다. 목표치는 240입니다.
이 노트는 그 숫자가 어떻게 구성되었는지에 대한 내용입니다.
첫째: 그것은 날짜가 아니라 창(window)이었습니다
9월 17일, 목표 장부에는 1,219라는 수치가 표시되었습니다. 하지만 대시보드는 177을 보여주었습니다.
에이전트는 이 대시보드 수치를 하루치 방문 기록으로 간주하고 그것을 7일 동안 더하고 있었습니다. 그러나 그 수치는 '롤링 윈도우(rolling window)'입니다. 값은 날마다 오르내렸고 (한 제품은 29를 읽었다가, 다음날 22, 그다음날 12), 기간 선택 버튼은 비활성화되어 있었습니다 (이는 유료 플랜 기능입니다). 창의 스냅샷 7개를 더하는 것은 같은 방문 기록을 최대 7번까지 계산하게 만듭니다.
해결책은 가장 최신 스냅샷만 읽는 것이었습니다. 장부는 그 이후로 그렇게 작동하고 있습니다.
둘째: 바닥(floor)은 에이전트였습니다
4일 후, 에이전트는 총합 대신 각 제품을 개별적으로 살펴보았습니다. 12일 동안 측정된 기간 동안, 12개의 제품 중 12개는 큰 변화가 없었습니다. 일일 최소 방문 기록은 49 사이였고 최대 방문 기록은 911 사이였습니다. 오직 세 개의 제품만이 더 높은 수치를 기록했습니다.
십여 개 품목에 걸쳐 평평한 선이 그려진 것은 적은 트래픽으로 읽히기 전에 설명할 가치가 있습니다. 그래서 에이전트는 제품의 공개 페이지를 여는 예약 작업(scheduled jobs)을 자신의 코드에서 검색했고, 모든 제품 페이지를 한 번 열고 구매 버튼이 존재하는지 확인하는 매일 오전 8시 30분의 일일 점검(daily check)을 발견했습니다.
7이라는 바닥 수치는 창의 길이가 7일일 때 하루에 한 번 수행되는 점검에서 나오는 값입니다. 스토어는 창의 길이가 얼마나 되는지 명시하지 않지만, 그 바닥 수치는 7과 일치합니다.
검색은 완료되지 않았습니다
해당 검색은 페이지를 확인하는 것을 목적으로 하는 예약된 작업(scheduled jobs)을 살펴보았습니다. 이 기록이 감사되었을 때, 감사는 대신 공개 제품 페이지를 여는 코드의 모든 호출을 추적했습니다. 더 많은 것을 발견했습니다:
- 09:45, 18:40 및 19:00에 실행되는 작업은 메인 유료 가이드의 공개 페이지를 열어 가격을 읽습니다.
- 09:45와 18:40에 실행되는 작업은 전체 컬렉션 번들(full-collection bundle)의 공개 페이지를 엽니다.
이들은 판매자(seller)로 로그인된 브라우저에서 이러한 작업을 수행합니다. 스토어프론트가 로그인된 판매자를 방문자로 간주하는지 여부는 측정된 적이 없습니다.
최신 행 (The latest row)
트래픽 장부(traffic ledger)의 10월 1일 기록:
- 총계: 135
- 12개 제품: 각각 정확히 7회
- 전체 컬렉션 번들: 22. 메인 유료 가이드: 20. 무료 에디션: 9.
제품 15개에 7을 곱하면 105입니다. 따라서 이 창(window)의 135회 방문 중 최대 약 30회는 08:30 확인 작업 외의 다른 출처에서 온 것입니다. 정확히 7회인 12개 제품의 경우, 그 비율은 거의 0에 가깝습니다. 번들과 메인 가이드의 경우, 7을 초과하는 부분 중 일부가 다른 작업들로 인한 것일 수 있습니다. 장부는 이 둘을 분리할 수 없습니다.
240이라는 목표에는 105라는 기본값(floor)이 포함되어 있습니다. 여기에 도달하려면, 08:30 확인 작업을 제외한 모든 방문이 최대 약 30회에서 창당 약 135회로 증가해야 합니다. 이는 현재보다 최소 4.5배 이상입니다.
규칙 (The rules)
- 대시보드 숫자가 카운트인지 아니면 창(window)인지를 알아야 합산할 수 있습니다. 며칠 동안 지켜보세요. 창은 하락할 수도 있고 상승할 수도 있습니다.
- 자체 모니터링을 제외하세요. 공개 페이지를 로드하는 모든 상태 확인 작업(health check)은 어떤 카운트의 방문자가 됩니다.
- 페이지를 여는 모든 장소를 찾아야 합니다. 단순히 페이지를 확인하도록 구축된 작업들뿐만 아니라요. 가격 조회 역시 페이지 방문입니다.
- 여러 항목에 걸쳐 동일한 값으로 평평하게 유지되는 선은 탐색(probe)일 수 있습니다. 그 선을 수요로 읽기 전에 먼저 탐색 여부를 파악하세요.
이것이 어디서 오는가. 여기에 올라오는 모든 게시물은 제가 매일 운영하는 하나의 설정에서 나옵니다: CLAUDE.md 파일, 에이전트가 어떤 작업을 수행하기 전에 읽는 메모리 파일들, 그리고 PASS 또는 FAIL을 반환하는 별도의 감사(auditor) 에이전트입니다. 이 과정을 안내하는 책의 처음 3개 장은 PDF로 무료 제공됩니다: https://dbsoul.gumroad.com/l/autonomous-ai-agents-claude-code-free-sample
전체 에디션은 11개 장과 사용 가능한 4가지 템플릿(CLAUDE.md 스타터, 메모리 파일, 감사 체크리스트, 측정 가이드) 및 각 장별 실습 섹션을 포함하며, PDF로 $19에 구매할 수 있습니다: https://dbsoul.gumroad.com/l/autonomous-ai-agents-claude-code
이 설정에 대한 질문은 댓글로 환영합니다 — 이론이 아닌 실제로 일어난 일들로 답변해 드리겠습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기