터미널terminal
기본값. 도구·자동화
vibelog-theme-terminal새 프로젝트를 vibelog에 올릴 때 그 레포에 붙이는 두 가지입니다. 커밋 규칙은 레포의 CLAUDE.md에, 쇼츠 테마는 레포 topic에 넣습니다. 이 사이트의 글과 영상은 전부 이 규칙을 따른 커밋에서 나옵니다.
커밋 메시지가 밤마다 글과 쇼츠의 재료가 됩니다. 본문이 40자 이상인 커밋이 5개 모여야 그날 글이 나오므로, 이 블록이 없으면 글이 아예 안 나올 수 있습니다. 커밋 메시지는 그대로 공개되므로, AI와 나눈 말이 커밋에 들어가지 않게 하는 규칙도 같이 붙입니다.
## 커밋 규칙 이 레포의 커밋 메시지는 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에 있습니다.
레포에 topic 하나를 달면 그 레포의 쇼츠 색과 강조 방식이 바뀝니다. 장면 순서와 자막 규칙은 모든 테마가 같고, 색·강조·카드 모양만 다릅니다. 아무것도 안 달면 터미널입니다.
기본값. 도구·자동화
vibelog-theme-terminal격자와 파란 밑줄, 각진 모서리. 인프라·API
vibelog-theme-blueprint주황 상단 띠와 채운 배지. 소비자 앱·운동
vibelog-theme-signal하나뿐인 밝은 테마, 초록 형광펜. 글쓰기·정리 도구
vibelog-theme-paper흑백에 노랑 마커. 실험작·장난감
vibelog-theme-highlighter30분 안에 프로젝트 인식이 topic을 읽고, 그 레포의 다음 쇼츠부터 새 테마로 나옵니다. 이미 만든 쇼츠는 그대로입니다.