Agent skill · research science · aiskillstore
analyze
기존 코드베이스(브라운필드)를 탐색·감사하고 외부 리서치를 더해 분석 보고서(MD)를 생성한다. 아키텍처·기술부채·보안·성능·개선 로드맵 도출. '/analyze', '분석해줘', '프로젝트 분석', '코드베이스 분석', '기술부채 점검' 등 기존 코드가 있는 프로젝트 언급 시 호출. 코드가 전무한 그린필드 신규 프로젝트에는 사용하지 않는다.
Why this skill is useful
Adds a comprehensive analysis pipeline with executable steps for codebase exploration, external research, and report generation that aren't available in public documentation.
What it needs
Requires bash installed locally. About 5k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Analyze — 프로젝트 심층 분석 파이프라인 $ARGUMENTS 에 대해 코드베이스를 탐색하고, 외부 리서치를 수행한 뒤, 종합 분석 보고서를 MD 파일로 출력한다. 적용 범위: 기존 코드베이스(브라운필드) 전용. 이 스킬의 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") 프롬프트: Agent B: 아키텍처 분석 (feature-dev:code-explorer) 프롬프트: Agent C: 코드 품질 리뷰 (feature-dev:code-reviewer) 프롬프트: --- 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 해당 기술의 트렌드, 커뮤니티 평가, 대안 기술 비교 2-2. 프로젝트 유형 리서치 프로젝트의 도메인/유형에 맞는 리서치 중 2-0에서 확인되지 않은 항목에 대해: 도구 조회 내용 --- --- WebSearch 동종 프로젝트의 UX 트렌드, 경쟁 제품 기능 비교 WebSearch 해당 도메인의 모범 사례(best practices) 리서치는 핵심 기술 3~5개 + 도메인 트렌드 1~2건으로 제한한다 (과도한 조회 방지). RESEARCH 파일에서 이미 다룬 항목은 카운트에서 제외한다. --- Phase 3: ANALYZE — 종합 분석 Phase 1~2 결과를 종합해 아래 항목을 도출한다: 3-1. 프로젝트 현황 요약 프로젝트 목적 및 핵심 가치 현재 완성도 (기능별 구현 상태) 기술 스택 적합성 평가 3-2. 아키텍처 평가 강점 (잘 설계된 부분) 약점 (개선 필요 부분) 패턴 일관성 점수 (높음/보통/낮음) 3-3. 기술 부채 & 리스크 식별된 기술 부채 목록 (심각도 순) 보안 리스크 성능 리스크 유지보수 리스크 3-4. 개선 로드맵 즉시 개선 (Quick Win) — 적은 노력으로 큰 효과 단기 개선 (1~2주) — 구조적 개선 중장기 개선 (1개월+) — 아키텍처 리팩터링 3-5. 기술 트렌드 대비 현재 스택 vs 최신 트렌드 비교 마이그레이션/업그레이드 권장 사항 대안 기술 검토 결과 --- Phase 4: REPORT — 보고서 출력 4-1. 보고서 생성 Write 도구로 아래 경로에 MD 파일을 생성한다: 1. {프로젝트 루트}/docs/analysis/ 폴더가 없으면 Bash로 mkdir -p 생성 2. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/analyze