brooks-lint은(는) 무엇을 하나요?
10가지 고전 공학 서적에 기반한 AI 코드 리뷰 — 서적 인용, 심각도 레이블, 4가지 분석 모드를 갖춘 부패 위험 진단
개요
brooks-lint는 10권의 고전 공학 서적에서 추출한 원칙을 사용하여 코드 리뷰를 수행하는 AI 에이전트 스킬입니다. 단순한 문법 검사기나 린터가 아니라, 코드베이스의 장기적인 부패(decay) 위험을 진단하고 각 문제에 대해 권위 있는 공학 서적의 인용문을 제공합니다. 문제에는 심각도 레이블(경고, 위험, 심각)이 지정되며, 4가지 분석 모드(빠른 검사, 심층 검사, 보안 검사, 성능 검사) 중 하나를 선택하여 실행할 수 있습니다.
지원 플랫폼
- Claude Code:
CLAUDE.md또는 프로젝트 설정에 추가 - Cursor:
.cursorrules또는 규칙 설정에 추가 - Codex:
CODEX.md또는 에이전트 구성에 추가 - 기타 AI 코딩 도구: 유사한 규칙/프롬프트 구성 방식으로 통합 가능
설치
프로젝트 루트에 다음 파일 중 하나를 생성하고, 이 스킬의 내용을 복사하여 붙여넣으세요.
CLAUDE.md(Claude Code).cursorrules(Cursor)CODEX.md(Codex)
직접 사용
# Claude Code
claude "이 저장소의 brooks-lint를 사용하여 리뷰해줘"
# Cursor
# Cmd+I로 AI 채팅 열고 "brooks-lint로 분석해줘" 입력
분석 모드
| 모드 | 설명 | 적합한 상황 |
|---|---|---|
| 빠른 검사 | 5초 이내, 표면적인 문제와 명백한 코드 냄새 검출 | 커밋 전 빠른 점검 |
| 심층 검사 | 30초~2분, 아키텍처 및 설계 원칙 준수 여부 확인 | PR 리뷰 |
| 보안 검사 | 일반적인 취약점 패턴 및 안전하지 않은 코딩 관행 식별 | 배포 전 점검 |
| 성능 검사 | 알고리즘 복잡도 및 잠재적 병목 지점 분석 | 최적화 작업 |
참고 서적 목록
- The Mythical Man-Month - Frederick P. Brooks Jr.
- Design Patterns: Elements of Reusable Object-Oriented Software - Gang of Four
- Refactoring: Improving the Design of Existing Code - Martin Fowler
- Clean Code - Robert C. Martin
- Code Complete - Steve McConnell
- The Pragmatic Programmer - Andrew Hunt & David Thomas
- Structure and Interpretation of Computer Programs - Abelson & Sussman
- Introduction to Algorithms - CLRS
- The Art of Computer Programming - Donald Knuth
- Working Effectively with Legacy Code - Michael Feathers
사용 예시
빠른 검사 모드
프롬프트:
브룩스 린트: 빠른 검사 모드로 다음 파일을 분석해줘
응답 예시:
📋 **브룩스 린트 분석 결과** (빠른 검사 모드)
파일: src/app.ts
⚠️ [경고] 과도하게 긴 함수 (45줄)
- 출처: *Clean Code*, p. 34 - "함수는 하나의 일만 해야 한다."
🔴 [위험] 매직 넘버 사용
- 출처: *Code Complete*, p. 357 - "매직 넘버는 명명된 상수로 대체하라."
🟢 2개의 문제 발견 (경고 1, 위험 1)
라이선스
MIT