시작 가이드 — AI PR Review Toolkit

6시간 work product — PR 자동화 도구(Python 패키지) + 데모 + 콘텐츠 + B2B 영업 자료 + 랜딩 페이지를 한 폴더에 통합한 풀스택 패키지.

이 문서는 이 폴더를 처음 연 사용자가 5분 안에 핵심을 파악하고, 자신의 상황에 맞는 시작 경로를 고를 수 있도록 작성된 마스터 가이드다.

---

1. 이게 뭔가?

만들어진 배경

• 사용자의 본업(코드 리뷰·PR 작업)을 자산화해서 외부 수익원으로 만드는 6시간 work product.
• 7회 외주 작업을 통합한 결과: 코드(2회) + 데모(1) + 콘텐츠(1) + 영업(2회) + 랜딩(1).
• 결과물은 “도구 + 콘텐츠 + 영업 자료 + 랜딩 페이지” 4개 축으로 동시 검증·판매 가능한 형태로 패키징됨.

5분 안 이해할 핵심 가치

• PR 코드 리뷰 30분 → 1분: pr-review CLI가 git diff를 읽어 Claude(claude-sonnet-4-6)로 한국어 시니어 톤 리뷰 작성 (잠재 버그·보안·스타일·테스트·영향도 항목).
• PR 설명 작성 10분 → 즉시: pr-describe CLI가 커밋 + diff에서 한국어 PR title·description·체인지로그 생성 (컨벤셔널 커밋 지원).
• 차별화: 한국어 리뷰 · 시니어 톤 · 셀프 호스팅 가능 · 한국 개발 컨벤션.
• 사용 방식 2가지: 로컬 CLI 또는 GitHub Action 워크플로우 (.github/workflows/에 YAML 1장 복사).

무엇을 받았는지 (산출물 5종)

#	영역	폴더	한 줄
1	코드(도구 본체)	pr_reviewer/, pr_describer/, templates/, tests/	Python 패키지 2개 + GitHub Action YAML 2개 + pytest 모음
2	데모	demo/	샘플 PR diff + 데모 시나리오 + 스크린샷·영상 스크립트
3	콘텐츠	content/	한국어 블로그·한국어 X thread·영문 LinkedIn 게시물
4	B2B 영업	outreach/	타깃 30곳 리스트 + 한·영 이메일 템플릿 + 발송 플레이북 + 첫 미팅 PPT 초안
5	랜딩 페이지	landing/	index.html + 감사 페이지 + Lead Magnet PDF 원고 + 배포 가이드

---

2. 어디서부터 시작해야 하나? — 시작 경로 3가지

상황·목적에 따라 다른 경로를 권장한다. 한 가지만 골라도 되고, 권장 조합(A + B 병행)으로 진행해도 좋다.

경로 A — 본업에 먼저 적용해보고 싶다 (검증 우선)

Step	작업	예상 시간
A-1	API 키 발급: ANTHROPIC_API_KEY(console.anthropic.com), GITHUB_TOKEN(github.com/settings/tokens, classic PAT + repo 권한)	10분
A-2	.env.example → .env 복사 후 키 채움	1분
A-3	가상환경에서 python -m pip install -e ".[dev]" 설치	5분
A-4	본인 repo에서 git diff main..HEAD | pr-review --from-stdin 시도	5분
A-5	결과 만족 시 templates/pr-review.yml을 본인 repo의 .github/workflows/에 복사하고 Secrets에 ANTHROPIC_API_KEY 등록	10분
A-6	1주일 dogfood: 매 PR마다 시간 절약·발견한 버그 수 기록	1주

예상 소요: 첫 시도 30분, 검증 완료 1~2시간 + 1주 측정.

다음 단계: 측정 결과를 콘텐츠(경로 B)·영업 자료(경로 C)의 placeholder에 실제 수치로 치환.

---

경로 B — 빠르게 마케팅 자료부터 검증하고 싶다 (수요 검증 우선)

Step	작업	예상 시간
B-1	landing/index.html을 GitHub Pages 또는 Vercel·Netlify에 배포 (가이드: landing/README.md)	10분
B-2	landing/lead_magnet.md를 PDF로 변환하여 이메일 수집 보상으로 연결	30분
B-3	content/blog_post_kr.md의 placeholder를 본업 결과로 채우고 본인 블로그·velog·tistory에 게시	30분
B-4	content/x_thread_kr.md를 X(Twitter)에 발행	5분
B-5	content/linkedin_post_en.md를 LinkedIn 영문으로 발행 (네트워크 빌딩)	5분
B-6	1주일 트래픽·이메일 수집·반응 수치 측정 → 수요 시그널 확인	1주

