fireauto-lsp-guide

LSP 우선 사용 가이드

LSP(Language Server Protocol) 도구가 활성화되어 있으면, 코드 탐색 시 Grep/Glob 대신 LSP를 먼저 사용하세요.

핵심 원칙

코드를 찾을 때 이 순서를 따르세요:

1. LSP (가장 빠르고 정확) → 정의, 참조, 심볼, 호출 계층
2. Glob/Grep (LSP로 안 되는 경우) → 파일 패턴 검색, 텍스트 검색
3. Read (내용 확인) → LSP로 위치를 찾은 후 해당 파일 읽기

LSP 도구 활용 매핑

사용자가 이렇게 말하면	LSP 연산	설명
"이 함수 어디에 정의돼있어?"	goToDefinition	심볼이 선언된 위치로 이동
"이거 어디서 쓰이고 있어?"	findReferences	모든 참조 위치를 찾음
"이 타입이 뭐야?"	hover	타입 정보, 문서 표시
"이 파일에 뭐가 있어?"	documentSymbol	파일 내 모든 함수/클래스/변수 목록
"프로젝트에서 OO 찾아줘"	workspaceSymbol	워크스페이스 전체 심볼 검색
"이 인터페이스 구현체 찾아줘"	goToImplementation	인터페이스/추상 메서드의 구현체
"이 함수를 누가 호출해?"	incomingCalls	이 함수를 호출하는 모든 곳
"이 함수가 뭘 호출해?"	outgoingCalls	이 함수가 호출하는 모든 것

실전 패턴

버그 수정 요청

사용자: "결제 로직에 버그가 있어"

1. workspaceSymbol → "payment", "checkout" 등으로 관련 심볼 검색
2. goToDefinition → 핵심 함수 위치 확인
3. incomingCalls → 어디서 호출되는지 추적
4. findReferences → 관련 타입/변수가 어디서 쓰이는지 파악
5. Read → 찾은 파일의 실제 코드 확인 후 수정

리팩토링 요청

사용자: "PaymentProvider 인터페이스 수정해줘"

1. goToDefinition → 인터페이스 정의 위치
2. goToImplementation → 모든 구현체 (Lemon, Paddle, Toss)
3. findReferences → 인터페이스를 사용하는 모든 곳
4. 영향 범위 파악 후 안전하게 수정

코드 이해 요청

사용자: "이 프로젝트 구조 설명해줘"

1. documentSymbol → 주요 파일들의 심볼 목록
2. workspaceSymbol → 핵심 타입/함수 전체 조회
3. incomingCalls/outgoingCalls → 호출 흐름 파악

주의사항

• LSP는 코드 구조 탐색에 최적화돼 있어요. 문자열 검색(에러 메시지, 설정값 등)은 여전히 Grep이 나아요.
• LSP 서버가 없는 언어 파일은 자동으로 Grep/Glob으로 폴백하세요.
• line과 character는 1-based (1부터 시작)예요.