개발 가이드 (Development Guide)

이 프로젝트는 최신 AI 도구를 활용하여 효율적으로 관리되고 있습니다. 특히 Antigravity와 gemini-cli를 결합하여 문서의 정확성을 유지하고 개발 워크플로우를 자동화합니다.

개발 도구

1. gemini-cli

이 프로젝트의 주요 컨트리뷰터는 AI 에이전트인 gemini-cli입니다.

• 역할: 문서 작성, 코드 포맷팅, 프로젝트 구조 관리, 기술 리서치 및 정리.
• 특징: 프로젝트 루트의 GEMINI.md에 정의된 가이드라인을 엄격히 준수하여 일관된 품질의 결과물을 생성합니다.

2. Antigravity

gemini-cli의 기능을 확장하는 스킬 프레임워크입니다.

• 활용: 복잡한 검색, 대규모 코드 수정, 외부 API 연동 등 특수 작업 시 Antigravity 스킬을 호출하여 수행합니다.

워크플로우

문서 작성 및 수정

1. 요구사항 전달: 사용자가 gemini-cli에게 특정 주제에 대한 문서 생성을 요청합니다.
2. 리서치 및 전략: AI가 기존 문서 구조와 GEMINI.md의 규칙을 분석하여 작성 전략을 세웁니다.
3. 실행 (Execution): Markdown 형식에 맞춰 문서를 생성하거나 수정합니다.
4. 검증 (Validation): Jekyll 테마의 Front Matter 규칙 준수 여부와 링크 유효성을 체크합니다.

코드 품질 관리

• Python: 모든 Python 코드는 Black 포맷터를 사용하여 88자 라인 제한을 준수해야 합니다.
• Pre-commit: 커밋 전 .pre-commit-config.yaml에 정의된 훅이 실행되어 코드 스타일을 점검합니다.

기여 방법

이 프로젝트에 기여하고 싶다면 gemini-cli를 통해 수정을 요청하거나, 직접 PR을 보낼 수 있습니다. 직접 수정 시 다음 사항을 유의해 주세요.

• 새로운 문서는 docs/ 하위의 적절한 카테고리에 위치시켜야 합니다.
• 모든 문서에는 Jekyll just-the-docs 테마를 위한 Front Matter가 포함되어야 합니다.
• 한국어(KR) 작성을 원칙으로 하며, 기술 용어는 필요시 영문을 병기합니다.

---

최종 수정일: 2026년 3월 22일