예상 소요: 1~3시간 + 1주 측정.

다음 단계: 시그널 강하면 경로 C로 직접 영업; 시그널 약하면 메시지·각도 조정 후 재발행.

---

경로 C — B2B 영업부터 시작하고 싶다 (직접 매출 우선)

Step	작업	예상 시간
C-1	outreach/target_companies.md 30곳 중 placeholder 5곳을 자기 네트워크로 채움	30분
C-2	outreach/email_template_kr.md의 {회사명}, {본인 이름}, {본업 결과 수치}, 가격 placeholder 치환	30분
C-3	outreach/sending_playbook.md 따라 화·수·목 오전 발송 (요일·시간대·법적 주의사항 포함)	1시간
C-4	회신 받으면 outreach/first_meeting_deck.md 기반으로 PPT 만들어 미팅	회신당 2~4시간
C-5	영문 시장이라면 outreach/english_template.md 활용	추가 30분

예상 소요: 첫 발송까지 2시간, 첫 미팅까지 1~3주.

다음 단계: 회신율·미팅 전환율 측정하여 메시지·가격 조정.

---

권장 조합

A + B 동시 진행 권장:

• A로 본업에 적용하며 실제 비포·애프터 수치 확보 → 그 수치를 B의 콘텐츠 placeholder에 채워 신뢰도 있는 발행 가능.
• B에서 수요 시그널 강하게 잡힌 후 C 진행 시 회신율 상승 기대.

가장 빠른 매출: C 단독 (네트워크가 강한 경우). 가장 큰 규모: A → B → C 순차 (도구 검증 + 콘텐츠 마케팅 + 영업) 3개월 호흡.

---

3. 사용자가 반드시 직접 해야 할 일 (자동화 불가)

3-1. API 키 발급 — 모든 시작의 전제

• ANTHROPIC_API_KEY: console.anthropic.com에서 가입 후 발급. 5분, 무료 크레딧 있음.
• GITHUB_TOKEN: github.com/settings/tokens에서 classic PAT + repo 권한으로 발급. 1분.
• .env 파일 생성: .env.example을 복사하여 .env로 저장 후 값 채움.

  cp .env.example .env
  # .env 열고 ANTHROPIC_API_KEY, GITHUB_TOKEN 값 입력
  

• 자세한 항목은 .env.example 파일 참고 (CLAUDE_MODEL 오버라이드 옵션 포함).

3-2. Placeholder 치환 — 자료가 진짜 사용 가능해지는 단계

모든 콘텐츠·영업·랜딩 자료에 placeholder가 있다. 사용자가 직접 채워야 한다.

• {회사명} · {본인 이름} · {본업 적용 결과 수치} · {팀 규모} · {기간} 등
• example.com, your-org, your-repo 등 도메인·repo 자리표시자
• 일괄 치환 PowerShell 예시:

  Get-ChildItem -Recurse -Include *.md, *.html |
    ForEach-Object { (Get-Content $_) -replace 'example.com', 'mydomain.com' | Set-Content $_ }
  

• 일괄 치환은 신중하게: 코드 파일에는 영향 없는지 사전 grep 권장.

3-3. 가격 정책 결정

모든 영업·랜딩 자료의 가격은 placeholder다. 사용자가 결정해야 한다.

• 참조 가격(시장 일반):
  • 자동화 구축 패키지(1회성): 500만원~
  • SaaS 월 구독: 15만원/월~
  • 셀프 호스팅 라이선스: 300만원/년~
• 첫 3건은 레퍼런스용 30~50% 할인 OK (후기·사례 확보 우선).

3-4. 법적 검토 (필요 시)

• B2B 콜드 이메일 발송 전 정보통신망법 자기 검토 필수 (outreach/sending_playbook.md의 법적 주의사항 섹션 참고).
• 변호사 자문이 필요하면 별도 진행 — 본 패키지는 법적 자문이 아니다.

---

4. 폴더별 안내

pr_reviewer/ — PR 코드 리뷰 본체

• 무엇이: pr-review CLI 구현 (cli.py / diff_loader.py / reviewer.py / formatter.py / github_client.py / config.py).
• 언제: 본업 적용·기능 수정·테스트 추가 시.
• 시작 파일: pr_reviewer/cli.py, pr_reviewer/reviewer.py.

