vladikk/modularity

해결하는 문제

이 프로젝트는 AI로 생성된 코드베이스에서 '큰 덩어리의 진흙' 아키텍처와 기술적 부채를 방지하는 방법을 제공합니다. 단순한 코드 수준 피드백을 넘어서 아키텍처적 비효율성, 잘못된 경계 설정, 소프트웨어 컴포넌트 간의 관리되지 않은 결합을 해결합니다.

작동 방식

이것은 Claude Code용 플러그인으로, 밸런스드 커플링 모델을 구현합니다. 이 모델은 소프트웨어 결합을 세 가지 차원에서 평가합니다: 통합 강도(공유 지식의 양), 거리(진화에 따른 사회기술적 비용), 변동성(변경 가능성의 확률).

이 플러그인은 두 가지 주요 기능을 제공합니다:

• /modularity:review: 기존 코드와 요구사항을 분석하여 결합의 불균형을 식별하고 개선을 위한 실행 가능한 권고 사항을 제공합니다.
• /modularity:design: 기능 요구사항에서 모듈형 아키텍처를 생성하며, 설계 문서, 통합 계약, 테스트 사양을 생성하고 설계가 명확해질 때까지 반복합니다.

대상 사용자

Claude Code를 사용하고 있으며, 특히 빠르게 생성된 AI 코드를 다룰 때 시스템의 모듈성과 유지보수성을 보장하고자 하는 소프트웨어 아키텍트 및 개발자.

주요 특징

• 아키텍처 중심: 라인 단위 코드 리뷰가 아니라 고수준 시스템 설계에 중점을 둡니다.
• 밸런스드 커플링 모델: 직관이 아닌 명확한 수학적 규칙 기반의 권고 사항을 제공합니다.
• 자동 설계: 기능 요구사항에서 전체 모듈 설계 사양과 통합 계약을 자동 생성할 수 있습니다.
• Claude Code 통합: Claude Code 환경 내에서 직접 플러그인으로 작동합니다.