IT › 소프트웨어 › 프로그래밍

코드 품질 관리Code Quality Management

코딩 표준 · 디자인 패턴으로 기준을 세우고 정적 분석 · 코드 리뷰로 변경을 검사하며, 걸린 것은 리팩토링으로 고치거나 기술 부채로 기록해 소스 코드를 읽고 고치기 쉬운 상태로 유지하는 활동이다.

1요약

  1. 코드 품질 관리는 프로그래밍에서 소스 코드 자체를 다루는 갈래로, NIST SP 800-218(2022)이 코딩 관행(PW.5)과 코드 리뷰 · 분석(PW.7)을 나눠 둔 것처럼 그 위에서 기준 → 검사 → 고침 · 기록의 순환이 돈다.
  2. 검사만 하고 상환이 없으면 경고가 쌓인다 — 흐름 · 재고 곡선의 계산에서 경고 1,200건인 코드에 달마다 60건이 들어오면 12개월 뒤 1,920건이 되지만, 새 코드 관문과 건드린 파일 정리를 함께 하면 735건으로 준다(설명용 가정 값).
  3. 「품질 도구를 넣었는데 나아지지 않는다」는 새로 들어오는 결함(흐름)과 쌓인 결함(재고) 중 어느 쪽을 막는가로 가른다 — 흐름이 열려 있으면 관문 문제, 관문이 섰는데 총수가 그대로면 상환 시간 문제다.

2등장 배경

1970년대 코드 검사는 개인 습관이었고 결함은 시험 단계에서야 드러났다. Fagan 은 1976년 정해진 역할 · 절차로 설계와 코드를 함께 읽는 인스펙션을 내놓아 사람의 읽기를 공정으로 만들었고(Fagan 1976), Cunningham 은 1992년 «처음 내보내는 코드는 빚을 지는 일»이라는 말로 고치지 않은 구조가 변경마다 이자를 물린다고 적었다(Cunningham 1992).

검사는 그 뒤 도구로 옮겨 갔다. 2016년 Dagstuhl 세미나는 기술 부채를 «단기에는 편하지만 뒤의 변경을 더 비싸게 하거나 막는 설계 · 구현 구성의 모음»으로 정의했고(Avgeriou 외 2016 p.112), OASIS 는 정적 분석 결과를 도구 사이에 주고받는 형식 SARIF 2.1.0 을 표준으로 정했다(정오표 반영판 2023-08).

지금은 AI 코드 보조 도구가 작성 속도를 바꿨다 — 통제 실험에서 보조 도구를 쓴 집단이 HTTP 서버 구현 과제를 55.8% 빨리 끝냈다(Peng 2023). 코드가 빨리 들어올수록 모든 변경을 같은 관문에 세우는 일이 코드 품질 관리에서 커진다.

3쉽게 이해하기 — 동네 빵집 주방

민서는 동네 빵집 주방장이다. 반죽 기계 덕에 하루 반죽이 두 배로 늘었지만, 모든 반죽은 레시피 카드 규격과 대조하고 저울 · 온도계로 잰 뒤 선배 제빵사가 맛을 본다. 선배가 「크림 넣는 순서가 세 군데서 다르다」고 하면 작업대를 정리해 한 곳으로 모으고, 이번 주에 못 고친 오븐 온도 쏠림은 수리 장부에 적어 다음 주 오전을 비워 둔다. 검사를 통과한 빵만 진열대에 오른다.

1 반죽 기계 AI 활용 개발 두 배로 빨리 2 레시피 카드 코딩 표준 규격과 대조 3 저울 · 온도계 정적 분석 숫자로 판정 4 선배 맛보기 코드 리뷰 의도와 모양 7 진열대 병합 통과한 빵만 검증된 반죽법 디자인 패턴 규격이 참고 작업대 정리 Refactoring 순서를 한 곳으로 5 수리 장부 기술 부채 미룬 수리 적기 6 이름표 = 실제 토픽 이름 · 번호 = 이야기 순서 · 점선 = 규격이 참고하는 해법

그림 1 · 반죽(작성)은 레시피 규격 · 저울 · 선배의 맛보기를 차례로 지나고, 걸린 것은 작업대에서 정리하거나 장부에 적어 미룬 뒤에야 진열대(병합)에 오른다.

