AGENTS.md

AGENTS.md

이 저장소가 하는 일

이 저장소는 띵스플로우 기술 블로그를 구성하는 Jekyll 정적 사이트다. 게시글, 작성자 정보, 레이아웃, 스타일과 정적 자산을 소유하며 애플리케이션 서비스나 API 서버를 소유하지 않는다. 근거는 _config.yml, _posts/, _authors/, docs/Gemfile이며 2026-09-19에 읽었다.

읽는 순서

1. 이 AGENTS.md를 끝까지 읽는다.
2. structure/INDEX.md에서 스택, 경로, 진입점과 실측 규약을 확인한다.
3. 티어 C 측정 결과 별도 영역 문서는 없으므로 원본 경로를 직접 읽는다.

저장소 구조

• _posts/: 날짜가 붙은 기술 블로그 게시글을 소유한다.
• _authors/: 게시글 front matter의 author와 연결되는 작성자 프로필을 소유한다.
• _pages/, _layouts/, _includes/: 페이지와 Liquid 렌더링 구조를 소유한다.
• _sass/, assets/: 스타일, JavaScript, 이미지와 작성자 자산을 소유한다.
• _data/: 탐색 메뉴와 UI 문구를 소유한다.
• docs/, test/: Minimal Mistakes 기반 문서·테스트 fixture를 보존한다.
• structure/: 에이전트가 읽는 현재 구조 인벤토리를 소유한다.

작업 규칙

• 기본 브랜치는 master다. 변경은 의미 있는 별도 브랜치에서 만들고 master를 대상으로 PR을 연다.
• 게시글은 _posts/yyyy-mm-dd-글제목.md에 만들고 front matter의 author는 _authors/ 파일명과 맞춘다.
• 작성자는 _authors/이름.성.md, 프로필 이미지는 assets/authors/에 둔다.
• 로컬 확인은 Ruby와 Bundler를 준비한 뒤 docs/Gemfile의 의존성을 설치하고 Jekyll로 사이트를 실행한다.
• 커밋 메시지는 최근 100개에서 Merge 20개, fix 15개, docs 8개, update 9개, 이모지 접두사 9개, 기타 39개가 관찰됐다.
• GitHub Pages는 master의 /에서 배포된다. .github/workflows/는 없으므로 Actions 워크플로 검사는 없다.

Code Review Rules

• 게시글의 author가 _authors/의 실제 파일명과 다르면 승인하지 않는다.
• _posts/ 파일명이 yyyy-mm-dd- 형식을 따르지 않으면 승인하지 않는다.
• _config.yml의 사이트 URL, 도메인 또는 플러그인을 바꾸는 변경은 렌더링·배포 영향을 설명하지 않으면 승인하지 않는다.
• master 루트 Pages 배포를 깨뜨리는 경로 이동이나 생성물 커밋은 승인하지 않는다.
• 토큰, 비밀번호, 개인키 또는 .env 값을 커밋하는 변경은 승인하지 않는다.

하지 않는 것

• 생성 결과인 _site/, 캐시, 로컬 의존성 디렉터리를 새로 커밋하지 않는다.
• 기존 게시글·작성자 자산을 근거 없이 삭제하거나 이름을 바꾸지 않는다.
• GitHub Pages, Actions, 도메인 설정을 문서 변경과 함께 임의로 바꾸지 않는다.
• 현재 트리에 없는 빌드·테스트 절차를 사실처럼 적지 않는다.

근거

• 기존 규칙과 안내 7건은 기존 README.md의 절에서 흡수했다(2026-09-19 읽음). 원문은 structure/legacy-readme.md에 보존한다.
• 구조와 Jekyll 설정: _config.yml, index.html, _data/navigation.yml, docs/Gemfile, docs/Gemfile.lock(2026-09-19 읽음).
• 기여 흐름 참고: .github/CONTRIBUTING.md, .github/PULL_REQUEST_TEMPLATE.md(2026-09-19 읽음).
• 실측 GitHub·Git 결과와 명령은 structure/INDEX.md에 기록한다.