비용 0원으로 구현하는 GitHub 저장소 헬스 체크 자동화

Context

저장소의 유지보수 상태를 객관적으로 판단할 지표 부족. 기존의 코드 분석 도구들은 개발자당 높은 월 구독료 발생. 수동으로 상태를 확인하고 README에 업데이트하는 운영 공수 과다.

Technical Solution

• GitHub Actions 기반의 완전 자동화된 헬스 스코어링 엔진 설계
• README 품질, 커밋 활동, 문서화 상태 등 7가지 가중치 기반 측정 지표 도입
• README 내 특정 마커 사이의 데이터를 자동으로 갱신하는 Auto-commit 메커니즘 구현
• Groq API와 Llama 3 모델을 연동하여 수치 기반 데이터를 인간 중심의 텍스트 요약으로 변환
• Discord Webhook을 활용하여 매주 월요일 오전 8시(UTC)에 정기 분석 리포트 전송 구조 구축
• 외부 벤더 종속성 없는 100% 오픈 소스 및 무료 티어 서비스 조합의 아키텍처 채택

Impact

• 비용: Code Climate($37/dev), LinearB($49/dev) 대비 $0 달성
• 분석 지표: README 품질(20%), 커밋 활동(20%), 최신성(15%), 문서화(15%), CI/CD(15%), 이슈 응답(10%), 커뮤니티 신호(5%) 구성

Key Takeaway

복잡한 유료 도구 없이도 CI/CD 파이프라인과 무료 LLM API의 조합만으로 프로젝트의 정량적 품질 관리 시스템 구축 가능.