AGENTS.md

프로젝트 개요

• 이 저장소는 세연어린이집 공개 홈페이지를 만드는 Jekyll 사이트이며, Minimal Mistakes를 기반으로 한다. 현재 테마 버전은 package.json의 version을 기준으로 확인한다.
• 사이트의 기본 언어는 한국어(ko-KR)이고 배포 대상은 GitHub Pages이다.
• 어린이집 고유 콘텐츠와 디자인이 upstream Minimal Mistakes 소스에 함께 들어 있다. 테마를 수정하거나 업데이트할 때 sunrise 스킨, 한글 UI, 세연어린이집 정보, 커스텀 템플릿과 이미지를 보존한다.

주요 구조

• _config.yml: 사이트 전역 설정, 플러그인, 기본 front matter. 변경 후 서버를 재시작해야 반영된다.
• _pages/: 소개, 교직원, 교육활동, 입학설명회, 오시는 길 등의 고정 페이지.
• _posts/: 날짜 기반 게시물. 현재 갤러리 페이지도 post로 구성되어 있다.
• _data/navigation.yml: 상단 내비게이션. _data/ui-text.yml은 한국어 UI 문구를 포함한다.
• _includes/, _layouts/, _sass/, assets/js/: 테마 및 사이트 표시 로직.
• assets/images/: 실제 페이지에서 참조하는 이미지. 한글 파일명과 대소문자를 그대로 유지한다.
• docs/, test/: Minimal Mistakes upstream 문서와 테마 테스트용 fixture. 실제 사이트 콘텐츠로 취급하지 않는다.
• _site/: Jekyll 생성 결과물이다. 직접 편집하거나 커밋하지 않는다.

작업 원칙

• 기존 한국어 문체, Liquid 태그, kramdown 속성 문법, YAML front matter 형식을 따른다.
• 들여쓰기는 공백 2칸, 줄 끝은 LF를 사용한다. Markdown의 의도적인 줄바꿈용 후행 공백은 보존한다.
• 페이지를 추가할 때 고유한 permalink를 지정하고, 노출이 필요하면 _data/navigation.yml 또는 index.html의 링크도 함께 갱신한다.
• 이미지 경로는 루트 기준(/assets/images/...) 표기를 우선하며, 파일이 실제로 존재하는지와 경로의 대소문자가 정확한지 확인한다. 의미 있는 alt 텍스트도 작성한다.
• 교직원 이름·직책, 모집 연도, 설명회 일시, 연락처 같은 운영 정보는 제공된 근거 없이 추측하거나 자동으로 최신화하지 않는다. 관련 값을 바꾸면 같은 정보를 보여 주는 _config.yml, index.html, _pages/, _data/를 검색해 일관성을 확인한다.
• 원아·교직원 사진과 개인정보는 공개 사이트 자료다. 요청받지 않은 개인정보를 새로 추가하거나, 빌드 출력과 로그에 민감한 값을 노출하지 않는다.
• 테마 변경은 가능한 한 작게 유지한다. 공통 동작은 _includes/, _layouts/, _sass/minimal-mistakes/, assets/js/_main.js에서 수정하고 생성·압축 파일만 단독으로 손대지 않는다.

생성 파일과 의존성

• JavaScript 원본을 수정했으면 npm run build:js로 assets/js/main.min.js를 다시 만든다.
• Rakefile의 기본 작업은 copyright, changelog, JavaScript, 버전 관련 파일을 생성할 수 있다. 필요한 생성 작업만 실행하고 예상하지 않은 대규모 변경은 커밋하지 않는다.
• 의존성 변경은 요청 범위에 필요한 경우에만 한다. 이 저장소의 Gemfile.lock과 package-lock.json은 .gitignore 대상이므로 새로 추적하지 않는다.

검증

변경 범위에 맞춰 아래 검증을 실행한다.

bundle exec jekyll build --trace
npm run build:js          # JavaScript 원본을 변경한 경우

• 로컬 미리보기는 bundle exec jekyll serve --force_polling --livereload로 실행한다. _config.yml 변경 후에는 반드시 재시작한다.
• 콘텐츠 변경은 생성된 페이지에서 링크, 이미지, 한글 문구, 모바일 레이아웃을 확인한다.
• 검증 중 생성된 _site/, 캐시, 임시 파일은 결과물로 제출하지 않는다.
• 작업을 마치기 전에 git diff --check와 git status --short로 공백 오류와 의도하지 않은 변경을 확인한다. Markdown의 의도적인 줄바꿈용 후행 공백은 git diff --check 경고가 발생하더라도 오류로 간주하지 않되, 공백만 있는 줄과 불필요한 후행 공백은 제거한다.