Community코딩 & 개발github.com

Dev-PGVAA/스킬

리포지토리에서 동작이 어디에 있는지 설명하고, 증거 기반 아키텍처 맵을 생성하거나 갱신하며, Mermaid나 draw.io로 실제 컴포넌트 관계를 그립니다. 리포지토리 방향 탐색과 아키텍처 다이어그램에 사용됩니다.

스킬란 무엇인가요?

이 스킬은 개발자와 AI 에이전트가 대규모 리포지토리에서 필요한 코드를 신속하게 찾고, 아키텍처를 문서화하며, 시각적 다이어그램을 생성할 수 있도록 설계되었습니다. 주요 기능은 세 가지로 나뉩니다: (1) 'X는 어디에 있나요?' 같은 빠른 방향 탐색은 기존 맵을 읽어 진입점을 제시하고, (2) 지속적인 아키텍처 맵 생성/갱신은 `orient` 참조를 따라 기존 문서 레이아웃을 보존하며, (3) 아키텍처 시각화는 `diagram` 참조를 통해 Mermaid나 draw.io 포맷으로 컴포넌트 관계를 그림니다. 대규모 리포지토리에서는 독립적인 영역(예: API/auth, workers/data)을 병렬로 탐색하여 성능을 최적화하며, 각 탐색은 읽기 전용으로 실제 경로와 심볼, 진입점, 종속성 증거를 반환합니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 도구와 호환되며, 증거 기반의 완료 조건(검사한 내용과 알려지지 않은 내용 기록)과 검증된 로컬 링크 및 다이어그램 문법을 강조합니다. 최종 답변은 핵심을 먼저 말하고, 불필요한 서문이나 잡담 없이 간결하게 전달합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Dev-PGVAA/skills/tree/HEAD/codebase-map

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

코드베이스 맵

사용자 작업에 필요한 코드를 찾고, 요청 시 유용한 방향 정보를 보존합니다. 소스 증거, 선언된 구성, 관찰된 런타임 동작을 구분합니다.

요청된 결과물에 따라 경로 선택

  • X는 어디에 있나요? / 빠른 방향 탐색: 관련 기존 맵을 읽고 그 경로를 체크아웃 내용과 비교하여 확인합니다. 짧은 흐름과 진입점 링크로 답변하며, 문서 작성을 필요로 하지 않습니다.
  • 지속적 맵 생성 / 갱신: orient를 사용합니다. 기존 문서 레이아웃과 로컬 지침을 보존합니다.
  • 아키텍처 시각화: diagram을 사용합니다. 다이어그램은 전체 문서 모음을 생성하지 않고도 집중된 소스 패스로 만들 수 있습니다.

병렬 탐색

대규모 리포지토리의 경우, 독립적인 경계 영역(예: API/auth, workers/data, UI/navigation)을 위임합니다. 각 스카웃은 읽기 전용이며 실제 경로/심볼, 진입점, 증거가 포함된 종속성, 불확실성, 검사한 정확한 리비전을 반환합니다. 모든 스카웃이 전체 트리를 스캔하도록 요청하지 마십시오.

부모는 인덱스, 공유 문서, 교차 영역 연결을 소유합니다. 쓰기 전에 경계 주장을 검증하고, 중복을 제거하며, 일관되지 않은 이름을 조정합니다. 에이전트를 사용할 수 없거나 범위가 작은 경우, 동일한 집중 탐색을 순차적으로 수행합니다. 위임은 작업을 절약할 때만 유용하며, 파일당 하나의 에이전트를 생성하지 마십시오.

증거 및 완료

패키지가 존재한다고 해서 프로덕션에서 실행 중임을 증명하지 않으며, 임포트가 네트워크 배포를 증명하지 않습니다. 검사한 내용과 알려지지 않은 내용을 기록합니다. 제공된 모든 로컬 링크와 다이어그램 소스 문법을 사용 가능한 도구로 검증합니다. 실제 검증 결과와 최상의 시작 파일을 보고하며, 전체 리포지토리 목록을 제공하지 않습니다.

답변의 어조

핵심을 먼저 말합니다. 단계적인 시작, "X가 아니라 Y", 채팅 잔여물, 중요성 부풀리기를 하지 않습니다. 긴 문장 옆에 짧은 문장을 배치합니다. 사실과 한정어는 증거만큼 강력하게 유지합니다.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

관련 스킬