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 상태 확인