반죽기계로 빨리
규격 대조레시피 카드와
재기무게 · 온도
맛보기선배가 의도를
정리순서를 한 곳으로
장부못 고친 수리 적기
비유 — 무엇을 보나 실제 — 무엇을 보나 저울 · 온도계 반죽 1,000 g · 발효 27 도 기준을 넘었나 숫자로 바로 판정 정적 분석 SQL 문자열 결합 · 이름 규칙 위반 규칙으로 판정 · 결과 = level 값 선배 제빵사 크림 순서가 세 군데서 다르다 저울로는 잴 수 없는 의도 · 모양 코드 리뷰 취소 분기가 세 파일에 흩어짐 규칙에 없는 설계 의도를 사람이 읽음 경계 — 기계가 판정한 것은 사람이 다시 세지 않고, 사람은 의도에 시간을 쓴다 가는 화살 = 비유와 실제의 짝

그림 2 · 저울은 숫자로 판정되는 것만, 선배는 숫자로 잴 수 없는 의도만 본다 — 정적 분석과 코드 리뷰도 같은 경계에서 일을 나눈다.

비유 속 역할실제 이름실제로 하는 일
반죽 기계AI 활용 개발AI 보조 도구가 코드 초안을 빠르게 만든다
레시피 카드 규격코딩 표준이름 · 형식 · 금지 구문 규칙을 정한다
검증된 반죽법디자인 패턴되풀이되는 설계 문제에 이름 붙은 해법을 쓴다
저울 · 온도계정적 분석실행하지 않고 규칙 위반 · 취약 구문을 찾는다
선배의 맛보기코드 리뷰다른 개발자가 의도 · 설계를 병합 전에 읽는다
작업대 정리Refactoring동작을 그대로 두고 구조를 바꾼다
수리 장부기술 부채미룬 개선과 비용을 적고 갚을 때를 정한다
진열대병합관문을 통과한 변경만 주 브랜치에 들어간다

⚠ 비유가 맞지 않는 곳: 빵은 하루면 팔려 없어지지만 코드는 몇 년 남아 다음 변경의 바탕이 된다. 그래서 장부에 적은 부채는 저절로 사라지지 않고, 그 코드를 건드릴 때마다 이자가 붙는다.

4구조 — 아래 토픽 지도

아래 토픽 일곱은 변경 하나가 지나는 단계로 나뉜다. NIST SP 800-218 PW.7.2 가 리뷰 · 분석을 조직의 코딩 표준에 맞춰 수행하고 찾은 문제를 이슈 추적기에 기록하게 한 순서와 같다.

토픽맡는 일단계판정 근거 · 산출물대표 근거
코딩 표준이름 · 형식 · 금지 구문 규칙기준규칙(필수) · 권고SEI CERT C
디자인 패턴되풀이 설계 문제의 해법기준패턴 이름 · 적용 결과GoF 1994
정적 분석실행 없이 규칙 위반 찾기검사(도구)분석 결과 · levelSARIF 2.1.0 3.27절
코드 리뷰의도 · 설계를 사람이 읽기검사(사람)지적 · 승인 기록SSDF PW.7.1
Refactoring동작 그대로 구조 개선고침변경 전후 시험 통과Fowler 2018
기술 부채미룬 개선과 그 비용기록 · 상환부채 이슈 · 상환 일정Avgeriou 외 2016
AI 활용 개발AI 보조로 코드 작성작성(입력)출처 표시 · 같은 관문Peng 2023
작성 — 사람 + AI 활용 개발 변경분(diff) 기준 고침 기록 · 상환 코딩 표준 규칙 · 권고 디자인 패턴 되풀이 해법 정적 분석 도구 · 자동 판정 코드 리뷰 사람 · 의도 Refactoring 동작 그대로 구조 개선 기술 부채 미룬 개선 원금 · 이자 미룸 상환 때 다시 고침 위 글자 = 단계 · 굵은 화살 = 변경의 길 · 가는 화살 = 근거 제공 · 상환 · 점선 상자 = 입력(작성)

그림 3 · 작성된 코드는 기준을 근거로 도구 · 사람 검사를 지나고, 걸린 것은 리팩토링으로 고치거나 기술 부채로 미뤘다가 다시 갚는다.

🔑 코딩 표준 · 디자인 패턴은 «무엇이 좋은가»를, 정적 분석 · 코드 리뷰는 «이번 변경이 그것을 지켰나»를, 리팩토링 · 기술 부채는 «못 지킨 것을 언제 고치나»를 정한다.

5동작 — 주문 취소 변경 하나의 검사 경로

