hyhmrright/brooks-lint

해결하는 문제

brooks-lint는 전통적인 린터(구문과 스타일에 집중)가 일반적으로 놓치는 아키텍처의 편차, 기술적 부채, 도메인 모델 왜곡과 같은 문제를 식별하는 AI 기반 코드 리뷰 도구입니다. 이 도구는 일반적인 AI 제안이 아닌, 확립된 소프트웨어 공학 원칙에 기반한 구조적이고 추적 가능한 코드 품질 평가 방법을 제공합니다.

작동 방식

이 도구는 12권의 고전적 공학 서적(예: The Mythical Man-Month, Clean Architecture, Refactoring)의 원칙을 통합하여 생산 코드와 테스트 스위트에 대해 각각 6개씩 총 12개의 '부패 위험'을 진단합니다.

코드 리뷰 시, 엄격한 진단 체인을 따릅니다: 증상 → 원인 → 결과 → 해결책. 각 발견은 책 인용, 심각도 레이블(Critical, Warning, Suggestion), 그리고 수치적 헬스 스코어(0–100)로 뒷받침됩니다.

대상 사용자

LLM 패턴이 아닌 소프트웨어 공학 문헌에 기반한 일관성 있고 근거 기반의 코드 리뷰 및 아키텍처 감사를 원하는 소프트웨어 엔지니어와 아키텍트를 위한 도구입니다.

주요 기능

• 서적 기반 분석: 모든 발견이 12권의 고전적 소프트웨어 공학 서적 중 하나에 근거합니다.
• 6가지 생산 부패 위험: 인지적 과부하, 변경 전파, 종속성 혼란과 같은 문제를 진단합니다.
• 아키텍처 감사: Mermaid 종속성 그래프를 생성하여 모듈 간 관계를 시각화하고 순환 종속성을 식별합니다.
• 다중 플랫폼 지원: Claude Code, Cursor, Windsurf, GitHub Copilot 등 다양한 AI 코딩 어시스턴트에서 "에이전트 기술"로 통합 가능합니다.
• 포괄적인 도구 세트: 기술적 부채 로드맵 작성(/brooks-debt), 테스트 스위트 감사(/brooks-test), 자동 수정(/brooks-sweep)을 위한 전용 명령어를 포함합니다.