GitHub Code Quality 조직 대시보드 활용: 활성화부터 Trends 탭을 주간 회고에 쓰는 방법
저장소·조직 단위 설정 경로, Health와 Trends 탭에서 볼 지표, 팀 루틴에 넣는 순서

핵심 요약
- Code Quality는 Actions로 CodeQL 분석을 실행하므로 Actions 활성화와 지원 언어가 전제 조건이다.
- 저장소·조직 모두 Settings → Security → Code quality에서 켜고, 조직은 적용 저장소 범위와 강제 옵션을 정한다.
- Trends 탭은 최근 7·14·30일의 열린 finding 변화를 보여 주며, 필터가 그래프와 순위표에 함께 적용된다.
- 적용 범위를 바꾼 주에는 총계가 튈 수 있으므로 수치 변화는 원인 PR 확인의 출발점으로만 쓴다.
AI 코딩 도구를 도입하면 코드 작성량이 늘고, 리뷰어가 모든 변경의 유지보수성까지 보기는 어려워진다. GitHub Code Quality는 CodeQL 분석으로 신뢰성·유지보수성 문제를 찾아 저장소와 조직 단위로 보여 주는 기능이다. 2026년 8월에는 조직 대시보드에 시간에 따른 변화를 보여 주는 Trends 탭이 추가됐다. 이 글은 공식 문서와 변경 공지(2026-10-07 확인)를 기준으로 활성화 방법과 대시보드를 팀 루틴에 넣는 순서를 정리한다.
활성화 전 확인할 것
| 항목 | 내용 |
|---|---|
| GitHub Actions | Code Quality는 각 CodeQL 분석을 Actions로 실행하므로 Actions가 켜져 있어야 한다 |
| 언어 | 저장소에 CodeQL 품질 분석이 지원하는 언어가 있어야 한다 |
| 조직 Trends 탭 플랜 | GitHub Enterprise Cloud(데이터 레지던시 포함)와 GitHub Team에서 사용 가능, GitHub Enterprise Server는 미지원 |
| 비용 | 활성화 화면에서 관련 비용 변경을 확인하라는 단계가 있다. Actions 실행 시간과 요금은 조직 결제 설정에서 확인한다 |
활성화 순서
- 저장소 단위: 저장소의 Settings → Security → Code quality에서 Enable code quality를 누르고, 분석 언어와 러너 종류를 확인한 뒤 Save changes로 저장한다.
- 조직 단위: 조직의 Settings → Security → Code quality에서 "Repository access" 드롭다운으로 적용할 저장소 범위를 고른다. 특정 저장소만 고르거나 필터로 지정할 수 있다.
- 저장소 관리자가 설정을 끄지 못하게 하려면 강제(enforcement) 옵션을 켠다.
- 비용 변경 확인 화면을 검토하고 적용한다.
- 첫 분석이 끝난 뒤 조직 대시보드에서 저장소가 집계되는지 확인한다.
처음부터 모든 저장소에 켜기보다, AI 도구 파일럿을 진행하는 팀의 저장소 몇 개에 먼저 적용하면 Actions 사용량과 결과의 쓸모를 함께 확인할 수 있다. 파일럿 설계는 AI 코딩 어시스턴트 팀 도입 가이드에서 다뤘다.
Health 탭과 Trends 탭에서 볼 것
| 탭 | 보여 주는 것 | 활용 |
|---|---|---|
| Health | 현재 시점의 조직 코드 상태. 저장소별 reliability·maintainability 점수를 버블 차트로 표시 | 점수가 낮고 규모가 큰 저장소를 먼저 찾는다 |
| Trends | 선택한 기간(최근 7·14·30일)의 열린 finding 수 변화. health score나 severity로 묶어 보고, 현재 총계와 기간 시작 대비 순변화를 표시 | 개선된 저장소와 주의가 필요한 저장소를 순위표로 확인한다 |
필터 바에서는 reliability·maintainability 점수, standard finding(CodeQL)과 AI finding, 토픽, 팀, 공개 범위, 커스텀 속성으로 저장소를 좁힐 수 있고, Trends 탭의 그래프와 두 순위표 모두 이 필터를 따른다. 조직 소유자는 Code Quality가 켜진 모든 저장소의 데이터를 보고, 다른 구성원은 finding에 접근할 수 있는 저장소만(최대 3,000개) 본다. 같은 대시보드라도 보는 사람에 따라 숫자가 다를 수 있으므로 회의 자료는 한 사람이 만든 화면으로 통일한다.
finding을 처리하는 우선순위
| 순서 | 대상 | 이유 |
|---|---|---|
| 1 | 높은 severity이면서 최근 늘어난 저장소의 finding | 새로 들어온 문제는 작성자가 맥락을 기억할 때 고치는 비용이 가장 적다 |
| 2 | 여러 저장소에서 반복되는 같은 유형 | 규칙 파일이나 린트 설정 한 번으로 여러 곳의 재발을 막을 수 있다 |
| 3 | 오래된 낮은 severity finding | 리팩터링 일정에 묶어 처리하고, 의도된 코드라면 사유를 남기고 닫는다 |
finding을 닫을 때는 "고침", "의도된 코드", "오탐" 중 어느 쪽인지 남긴다. 사유 없이 닫힌 finding이 많으면 Trends 그래프의 감소가 실제 개선인지 판단할 수 없다.
주간 회고에 넣는 방법
대시보드는 열어 보지 않으면 쓸모가 없다. 새 회의를 만들기보다 기존 주간 회고에 5분짜리 항목으로 붙인다.
## 코드 품질 (Trends, 최근 7일, 팀 필터 = 우리 팀)
- 열린 finding: 총 ___건 (지난주 대비 +/- ___)
- 가장 많이 늘어난 저장소: ______ → 원인 PR: #___
- severity 상위 finding 중 이번 주 처리할 것: ______ (담당: ___)
- AI finding과 standard finding 비율 변화: ______
- 규칙 파일(AGENTS.md 등)에 추가할 지적: ______
- 늘어난 저장소부터: 순위표에서 finding이 가장 많이 늘어난 저장소를 열고, 그 기간에 병합된 큰 PR을 확인한다. AI가 만든 대형 PR이 원인이라면 스택 PR로 나누기를 검토한다.
- 반복되는 유형은 규칙으로: 같은 유형의 finding이 여러 저장소에서 반복되면 규칙 파일에 한 줄로 추가해 다음 생성부터 줄인다.
- 개인 평가와 분리: 저장소·팀 단위로만 보고, 개인별 순위로 쓰지 않는다. 숫자를 낮추려고 finding을 무시 처리하는 왜곡이 생긴다.
숫자를 해석할 때 주의할 점
Trends는 열린 finding 수의 변화다. Code Quality를 새 저장소에 켜면 그 저장소의 기존 finding이 한꺼번에 집계되어 조직 총계가 늘어난 것처럼 보인다. 적용 범위를 바꾼 주에는 그 사실을 회고 메모에 함께 적는다. 또 finding이 줄었다고 코드가 좋아졌다고 단정할 수 없다. 해당 코드를 삭제했거나 분석 대상 언어 설정이 바뀌어도 수치는 줄어든다. 수치 변화는 원인 PR을 확인하는 출발점으로 쓰고, 리뷰 규칙은 AI 생성 코드 리뷰 규칙과 함께 운영한다.
초보자가 자주 실수하는 포인트
- Actions를 막아 둔 조직에서 Code Quality를 켜고 분석이 돌지 않는 이유를 찾는다.
- 새 저장소를 추가한 주의 finding 증가를 품질 악화로 해석한다.
- 조직 소유자와 일반 구성원이 서로 다른 숫자를 보고 회의한다.
- 저장소 순위를 개인 평가에 연결해 finding 무시 처리가 늘어난다.
체크리스트
- Actions 활성화와 CodeQL 지원 언어를 확인했다.
- 파일럿 저장소에 먼저 Code Quality를 켰다.
- 비용 변경 확인 화면을 검토했다.
- 주간 회고에 Trends 확인 항목을 추가했다.
- 적용 범위 변경 이력을 회고 메모에 남긴다.
자주 묻는 질문
GitHub Enterprise Server에서도 Trends 탭을 쓸 수 있나요?
2026-08-19 변경 공지 기준으로 조직 단위 Trends는 GitHub Enterprise Cloud와 GitHub Team에서 사용할 수 있고, GitHub Enterprise Server에서는 제공되지 않습니다.
AI finding과 standard finding은 무엇이 다른가요?
문서는 standard finding을 CodeQL 분석 결과로, AI finding을 별도 유형으로 구분해 필터로 나눠 볼 수 있게 합니다. 두 유형의 비율 변화를 따로 보면 어느 쪽에서 문제가 늘었는지 구분할 수 있습니다.
참고 자료 · 검증 기준
- GitHub Docs — Enabling GitHub Code Quality
- GitHub Docs — Exploring code quality
- GitHub Changelog — Track organization code quality trends (2026-08-19)
위 자료와 내용을 대조한 날짜: . 도구·서비스 정책은 이후 바뀔 수 있으므로 적용 전 공식 문서를 다시 확인하세요.
이 글은 실제 실무 환경 테스트 및 검증된 기술 자료를 바탕으로 작성되었으며, 환경 변화에 따라 지속적으로 갱신됩니다.