주문 서비스에 「주문 취소」 기능을 더하는 변경분 하나의 사례다. 줄 수 · 건수 · 시험 수는 설명용 가정 값이다.

  1. 작성 — 개발자가 AI 보조 도구의 제안을 받아 180줄을 쓰고, 그중 120줄이 제안에서 왔다고 변경 설명에 적는다.
  2. 표준 검사 — 포매터 · 린터가 이름 · 형식 규칙 위반 7건을 알리고, 6건은 자동 수정, 1건(약어 이름)은 손으로 고친다.
  3. 정적 분석 — 기준선과 견준 결과 9건 중 baselineState 가 new 인 것이 2건, unchanged 가 7건이다(SARIF 2.1.0 3.27.24절). 관문 조건은 «new 이면서 level error 인 결과 0건»이다.
  4. 관문 판정 — new 2건 중 1건은 SQL 문자열 결합(CWE-89 · error)이라 매개변수 질의로 고치고, 1건(note · 긴 함수)은 리뷰로 넘긴다.
  5. 코드 리뷰 — 리뷰어가 「취소 가능 여부 분기가 세 파일에 흩어졌다」고 지적한다.
  6. 리팩토링 — 상태별 판단을 주문 상태 객체 하나로 모아 분기 3곳을 1곳으로 줄이고, 기존 시험 42개가 그대로 통과한다.
  7. 부채 기록 · 병합 — 건드린 파일의 unchanged 3건은 함께 고치고, 나머지 4건은 「결제 모듈 예외 처리」 부채 이슈 하나로 묶어 다음 분기 일정을 잡은 뒤 병합한다.
1 작성 180줄 AI 제안 120줄 2 표준 검사 위반 7 → 0 자동 6 · 손 1 3 정적 분석 new 2 · unchanged 7 기준선과 비교 4 관문 판정 error 1 → 0 CWE-89 수정 · note 1 5 코드 리뷰 지적 1건 분기가 세 파일에 6 리팩토링 분기 3곳 → 1곳 시험 42개 그대로 통과 7 부채 기록 3건 정리 · 4건 이슈 다음 분기 상환 병합 굵은 테두리 = 병합을 막는 관문 · new · unchanged = 기준선 비교 상태(SARIF baselineState)

그림 4 · 한 변경이 표준 검사(②) · 정적 분석 관문(③④) · 리뷰(⑤)를 지나며, 고친 것은 리팩토링(⑥)으로, 미룬 것은 부채 이슈(⑦)로 나뉜 뒤 병합된다.

관문과 상환은 서로 다른 숫자를 줄인다. 아래 곡선은 경고 1,200건 · 달마다 새 경고 60건 · 건드린 파일 정리 4% · 상환 30건이라는 설명용 가정 값으로 달마다 직접 계산한 것이다.

남은 정적 분석 경고(건) 0 500 1,000 1,500 2,000 0 3 6 9 12개월 1,920 1,200 735 445 관문 없음 새 코드 관문만 관문 + 건드린 파일 정리 관문 + 정리 + 달마다 30건 상환

그림 5 · 관문만 세우면 경고 총수는 1,200건에 멈출 뿐 줄지 않고, 건드린 파일 정리와 따로 잡은 상환 시간이 더해질 때만 735건 · 445건으로 내려간다.

🔑 관문은 새로 들어오는 결함(흐름)을 막을 뿐 쌓인 결함(재고)은 줄이지 않는다 — 재고를 줄이는 것은 건드리는 코드를 그때그때 정리하고 상환 시간을 따로 잡는 일이다.

6비교 — 관련 기술과의 경계

기술맡는 일코드 품질 관리와의 경계넘기는 곳
프로그래밍 패러다임언어 · 방식(객체지향 · 함수형) 선택패러다임은 «무엇으로 쓰나», 품질 관리는 «쓴 것이 기준을 지켰나»언어별 금지 구문 → 코딩 표준
유지보수납품 뒤 변경 유형 · 절차 · 진화유지보수는 변경 요청 단위, 품질 관리는 변경분 하나의 관문쌓인 부채의 대규모 정리 → 재공학 · 역공학
소프트웨어 설계 원칙모듈 경계가 좋은지 판정원칙은 판정 기준, 품질 관리는 그 기준을 코드에 적용 · 검사경계를 다시 그을 일 → 설계 원칙
테스트실행해서 실패를 드러냄정적 분석 · 리뷰는 실행하지 않는 검사, 테스트는 실행 판정리팩토링의 안전망 → 회귀 테스트
소프트웨어 품질 보증 체계조직 · 공정의 품질 기준과 평가보증은 기준을 정하고 감사, 품질 관리는 변경마다 실행관문 지표 → 보증의 측정 자료

