analyze

Analyze — 프로젝트 심층 분석 파이프라인

$ARGUMENTS 에 대해 코드베이스를 탐색하고, 외부 리서치를 수행한 뒤, 종합 분석 보고서를 MD 파일로 출력한다.

SCAN → RESEARCH → ANALYZE → REPORT

적용 범위: 기존 코드베이스(브라운필드) 전용. 이 스킬의 SCAN은 package.json·기존 소스·아키텍처·기술부채를 감사한다. 코드가 전무한 그린필드 프로젝트에는 사용하지 않는다 — 그 경우 요구사항·리서치로부터 범위·스택을 확정하는 워크플로우(예: scope 스킬이 설치돼 있으면 활용)를 사용한다.

---

Phase 1: SCAN — 코드베이스 전체 탐색

1-1. 기본 컨텍스트 수집

Read 도구로 아래를 병렬 수집한다:

• CLAUDE.md — 기술 스택, 구조, 규칙
• package.json (또는 해당 언어의 의존성 파일) — 의존성 목록
• 프로젝트 히스토리 문서 — 존재하면 로드 (예: docs/, CHANGELOG.md, ADR 등에 기록된 기술 결정사항·알려진 이슈)
• README.md — 프로젝트 설명, 현재 문서 상태

1-2. 에이전트 병렬 탐색

Task 도구로 아래 3개 에이전트를 동시에 실행한다:

Agent A: 구조 탐색 (Explore, thoroughness: "very thorough")

프롬프트:

프로젝트의 전체 구조를 분석하라:
1. 디렉토리 트리 및 파일 구성
2. 진입점(entry point) 식별
3. 주요 모듈/컴포넌트 목록
4. 설정 파일 (빌드, 린트, 테스트 등) 현황
5. 의존성 패키지 분류 (core / UI / 유틸리티 / dev)
코드를 수정하지 말고 탐색 결과만 반환하라.

Agent B: 아키텍처 분석 (feature-dev:code-explorer)

프롬프트:

프로젝트의 아키텍처를 심층 분석하라:
1. 레이어 구조 (데이터 / 비즈니스 로직 / UI)
2. 상태 관리 패턴
3. 데이터 흐름 (입력 → 처리 → 출력)
4. 사용된 디자인 패턴 식별
5. 모듈 간 의존성 그래프 (주요 import 관계)
6. 추상화 수준 평가
코드를 수정하지 말고 분석 결과만 반환하라.

Agent C: 코드 품질 리뷰 (feature-dev:code-reviewer)

프롬프트:

프로젝트 전체 코드 품질을 리뷰하라:
1. 보안 취약점 (OWASP Top 10 기준)
2. 성능 병목 가능 지점
3. 기술 부채 식별 (하드코딩, 중복 코드, TODO/FIXME 등)
4. 테스트 커버리지 현황
5. 에러 핸들링 패턴 일관성
6. 프로젝트 컨벤션 준수도
confidence HIGH 이슈만 보고하라. 코드를 수정하지 말고 리뷰 결과만 반환하라.

---

Phase 2: RESEARCH — 외부 리서치

2-0. 기존 팀 리서치 결과 확인

docs/research/RESEARCH-*.md 파일이 존재하는지 Glob으로 탐색한다:

상황	동작
RESEARCH 파일 존재	Read로 로드 → 이미 조사된 항목 확인 → 해당 항목은 2-1, 2-2에서 생략
RESEARCH 파일 없음	2-1, 2-2를 전체 수행

사전 리서치 결과(docs/research/RESEARCH-*.md)가 이미 있으면(예: team-research 스킬이 설치돼 있어 미리 조사를 돌렸다면), 중복 조사를 방지하기 위해 이 단계를 자동 적용한다.

2-1. 기술 스택 리서치

Phase 1에서 파악한 핵심 기술 스택(상위 3~5개) 중 2-0에서 확인되지 않은 항목에 대해:

도구	조회 내용
Context7	각 라이브러리의 최신 버전, 주요 변경사항, 권장 패턴
WebSearch	해당 기술의 트렌드, 커뮤니티 평가, 대안 기술 비교