Claude Code 커밋 전 리뷰 게이트: diff, 테스트, 공개 URL, CTA 확인

Claude Code가 빠르게 작성할수록 커밋 전 마지막 10분이 더 중요합니다. 필요한 것은 칭찬이 아니라 깨진 diff, 빠진 테스트, 잘못된 CTA, 무관한 변경을 막는 gate입니다.

왜 이 패턴이 필요한가

review gate는 구현 뒤에 하는 의식이 아니라 commit 가능 여부를 결정하는 차단기입니다. 글과 랜딩 페이지에서는 build 성공만으로 부족합니다. 공개 URL, canonical, h1, 무료 PDF, Gumroad, 상담 링크가 매출 경로와 연결됩니다.

함께 읽기: 함께 읽기 1, 함께 읽기 2, 함께 읽기 3.

실무 흐름

먼저 git status와 git diff —stat으로 범위를 고정합니다. diff를 Claude Code에 넘기고 findings first 형식으로 요구합니다. 수정 후 build를 실행합니다. 콘텐츠 변경이면 공개 URL이나 preview에서 h1과 CTA를 확인합니다. 마지막에는 목표와 관련된 파일만 stage합니다.

복사해서 쓰는 최소 세트

git status --short
git diff --stat
git diff -- src tests
npm.cmd run build

Review this diff before commit.
Prioritize bugs, regressions, missing tests, broken CTAs, and risky commands.
Return findings first.
For each finding include severity, file evidence, user impact, and smallest fix.
If there are no findings, list what remains unverified.

review_gate:
  must_check:
    - build_result
    - changed_files
    - public_url_when_content_changes
    - revenue_cta_links
  block_commit_if:
    - failing_build
    - untranslated_body
    - fallback_page
    - unrelated_diff

실제 예시

글 하단 CTA를 바꾸면 Gumroad와 상담 링크를 필수 리뷰 항목으로 넣습니다.
테스트만 추가했다고 생각해도 config나 lockfile이 섞이지 않았는지 확인합니다.
번역 글은 title과 lang뿐 아니라 본문 시작과 CTA 언어까지 봅니다.

운영 체크리스트

이 패턴은 한 번 읽고 끝내는 글이 아니라 Claude Code 작업 때마다 짧게 반복할 운영 장치입니다. 글, 상품 페이지, 상담 경로를 고치는 날에는 아래 항목을 작은 통제표처럼 사용하세요.

작업 전 목표를 한 문장으로 쓰고 범위 밖 파일이나 기능을 적습니다.
Claude Code가 읽어야 할 파일과 피해야 할 파일을 분리합니다.
구현 뒤 최소 하나의 증거 명령을 남깁니다. 콘텐츠는 build뿐 아니라 공개 URL을 봅니다.
무료 PDF, Gumroad, 상담 링크가 본문과 글 하단 CTA에서 일치하는지 확인합니다.
다국어 글은 title, h1, 본문 시작, CTA가 같은 언어인지 확인합니다.
무관한 dirty file을 stage하지 않습니다. 필요하면 commit 전에 diff를 다시 나눕니다.
다음 세션이 바로 이어갈 수 있도록 남은 위험과 볼 지표를 짧게 기록합니다.

어떤 상품이나 상담으로 연결할 것인가

독자가 아직 명령에 익숙하지 않다면 첫 출구는 무료 치트시트입니다. 같은 workflow가 매주 반복된다면 Prompt Templates로 리뷰, 디버깅, 글 수정 지시를 표준화합니다. 막히는 지점이 permissions, CLAUDE.md, hooks, MCP, CI/CD라면 Setup Guide가 맞습니다. 팀 책임, 공개 검증, 수익 경로를 함께 설계해야 한다면 상담으로 연결합니다.

handoff에 남길 것

Claude Code 작업은 patch가 그럴듯해 보인다고 끝나지 않습니다. 다음 사람이 세션을 다시 보지 않고도 판단을 이해할 수 있어야 운영 자산이 됩니다. handoff에는 변경 범위, 그 범위를 택한 이유, 실행한 증거 명령, 공개 URL, CTA 목적지, 남은 위험을 적습니다. 콘텐츠 작업이라면 heroImage, 내부 링크, 외부 링크, 언어 확인, 무료 PDF, Gumroad, 상담 경로가 본문에 남아 있는지도 적습니다. 제품 근처 페이지라면 어떤 독자가 무료 자료로 충분한지, 어떤 독자가 교재를 살지, 어떤 독자가 상담이 필요한지도 구분합니다.

다음에 볼 숫자

PV만으로 성공을 판단하지 않습니다. 공개 후에는 색인 상태, 국가별 유입, 글 하단 CTA 근처 클릭, Gumroad 클릭, 상담 폼 방문을 봅니다. 기존 인기 글을 고쳤다면 수정 전후의 이탈률과 다음 페이지 이동을 비교합니다. 다음 Claude Code 세션에 이 숫자를 먼저 주면 단순 글 생성이 아니라 수익 경로 개선으로 판단할 수 있습니다.

실패 사례

그냥 리뷰해 달라고 하면 위험보다 격려와 요약이 많아집니다.
커밋 전 build를 생략하면 MDX 문법, import, 링크 오류를 놓칩니다.
무관한 dirty file을 stage하면 나중에 원인 추적이 어려워집니다.

무료 PDF, Gumroad, 상담 경로

먼저 무료 PDF로 명령 습관을 잡고, 반복되는 작업은 Gumroad 교재로 표준화합니다. 팀 도입, 권한 설계, 수익 경로가 함께 걸리면 상담으로 넘어가는 편이 안전합니다.

검증 메모

이 글은 기존 리뷰 글과 연결하고, 리뷰 프롬프트, PowerShell 명령, YAML gate를 포함합니다. 수익 경로는 무료 PDF, Prompt Templates, Setup Guide, 상담으로 나누었습니다.