pr_describer/ — PR 설명·체인지로그 본체

• 무엇이: pr-describe CLI 구현 (cli.py / commit_loader.py / describer.py / formatter.py / github_client.py / config.py / logging_utils.py).
• 언제: 본업 적용·기능 수정·테스트 추가 시.
• 시작 파일: pr_describer/cli.py, pr_describer/describer.py.

templates/ — GitHub Action 워크플로우 템플릿

• 무엇이: pr-review.yml, pr-describe.yml — 사용자가 자기 repo의 .github/workflows/에 복사.
• 언제: 본업 repo에 자동화 배포할 때.
• 시작 파일: templates/pr-review.yml.

tests/ — pytest 모음

• 무엇이: test_pr_reviewer/(reviewer/cli/formatter/diff_loader/github_client) + test_pr_describer/(describer/cli/formatter/commit_loader/github_client) + conftest.py.
• 언제: 기능 수정·기여 시. python -m pytest tests/ -v로 실행.
• 시작 파일: tests/conftest.py.

demo/ — 데모 자료

• 무엇이: 샘플 PR diff(sample_pr_diff.md) + 시연 시나리오(scenario.md) + 스크린샷 가이드(screenshot_guide.md) + 영상 스크립트(video_script.md). 4파일 1,107줄.
• 언제: 영상 촬영·블로그 스크린샷·미팅 시연 자료 만들 때.
• 시작 파일: demo/scenario.md → demo/video_script.md.

content/ — 콘텐츠 마케팅

• 무엇이: 한국어 블로그(blog_post_kr.md) + 한국어 X thread(x_thread_kr.md) + 영문 LinkedIn(linkedin_post_en.md).
• 언제: 수요 검증·인바운드 트래픽 확보용 발행할 때.
• 시작 파일: content/blog_post_kr.md.

outreach/ — B2B 영업 자료

• 무엇이: 영업 README + 타깃 30곳(target_companies.md) + 한·영 이메일 템플릿 + 발송 플레이북 + 첫 미팅 PPT 초안.
• 언제: 직접 영업·콜드 이메일 발송·첫 미팅 PPT 만들 때.
• 시작 파일: outreach/README.md → outreach/sending_playbook.md.

landing/ — 랜딩 페이지·Lead Magnet

• 무엇이: index.html(랜딩 본체) + thank_you.html(감사 페이지) + lead_magnet.md(이메일 수집 보상 PDF 원고) + README.md(배포 가이드).
• 언제: 인바운드 페이지 띄울 때 (GitHub Pages·Vercel·Netlify 5분 배포).
• 시작 파일: landing/README.md → landing/index.html.

---

5. 6시간 work 통계

영역	파일 수	분량	외주 횟수
코드 (pr_reviewer + pr_describer + tests + templates)	~30	~수천 줄	2
데모	4	1,107줄	1
콘텐츠	3	282줄 (~12KB)	1
영업	6	1,128줄 (~60KB)	2 (1차+2차)
랜딩	4	1,323줄 (~50KB)	1
합계	~47	—	7

---

6. 다음 30일 권장 액션 (체크리스트)

Week 1 — 도구 검증 & 콘텐츠 기반 다지기

• API 키 발급 (ANTHROPIC_API_KEY, GITHUB_TOKEN)
• .env 생성, pip install -e ".[dev]" 설치
• 본업 repo에서 pr-review, pr-describe 5건 이상 실행
• 비포·애프터 수치 측정 (분 단위 절약 시간, 발견한 버그 수)
• 본업 repo에 templates/pr-review.yml 배포 (Secrets 등록 포함)

Week 2 — 콘텐츠 발행 & 랜딩 배포

• content/blog_post_kr.md placeholder 치환 → 본인 블로그·velog·tistory 게시
• content/x_thread_kr.md X에 발행
• content/linkedin_post_en.md LinkedIn 영문 발행 (네트워크 빌딩)
• landing/index.html GitHub Pages 또는 Vercel·Netlify 배포
• 이메일 수집 폼 연결 (landing/README.md 가이드 참고)

Week 3 — B2B 영업 1차 발송

• outreach/target_companies.md placeholder 5곳 채움
• outreach/email_template_kr.md 변수 치환 + 가격 확정
• outreach/sending_playbook.md 따라 1차 10곳 화·수·목 발송
• 정보통신망법 자기 검토 (sending_playbook의 법적 섹션)
• 회신 모니터링·로그

