Claude Code 작업 룰

Claude Code 작업 룰

이 파일은 Claude Code가 이 프로젝트에서 작업할 때 따라야 할 규칙들을 정의합니다.

자동 타임스탬프 업데이트

규칙

  • 블로그 포스트를 수정하고 커밋할 때마다 반드시 타임스탬프를 업데이트합니다.
  • 다음 명령어를 실행하여 자동으로 업데이트합니다:
python3 update_timestamp.py "_posts/논문뿌셔먹기/2025-01-08-DDPM-논문-리뷰.md"

또는 모든 포스트 파일을 한번에 업데이트:

python3 update_timestamp.py

적용 시점

  1. 블로그 포스트 내용을 수정한 후
  2. git add 전에 실행
  3. 커밋 메시지에 변경사항 포함

업데이트되는 항목

  • last_modified_at 필드: Jekyll 메타데이터
  • **🔄 최종 업데이트** 섹션: 포스트 내용 상단

예시 워크플로우

# 1. 포스트 파일 수정
# 2. 타임스탬프 자동 업데이트
python3 update_timestamp.py "_posts/논문뿌셔먹기/2025-01-08-DDPM-논문-리뷰.md"

# 3. git 작업
git add .
git commit -m "포스트 내용 업데이트 및 타임스탬프 갱신"
git push

수식 렌더링

MathJax 설정

  • _config.yml에 MathJax 3.x 스크립트가 설정되어 있습니다.
  • 포스트의 front matter에 math: true가 필요합니다.
  • 네이버 블로그용 HTML 주석은 제거하지 않습니다.

문제 해결

  • 수식이 렌더링되지 않으면 MathJax 설정 확인
  • GitHub Pages 빌드 완료 후 확인

커밋 규칙

커밋 메시지 형식

제목: 간결한 변경사항 설명

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

주요 작업 후 필수 확인사항

  1. lint/typecheck 명령 실행 (해당하는 경우)
  2. 타임스탬프 업데이트
  3. git push 상태 확인

로컬 개발 워크플로우

Jekyll 로컬 서버 실행

로컬에서 변경사항을 먼저 확인한 후 GitHub에 업로드하는 워크플로우를 사용합니다.

# Jekyll 서버 시작
export PATH="$HOME/.local/share/gem/ruby/3.0.0/bin:$PATH"
bundle exec jekyll serve --host 0.0.0.0 --port 4000

개발 워크플로우

  1. 로컬 서버 시작: http://localhost:4000에서 미리보기 확인
  2. 파일 수정: 포스트 또는 설정 파일 수정
  3. 로컬 확인: 브라우저에서 변경사항 실시간 확인 (auto-regeneration 활성화)
  4. 타임스탬프 업데이트: 포스트 수정 시 자동 업데이트 스크립트 실행
  5. GitHub 업로드: 확인 완료 후 commit & push

서버 상태 확인

  • 서버 실행 중: http://localhost:4000
  • DDPM 논문 포스트: http://localhost:4000/논문뿌셔먹기/DDPM-논문-리뷰/
  • 수식 렌더링 테스트: http://localhost:4000/math_test.html

장점

  • GitHub Pages 빌드 실패 위험 최소화
  • 실시간 변경사항 확인 가능
  • MathJax 렌더링 즉시 테스트 가능
  • 라인 스페이싱 및 서식 문제 사전 발견