이 저장소는 Slidev를 활용하여 개발자 교육용 강의 교안(슬라이드)을 제작하고 빌드하는 전용 작업 공간입니다. 단순한 슬라이드 작성을 넘어, AI 코딩 에이전트가 준수해야 할 엄격한 교육 설계(Pedagogical) 및 디자인 규칙이 유기적으로 맞물려 작동하도록 구성되어 있습니다.
이 프로젝트의 핵심은 AGENTS.md에 기술된 지침을 바탕으로 AI 에이전트가 규칙을 완벽하게 적용하는 구조에 있습니다. 이 규칙들은 슬라이드의 가독성과 정적 출력(PDF) 최적화를 제어합니다.
- 1개 슬라이드 1개 개념 (One Concept Per Slide): 인지 부하를 줄이기 위해 개념을 분할하고, 3~5줄 이하의 짧은 불릿과 코드로 구성합니다.
- 직관 우선 설명: 형식적 정의보다 직관적인 이해와 최소한의 코드 예시를 우선 제시합니다.
- 정적 출력 최적화 (Static Only): PDF 변환 시 누락되는 데이터가 없도록
v-click등의 동적 애니메이션을 완전히 차단합니다. - 여백 규칙 (Bottom Margin Rule): 전체 높이의 약 20%를 하단에 비워 두어 모니터 가림 현상이나 왜곡을 사전에 방지합니다.
- MECE 기반 가이드라인:
AGENTS.md는 중복과 누락 없이(MECE) 설계와 스타일링, 코드 작성을 정갈하게 규정합니다. - Blockquote 용어 정의: 용어와 정의 사이에 강제적으로 빈
>줄을 삽입하여 시각적 분리감을 확보합니다. - 체크리스트: 대시 포맷(
- [ ])만 허용하며, 개별 체크 항목은 카드형 반투명 플레이트로 스타일링합니다. - 코드 헤더의 문맥화: 정형화된 "실전 코드", "구현 예시", "활용 예시" 표현을 지양하고, 코드의 구체적인 행동을 설명하는 자연스러운 문맥 명칭을 사용합니다.
- Slidev 수직 정렬 제어: Slidev의 기본
my-auto수직 중앙 배치 성향을 강제로 비활성화하고, 모든 내용을 상단 정렬시킨 후 타이틀 직후에2rem크기의 고정적 Breathing Room을 확보합니다.
모든 커스텀 스타일링, 타이포그래피 설정 및 웹폰트 로더는 전역 제어를 위해 style.css 한 곳에 통합하여 격리 관리됩니다. slides.md 내부에는 <style> 태그를 사용하지 않습니다.
- 배경색 (Primary Background):
#02343F(딥 틸 그린) - 글자색 (Primary Foreground):
#F0EDCC(소프트 크림) - 코드 블록 배경색:
#0d2026(차콜 틸 네이비) - 폰트 바인딩:
- 타이틀: 에이투지체 (
A2z) - 본문: KoddiUD 온고딕 (
KoddiudOngodic) - 코드: 네이버 D2Coding (
D2Coding)
- 타이틀: 에이투지체 (
원활한 협업과 정갈한 변경 관리를 위해 에이전트의 Git 작동 방식을 규정하고 커스텀 스킬북으로 활용합니다.
- Git 커밋 메시지 규칙:
영어카테고리(영어스코프) : 한글메시지형태로 작성하며, 콜론 앞뒤의 띄어쓰기를 철저히 준수합니다.- 설명 대상이 되는 메시지는 한국어 협업의 가독성을 위해 반드시 한글로 작성합니다.
- 정돈된 변경 관리: 커밋은 의미론적으로 분리하고, 불필요한 커밋은 대화형 리베이스(
git rebase -i)를 활용해 스쿼시하여 히스토리를 정돈합니다. - 안전한 강제 푸시: 로컬 히스토리 수정 시
--force대신 반드시 **--force-with-lease**를 사용하여 안전을 보장합니다.
├── .agents/ # AI 에이전트 구동 지원 리소스 및 스킬북
│ └── skills/
│ ├── slidev/ # Slidev 마크다운 작성 및 애니메이션 규칙 스킬
│ └── git/ # Git 커밋 메시지 및 리베이스 관련 스킬
├── outputs/ # 최종 생성된 교안별 마크다운 아카이브 (e.g., 145-1.md, 145-2.md)
├── slides.md # Slidev 로컬 컴파일러가 기동 시 참조하는 활성 슬라이드 본문
├── style.css # Slidev 빌드 시 전역 주입되는 전역 커스텀 CSS
├── package.json # Slidev 및 종속 라이브러리 스펙
└── AGENTS.md # AI 코딩 에이전트용 작업 수칙 (MECE 구조)