분석질문이 «이 변경을 들여도 되나»면 코드 품질 관리, «쌓인 코드를 통째로 바꿀까»면 유지보수, «실행 결과가 맞나»면 테스트로 간다. 근거는 NIST SP 800-218 이 리뷰 · 분석(PW.7)의 대상을 사람이 읽는 코드로 두고 실행 코드 시험은 PW.8 로 따로 둔 점이다.

7실무 진단 — 품질 도구가 효과를 내지 못하는 원인 가르기

분석새 경고 수(흐름)를 먼저, 전체 경고 추이(재고)를 그다음, 리뷰 시간의 쓰임을 마지막에 본다. 흐름이 열려 있으면 재고 대책이 소용없고(그림 5 관문 없음 곡선), 둘 다 서 있을 때 남는 문제는 사람이 무엇에 시간을 쓰는가다.

#증상의심 원인해당 토픽확인 자료판정 기준(근거)
1경고 총수가 달마다 늘어남새 코드 관문 없음정적 분석baselineState 값별 건수new 가 남은 채 병합되면 흐름이 열림(SARIF 2.1.0 3.27.24절)
2관문은 섰는데 총수가 그대로쌓인 경고를 갚지 않음기술 부채부채 이슈의 열림 · 닫힘 추이닫힘 0 이면 재고 고정(그림 5 관문만 곡선)
3리뷰 지적 대부분이 형식 · 이름표준 검사가 자동화되지 않음코딩 표준리뷰 지적 분류도구로 판정되는 지적은 분석 쪽으로 옮김(SSDF PW.7.1)
4AI 제안 코드의 취약 구문이 병합 뒤 발견AI 코드가 관문을 거치지 않음AI 활용 개발변경 설명의 출처 표시 · 분석 기록출처와 상관없이 리뷰 · 분석 기록이 있어야 함(SSDF PW.7.2)

8시험 대비

시험에서는 코드 품질 관리 활동의 구성 요소를 묻는 구조 · 구성형, 정적 분석과 코드 리뷰 또는 리팩토링과 기술 부채를 견주는 비교형으로 나올 수 있다. 구성형이면 그림 3 순환으로 일곱 토픽을 단계별로 세우고, 비교형이면 구조 표의 「단계」 · 「판정 근거」 열로 경계를 긋는다.

답안 목차
  1. 개요 — 정의 · 목적(읽고 고치기 쉬운 코드 유지) · NIST SP 800-218 PW.5 · PW.7 근거
  2. 구성 — 그림 3 순환 지도(기준 → 검사 → 고침 · 기록)와 일곱 토픽 표
  3. 적용 절차 — 그림 4 변경 하나의 관문(표준 검사 → baselineState new 판정 → 리뷰 → 리팩토링 · 부채 기록)
  4. 관리 원리 — 그림 5 흐름 · 재고 곡선(1,920 · 1,200 · 735 · 445건)
  5. 비교 — 정적 분석 ↔ 코드 리뷰 · 리팩토링 ↔ 기술 부채(판정 주체 · 시점 표)
  6. 동향 · 판단 — AI 활용 개발(작성 55.8% 단축)과 출처를 가리지 않는 같은 관문

꼭 쓸 키워드
코딩 표준디자인 패턴정적 분석SARIF코드 리뷰리팩토링기술 부채품질 관문기준선AI 활용 개발

다른 답안과 차이를 내는 한 가지는 도구를 나열하지 않고 그림 5 처럼 «흐름을 막는 관문»과 «재고를 줄이는 상환»을 나눠, 어느 대책이 어느 숫자를 줄이는지 보이는 것이다.

9오해와 사실

  • 오해정적 분석 도구를 들이면 코드 리뷰는 줄여도 된다.
    사실NIST SP 800-218 PW.7.1 은 사람이 직접 읽는 리뷰와 도구 분석을 따로 정의하고 조직이 무엇을 언제 쓸지 정하게 한다 — 도구는 규칙으로 판정되는 결함을, 리뷰는 의도 · 설계를 맡는다.
  • 오해기술 부채는 실력 없는 개발자가 만든다.
    사실Fowler 2009 는 부채를 신중한 · 무모한, 의도한 · 모르고 진 것의 네 사분면으로 나누고, 출시 날짜를 지키려고 알고 지는 신중한 부채도 있다고 본다 — 문제는 기록 없이 지는 부채다.
  • 오해기술 부채는 정적 분석 경고의 합계다.
    사실Dagstuhl 정의는 설계 · 구현 구성 전체를 대상으로 하고, 같은 보고서는 가장 큰 부채가 코드 품질 측정으로는 잡히지 않는 설계 절충에서 온다고 적는다(Avgeriou 외 2016).

