[정비] 작업 로그 템플릿을 하나의 기준으로 통일하기

작업 전 상태

루트 누적 문서에는 개발 과정이 있었지만 실제 사이트 Log에는 1~4차 작업 글이 없었습니다. 기존 예시 로그 6개도 서로 다른 본문 구조를 사용했습니다.

요청한 내용

첨부된 쉬운 작업 로그 템플릿을 바탕으로 필요한 항목을 보완하고, 앞으로 Codex 작업마다 같은 기준으로 Log 글을 작성하도록 정리했습니다. 이전 작업과 기존 예시 로그도 새 기준에 맞췄습니다.

문제 원인

누적 개발 기록과 사이트 게시용 Log의 역할을 처음에 분리하지 않았고, 새 글을 작성할 때 복사할 공식 템플릿도 없었습니다.

변경한 내용

추가

• 공식 작업 로그 템플릿 docs/templates/WORK_LOG_TEMPLATE.md
• 실제 1~4차 작업 Log 4개
• 이번 템플릿 정비 작업 Log
• 작업 전 상태, 문제 원인, 추가·수정·삭제, 학습 포인트, 검증, 관련 파일, 남은 점 항목

수정

• 기존 placeholder Log 6개를 5개 공통 섹션으로 통일
• docs/development/DEVELOPMENT_REQUEST.md와 docs/development/DEVELOPMENT_LOG.md에 이번 작업 반영
• 썸네일 없는 작업 로그가 앞에 와도 목록에서 처음 등장하는 이미지를 eager 로딩하도록 수정

삭제

• Log 파일 삭제 없음
• 기존 글의 제각각인 단일 섹션 구성은 공통 구조로 교체

왜 이렇게 변경했나

docs/development/DEVELOPMENT_LOG.md는 프로젝트 전체 이력을 빠르게 찾는 누적 문서로 유지하고, 사이트의 MDX Log는 작업 하나를 독립적으로 읽고 태그로 모아보는 글로 분리했습니다.

초보자가 알아둘 점

기록 형식이 일정하면 코드를 전부 다시 읽지 않아도 작업 전후 차이와 확인 결과를 찾을 수 있습니다. 특히 "추가·수정·삭제"를 나누면 실제 작업 범위를 오해하기 어렵습니다.

확인한 내용

자동 검사

• npm run lint
• npm run type-check
• npm run format:check
• npm run build

직접 확인

• 전체 Log 목록 렌더링 확인
• /log?tag=Codex 필터 확인
• 새 작업 Log 상세 섹션 확인
• 기존 placeholder Log 상세 섹션 확인
• 가로 스크롤, 깨진 이미지, 브라우저 콘솔 오류 확인

관련 파일

• docs/templates/WORK_LOG_TEMPLATE.md
• src/content/logs/
• docs/development/DEVELOPMENT_LOG.md
• docs/development/DEVELOPMENT_REQUEST.md
• src/app/log/page.tsx

남아 있는 점

placeholder로 표시된 일반 학습 로그 6개는 실제 경험과 학습 내용이 준비되면 교체해야 합니다.

다음에 할 일

다음 개발 요청부터 작업 완료 시 이 템플릿으로 새 MDX Log를 추가합니다.