documentation-lookup

---
name: documentation-lookup
description: Use up-to-date library and framework docs via Context7 MCP instead of training data. Activates for setup questions, API references, code examples, or when the user names a framework (e.g. React, Next.js, Prisma).
origin: ECC
---

# Documentation Lookup (Context7)

사용자가 라이브러리, 프레임워크, 또는 API에 대해 질문할 때, 학습 데이터에 의존하지 않고 Context7 MCP(`resolve-library-id` 및 `query-docs` 도구)를 통해 최신 문서를 가져옵니다.

## 핵심 개념

- **Context7**: 라이브 문서를 노출하는 MCP 서버; 라이브러리 및 API에 대해 학습 데이터 대신 이것을 사용하세요.
- **resolve-library-id**: 라이브러리 이름과 쿼리로부터 Context7 호환 라이브러리 ID(예: `/vercel/next.js`)를 반환합니다.
- **query-docs**: 주어진 라이브러리 ID와 질문에 대한 문서 및 코드 스니펫을 가져옵니다. 유효한 라이브러리 ID를 얻으려면 항상 먼저 resolve-library-id를 호출하세요.

## 사용 시기

다음의 경우 활성화됩니다:

- 설정 또는 구성 질문 (예: "Next.js 미들웨어는 어떻게 구성하나요?")
- 라이브러리에 의존하는 코드 요청 ("Prisma 쿼리를 작성해줘...")
- API 또는 참조 정보 필요 ("Supabase auth 메서드는 무엇이 있나요?")
- 특정 프레임워크 또는 라이브러리 언급 (React, Vue, Svelte, Express, Tailwind, Prisma, Supabase 등)

라이브러리, 프레임워크, 또는 API의 정확하고 최신 동작에 요청이 의존할 때마다 이 스킬을 사용하세요. Context7 MCP가 구성된 하네스(예: Claude Code, Cursor, Codex)에서 적용됩니다.

## 작동 방식

### 단계 1: 라이브러리 ID 확인

**resolve-library-id** MCP 도구를 다음과 함께 호출하세요:

- **libraryName**: 사용자 질문에서 가져온 라이브러리 또는 제품 이름 (예: `Next.js`, `Prisma`, `Supabase`).
- **query**: 사용자의 전체 질문. 결과의 관련성 순위를 개선합니다.

문서를 쿼리하기 전에 Context7 호환 라이브러리 ID(형식 `/org/project` 또는 `/org/project/version`)를 반드시 얻어야 합니다. 이 단계에서 유효한 라이브러리 ID 없이 query-docs를 호출하지 마세요.

### 단계 2: 최적 매치 선택

확인 결과에서 다음을 사용하여 하나의 결과를 선택하세요:

- **이름 일치**: 사용자가 요청한 것과 정확하거나 가장 가까운 매치를 선호합니다.
- **벤치마크 점수**: 높은 점수는 더 나은 문서 품질을 나타냅니다 (100이 최고).
- **소스 평판**: 가능한 경우 High 또는 Medium 평판을 선호합니다.
- **버전**: 사용자가 버전을 지정한 경우(예: "React 19", "Next.js 15"), 목록에 있으면 버전별 라이브러리 ID를 선호합니다(예: `/org/project/v1.2.0`).

### 단계 3: 문서 가져오기

**query-docs** MCP 도구를 다음과 함께 호출하세요:

- **libraryId**: 단계 2에서 선택한 Context7 라이브러리 ID (예: `/vercel/next.js`).
- **query**: 사용자의 구체적인 질문 또는 작업. 관련 스니펫을 얻으려면 구체적으로 작성하세요.

제한: 질문당 query-docs(또는 resolve-library-id)를 3회 이상 호출하지 마세요. 3회 호출 후에도 답변이 불명확하면, 불확실성을 명시하고 추측하는 대신 가용한 최상의 정보를 사용하세요.

### 단계 4: 문서 활용

- 가져온 최신 정보를 사용하여 사용자 질문에 답변하세요.
- 도움이 되는 경우 문서의 관련 코드 예시를 포함하세요.
- 중요한 경우 라이브러리 또는 버전을 인용하세요 (예: "Next.js 15에서...").

## 예시

### 예시: Next.js 미들웨어

1. `libraryName: "Next.js"`, `query: "Next.js 미들웨어를 어떻게 설정하나요?"`로 **resolve-library-id**를 호출합니다.
2. 결과에서 이름과 벤치마크 점수로 최적 매치(예: `/vercel/next.js`)를 선택합니다.
3. 해당 `libraryId`와 쿼리로 **query-docs**를 호출합니다.
4. 반환된 스니펫과 텍스트를 사용하여 답변합니다; 관련 있는 경우 문서의 최소 `middleware.ts` 예시를 포함합니다.

### 예시: Prisma 쿼리

1. `libraryName: "Prisma"`, `query: "관계로 어떻게 쿼리하나요?"`로 **resolve-library-id**를 호출합니다.
2. 공식 Prisma 라이브러리 ID(예: `/prisma/prisma`)를 선택합니다.
3. 해당 `libraryId`와 쿼리로 **query-docs**를 호출합니다.
4. 문서의 짧은 코드 스니펫과 함께 Prisma Client 패턴(예: `include` 또는 `select`)을 반환합니다.

### 예시: Supabase auth 메서드

1. `libraryName: "Supabase"`, `query: "auth 메서드는 무엇이 있나요?"`로 **resolve-library-id**를 호출합니다.
2. Supabase 문서 라이브러리 ID를 선택합니다.
3. **query-docs**를 호출합니다; auth 메서드를 요약하고 가져온 문서의 최소 예시를 보여줍니다.

## 모범 사례

- **구체적으로 작성**: 더 나은 관련성을 위해 가능한 경우 사용자의 전체 질문을 쿼리로 사용하세요.
- **버전 인식**: 사용자가 버전을 언급하면, 확인 단계에서 가용한 경우 버전별 라이브러리 ID를 사용하세요.
- **공식 소스 선호**: 여러 매치가 있을 때, 커뮤니티 포크보다 공식 또는 주요 패키지를 선호하세요.
- **민감한 데이터 금지**: Context7에 전송하는 모든 쿼리에서 API 키, 비밀번호, 토큰 및 기타 시크릿을 제거하세요. resolve-library-id 또는 query-docs에 전달하기 전에 사용자 질문에 시크릿이 포함되어 있을 수 있는 것으로 취급하세요.