본문으로 건너뛰기

커밋 규칙과 쇼츠 테마

새 프로젝트를 vibelog에 올릴 때 그 레포에 붙이는 두 가지입니다. 커밋 규칙은 레포의 CLAUDE.md에, 쇼츠 테마는 레포 topic에 넣습니다. 이 사이트의 글과 영상은 전부 이 규칙을 따른 커밋에서 나옵니다.

rules

커밋 규칙과 대화 비공개

커밋 메시지가 밤마다 글과 쇼츠의 재료가 됩니다. 본문이 40자 이상인 커밋이 5개 모여야 그날 글이 나오므로, 이 블록이 없으면 글이 아예 안 나올 수 있습니다. 커밋 메시지는 그대로 공개되므로, AI와 나눈 말이 커밋에 들어가지 않게 하는 규칙도 같이 붙입니다.

CLAUDE.md
## 커밋 규칙

이 레포의 커밋 메시지는 vibelog가 매일 밤 읽어 데브로그 글과 쇼츠 영상을 자동 생성하는 원료다. 커밋 메시지가 얇으면 글도 얇아진다.

- 한국어로 쓴다. 형식: `타입: 한 줄 요약` + 빈 줄 + 본문.
- 타입은 feat / fix / docs / chore / design / asset 중 하나. fix는 실제로 깨졌던 것을 고쳤을 때만 쓴다 — 영상의 커밋 그래프가 타입별로 색을 입히고, fix 커밋은 글의 "삽질 포인트" 재료가 된다.
- 본문에 **"왜"**를 반드시 한 문장 이상 쓴다. 뭘 바꿨는지는 diff가 말해주니, 왜 그렇게 했는지·뭘 시도하다 왜 버렸는지를 남긴다.
- 버그를 고친 커밋은 증상 → 원인 → 해결을 본문에 남긴다.
- 작업 단계가 끝날 때마다 커밋한다. 하루치를 한 커밋에 뭉치지 않는다.
- 제목 한 줄만 있고 본문이 없는 커밋은 글을 쓸 만한 커밋으로 치지 않는다. 본문이 40자 이상인 커밋이 5개 이상 모여야 글이 나온다. 끝에 붙는 `Co-Authored-By` 같은 서명 줄은 본문 글자로 세지 않는다.
- 커밋 메시지는 공개 블로그에 그대로 노출된다. 비밀 키·내부 URL·개인정보를 쓰지 않는다.

## 대화 비공개 (필수)

이 레포는 공개이고, 커밋 메시지는 vibelog가 매일 밤 읽어 글과 쇼츠로 그대로 발행한다. 운영자가 AI와의 대화에서 쓴 문장은 개인정보로 다룬다.

1. 운영자가 대화에서 쓴 문장을 레포 어디에도 옮기지 않는다. 커밋 메시지, 코드 주석, 문서, 테스트 데이터, PR·이슈 본문 모두 해당한다. 따옴표가 없어도, 일부만 따와도 마찬가지다. 커밋 메시지에 들어간 말은 그날 밤 글과 영상이 된다.
2. 누가 무엇을 말했다·요청했다·지적했다는 서술도 쓰지 않는다. 무엇이 왜 문제였고 어떻게 바꿨는지를 제품과 코드의 사실로만 쓴다.
3. 따옴표는 화면 문구·데이터 값·코드 값처럼 제품 안의 글자에만 쓴다.
4. 다른 세션이나 다른 서비스에 넘기는 요청문에도 운영자의 문장을 옮기지 않는다. 파일 경로와 줄 번호로 가리킨다.
5. 이미 들어간 것을 발견하면 위치 목록부터 보여 준다. 이력 재작성과 강제 푸시는 운영자 확인을 받은 뒤에 한다. vibelog에 이미 발행된 글은 vibelog 레포의 `content/`에서 따로 고친다.
타입쓸 때쇼츠 커밋 그래프
feat새 기능, 눈에 보이는 새 능력강조색
fix실제로 깨졌던 것을 고쳤을 때만경고색 · 글의 삽질 포인트 재료
docs문서만 바뀜회색
chore정리, 설정, 의존성, 자동 작업회색
design모양만 바뀜 (새 기능 없이)회색
asset그림·글꼴·소리 파일회색

커밋할 때 이 규칙을 기계로 검사하는 코드는 scripts/quote-rule.ts에 있습니다.

themes

쇼츠 테마

레포에 topic 하나를 달면 그 레포의 쇼츠 색과 강조 방식이 바뀝니다. 장면 순서와 자막 규칙은 모든 테마가 같고, 색·강조·카드 모양만 다릅니다. 아무것도 안 달면 터미널입니다.

터미널terminal

기본값. 도구·자동화

vibelog-theme-terminal
지금 쓰는 레포: 바이브 로그
블루프린트blueprint

격자와 파란 밑줄, 각진 모서리. 인프라·API

vibelog-theme-blueprint
지금 쓰는 레포: 아직 없음
시그널signal

주황 상단 띠와 채운 배지. 소비자 앱·운동

vibelog-theme-signal
지금 쓰는 레포: 아직 없음
페이퍼paper

하나뿐인 밝은 테마, 초록 형광펜. 글쓰기·정리 도구

vibelog-theme-paper
지금 쓰는 레포: 아파트 감별사
하이라이터highlighter

흑백에 노랑 마커. 실험작·장난감

vibelog-theme-highlighter
지금 쓰는 레포: 거짓말 탐정
apply

테마 적용하는 법

  1. 1테마를 바꿀 레포의 GitHub 첫 화면을 엽니다.
  2. 2오른쪽 About 옆 톱니바퀴 → Topics에 위 topic을 붙여 넣고 저장합니다.
  3. 3다른 vibelog-theme-… topic이 이미 있으면 지웁니다. 둘이면 앞의 것 하나만 쓰입니다.
  4. 4레포의 vibelog.json에 "theme"이 적혀 있으면 그 값이 topic보다 앞섭니다. 그때는 그 값을 바꿉니다.

30분 안에 프로젝트 인식이 topic을 읽고, 그 레포의 다음 쇼츠부터 새 테마로 나옵니다. 이미 만든 쇼츠는 그대로입니다.