# task-1439.1 완료 보고서: 린터 패턴 주기적 업데이트 프로세스 구축

**S**: 모듈화 린터(`modularity-lint.sh`)가 4가지 패턴(ChatID, 절대경로, 폰트사이즈, 팀명)만 감지하며, 새로운 하드코딩 패턴 추가 시 lint.sh를 직접 수정해야 한다.

**C**: 코드베이스가 성장하면서 API URL(63곳), 색상코드(140곳), 매직넘버(73곳) 등 새로운 종류의 하드코딩이 발견되었으나, 이를 자동으로 식별하고 린터에 추가하는 프로세스가 없다.

**Q**: 새로운 하드코딩 패턴을 자동 발견하고, lint.sh 수정 없이 JSON만으로 패턴을 추가할 수 있는 구조를 구축할 수 있는가?

**A**: 3가지 개선을 완료하여 패턴 자동 발견 → JSON 기반 추가 → lint 자동 반영 파이프라인을 구축했다. discover 커맨드로 68개 하드코딩 후보(1802회 등장)를 자동 식별하였고, lint.sh는 lint-patterns.json에서 패턴을 동적 로딩하도록 리팩토링되었다.

## 산출물

- `/home/jay/workspace/tools/modularity-check.py` — discover 서브커맨드 추가 (557~777행)
- `/home/jay/workspace/config/lint-patterns.json` — 신규 생성 (4패턴 정의)
- `/home/jay/workspace/hooks/modularity-lint.sh` — JSON 기반 패턴 로딩으로 리팩토링
- `/home/jay/workspace/memory/specs/modularity-maintenance.md` — 월간 유지보수 프로세스 문서

## 주요 구현 내용

### 1. modularity-check.py discover 커맨드
- 5개 카테고리 자동 식별: API URL, 포트번호, 매직넘버, 색상코드, 이메일/도메인
- 기존 헬퍼 함수 재사용 (주석/noqa/docstring 제외)
- lint-patterns.json 등록 패턴과 중복 자동 제외
- `--min-occurrences N` (기본 3), `--json` 옵션 지원
- 노이즈 필터: HTTP 상태코드, CSS 브레이크포인트, 연도, 흔한 정수 60개+ 제외

### 2. hooks/modularity-lint.sh JSON 기반 개선
- `jq`로 `config/lint-patterns.json` 동적 로딩
- jq 미설치 또는 JSON 파일 부재 시 기존 하드코딩 패턴 fallback (하위호환 100%)
- `file_has_import()` 범용 함수로 일반화 (skip_if_import 지원)
- 기존 개별 패턴 검사 → 반복문 기반 동적 검사로 리팩토링

### 3. modularity-maintenance.md 유지보수 문서
- 월간 스캔 프로세스: discover → 검토 → JSON 추가 → 검증
- 패턴 추가/제외 기준 명시

## 검증 결과

- `discover` 실행: 68 후보, 1802회 등장 (min-occurrences=10 기준)
- `scan --json` 기존 동작: FAIL 816건, WARN 1290건 (기존과 동일)
- `bash -n modularity-lint.sh`: 문법 검사 통과
- fallback 구조: jq 의존성 없이도 기존 동작 보장

## 발견 이슈 및 해결

### 자체 해결 (3건)
1. **매직넘버 노이즈 과다** — 4자리 이상 정수만 감지 + _COMMON_NUMBERS 60개+ 제외 목록으로 해결
2. **lint.sh에서 file_types 파싱** — jq로 배열을 쉼표 join하여 bash에서 IFS 분할 처리
3. **discover가 이미 등록된 패턴 중복 보고** — `_load_lint_patterns_values()`로 lint-patterns.json 등록값 제외

### 범위 외 미해결 (1건)
1. **월간 자동 실행 스케줄** — cron 등록은 운영팀 소관. 문서에 실행 방법 명시 완료

## 모델 사용 기록

- 불칸 / discover 커맨드 + lint-patterns.json 구현 / sonnet / -
- 불칸 / modularity-lint.sh JSON 기반 리팩토링 / sonnet / -