10핵심 정리

토픽단계판정 주체막는 것남는 기록걸리면
코딩 표준기준규칙 문서 · 도구사람마다 다른 형식 · 금지 구문규칙 목록린터 오류
디자인 패턴기준설계자되풀이 문제의 즉흥 해법패턴 이름리뷰 지적
정적 분석검사도구규칙 위반 · 취약 구문분석 결과(SARIF)관문 실패
코드 리뷰검사사람의도 · 설계 어긋남지적 · 승인수정 요청
Refactoring고침개발자 + 시험구조 악화변경 전후 시험되돌림
기술 부채기록 · 상환팀기록 없는 미룸부채 이슈상환 일정
AI 활용 개발작성사람 + 도구작성 지연출처 표시같은 관문

11참고 문헌

  1. 먼저 볼 문헌
  2. ★ NIST SP 800-218 Secure Software Development Framework (SSDF) Version 1.1 — 코딩 관행(PW.5) · 코드 리뷰와 분석(PW.7) · 실행 시험(PW.8)이 어떻게 나뉘는지 볼 때
    NIST · 2022-02 · csrc.nist.gov/pubs/sp/800/218/final · 확인 2026-11-14
  3. ★ Static Analysis Results Interchange Format (SARIF) Version 2.1.0 Plus Errata 01 (OASIS Standard incorporating Approved Errata) — 분석 결과의 level 값과 기준선 비교 상태(baselineState)를 볼 때
    OASIS · 2023-08 · docs.oasis-open.org/sarif/sarif/v2.1.0/errata01/os/sarif-v2.1.0-errata01-os-complete.html · 확인 2026-11-14
  4. ★ Managing Technical Debt in Software Engineering (Dagstuhl Seminar 16162) · Dagstuhl Reports 6(4) pp.110-138 — 기술 부채의 합의 정의와 코드 측정으로 잡히지 않는 부채를 볼 때
    P. Avgeriou · P. Kruchten · I. Ozkaya · C. Seaman (Schloss Dagstuhl) · 2016-04 · drops.dagstuhl.de/storage/04dagstuhl-reports/volume06/issue04/16162/DagRep.6.4.110/DagRep.6.4.110.pdf · 확인 2026-11-14
  5. ★ Technical Debt Quadrant (Martin Fowler bliki) — 신중한 · 무모한, 의도한 · 모르고 진 부채의 네 사분면을 볼 때
    Martin Fowler · 2009-10 · martinfowler.com/bliki/TechnicalDebtQuadrant.html · 확인 2026-11-14
  6. 본문 근거
  7. The Impact of AI on Developer Productivity: Evidence from GitHub Copilot (S. Peng · E. Kalliamvakou · P. Cihon · M. Demirer) — arXiv · 2023-02 · arxiv.org/abs/2302.06590 · 확인 2026-11-14
  8. Design and code inspections to reduce errors in program development · IBM Systems Journal 15(3) pp.182-211 — M. E. Fagan · 1976-09 · doi.org/10.1147/sj.153.0182 · 확인 2026-11-14
  9. The WyCash Portfolio Management System (W. Cunningham · OOPSLA 1992 Experience Report) — Ward Cunningham · 1992-10 · c2.com/doc/oopsla92.html · 확인 2026-11-14
  10. SEI CERT C Coding Standard — Software Engineering Institute · Carnegie Mellon University · 2026-11 · cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/ · 확인 2026-11-14
  11. Design Patterns: Elements of Reusable Object-Oriented Software — Addison-Wesley · 1994-10 · www.informit.com/store/design-patterns-elements-of-reusable-object-oriented-9780201633610 · 확인 2026-11-14
  12. Refactoring: Improving the Design of Existing Code, Second Edition (Martin Fowler · Kent Beck) — Addison-Wesley · 2018-11 · www.informit.com/store/refactoring-improving-the-design-of-existing-code-9780134757599 · 확인 2026-11-14
  13. CWE-89: Improper Neutralization of Special Elements used in an SQL Command (CWE 5.0) — MITRE · 2026-10 · cwe.mitre.org/data/definitions/89.html · 확인 2026-11-14