Week 4 — 측정 & 조정

• 트래픽·이메일 수집·블로그 조회수 측정
• B2B 회신율·미팅 전환율 측정
• 시그널 강한 채널 더블다운, 약한 채널 메시지·가격 조정
• 첫 미팅 성사 시 outreach/first_meeting_deck.md로 PPT 제작
• 결과 기록 → 다음 30일 플랜 수립

---

7. 알려진 한계·미해결 사항

• 본인 적용 결과 수치는 모두 placeholder — 사용자가 1주일 dogfood 후 실측치로 채워야 함.
• outreach/target_companies.md 30곳 중 5곳은 placeholder — 사용자 네트워크로 직접 채움.
• 가격은 모두 placeholder — 사용자가 결정 필요 (참조 가격은 §3-3 참고).
• 자동화 도구는 모든 PR을 대체하지 않는다 — 큰 리팩토링·아키텍처 변경은 사람 검토가 반드시 필요. AI 리뷰는 일반적·반복적 패턴 잡는 데 강점.
• 정보통신망법은 사용자 자기 책임 — 변호사 자문은 별도. outreach/sending_playbook.md는 일반 가이드일 뿐 법적 자문이 아님.
• 테스트 커버리지: pytest 모음은 있으나 80%+ 보장은 미확인. 기여 전 python -m pytest tests/ --cov=pr_reviewer --cov=pr_describer 실행하여 측정 권장.
• pyproject.toml의 [tool.setuptools]에 pr_describer 누락 의심: 현재 packages = ["pr_reviewer"]만 명시되어 있어 pr-describe CLI가 정상 설치되지 않을 수 있음. 사용자가 pyproject.toml을 직접 검토하여 packages = ["pr_reviewer", "pr_describer"]로 수정 권장 (자동 수정 X — 본 가이드는 read-only).

---

8. 도움 자료 (어디서 더 자세히?)

주제	참고 파일
코드 사용법 (CLI 옵션·설치)	README.md
데모 영상 제작	demo/screenshot_guide.md, demo/video_script.md
데모 시연 시나리오	demo/scenario.md
샘플 PR diff	demo/sample_pr_diff.md
한국어 블로그 발행	content/blog_post_kr.md
한국어 X thread	content/x_thread_kr.md
영문 LinkedIn	content/linkedin_post_en.md
B2B 영업 시작	outreach/README.md
콜드 이메일 발송 일정·법적 주의	outreach/sending_playbook.md
한국어 이메일 템플릿	outreach/email_template_kr.md
영문 이메일 템플릿	outreach/english_template.md
타깃 30곳 리스트	outreach/target_companies.md
첫 미팅 PPT 초안	outreach/first_meeting_deck.md
랜딩 배포 가이드	landing/README.md
랜딩 페이지 본체	landing/index.html
감사 페이지	landing/thank_you.html
Lead Magnet PDF 원고	landing/lead_magnet.md
환경 변수	.env.example
패키지 정의·entry points	pyproject.toml
외주 작업 기록 (히스토리)	.claude/team-decisions.md

---

9. 빠른 명령어 참고

# 설치 (가상환경 권장)
python -m pip install -e ".[dev]"

# 환경 변수
cp .env.example .env  # 그리고 ANTHROPIC_API_KEY, GITHUB_TOKEN 채움

# PR 리뷰 (로컬 diff)
git diff main..HEAD | pr-review --from-stdin

# PR 리뷰 (GitHub PR + 댓글 자동 작성)
pr-review --pr your-org/your-repo#42 --post

# PR 설명 생성
pr-describe --branch feature/login --base main

# 테스트
python -m pytest tests/ -v
python -m pytest tests/ --cov=pr_reviewer --cov=pr_describer

# 린트
ruff check .

---

10. 한 줄 정리

이 폴더는 “PR 자동화 도구 + 콘텐츠 + 영업 + 랜딩” 4축을 동시에 들고 시장에 진입할 수 있도록 설계된 풀스택 패키지다. API 키 발급과 placeholder 치환만 끝내면, 30일 안에 본업 적용·콘텐츠 발행·B2B 영업 발송까지 모두 실행 가능하다.

다음 단계: §2의 경로 A·B·C 중 자신의 상황에 맞는 것을 골라 시작하라. 권장 조합은 A + B 동시다.