Spaghetti Meter: AI 에이전트로 측정하는 코드의 '스파게티 지수'

작성자가 사용자들의 참여를 유도하며 직접 만든 도구에 대한 피드백과 지식 베이스 확장을 위한 리소스 공유를 요청하고 있다.

• GitHub 저장소의 코드 품질을 객관적으로 점검하고 싶을 때 Spaghetti Meter를 활용할 수 있다.
• AI가 지적한 6단계 이상의 중첩이나 God function 구역을 우선적으로 리팩터링하여 코드 품질을 개선한다.

스파게티 코드(Spaghetti Code)

— 소스 코드가 복잡하게 얽혀 있어 구조를 파악하기 힘든 상태를 비유하는 용어다. 프로그램의 흐름이 스파게티 면처럼 꼬여 있어 유지보수가 매우 어렵고 버그 발생 가능성이 높다. 코드의 가독성과 관리 효율성을 판단하는 중요한 지표로 활용된다.

갓 펑션(God Function)

— 하나의 함수나 클래스가 너무 많은 기능을 수행하여 유지보수와 이해가 어려운 거대 함수를 의미한다. 객체 지향 설계 원칙인 단일 책임 원칙을 위반하며 코드의 결합도를 높여 수정을 어렵게 만든다. AI 에이전트가 코드의 스파게티성을 판단하는 주요 레드 플래그 중 하나다.

매직 넘버(Magic Number)

— 코드 내에 직접 하드코딩된 의미를 알 수 없는 숫자로 가독성을 해치는 주요 요인이다. 숫자가 무엇을 의미하는지 명확하지 않아 나중에 코드를 읽는 사람이 의도를 파악하기 어렵게 만든다. 상수를 사용하여 이름을 부여함으로써 해결할 수 있는 대표적인 코드 품질 저하 사례다.

중첩(Nesting)

— if문이나 for문 등 제어문이 여러 겹으로 겹쳐 있는 구조로 깊이가 깊어질수록 코드 파악이 어려워진다. Spaghetti Meter는 6단계 이상의 중첩을 심각한 코드 품질 저하 신호로 간주한다. 적절한 함수 분리를 통해 중첩 깊이를 낮추는 것이 권장된다.