5 minutes
How to 대규모 코드베이스 이해하기 with Eigent
첫 번째 수정을 하기 전에 요청 흐름을 추적하고, 낯선 모듈을 파악하며, 적절한 파일을 빠르게 찾아보세요.
What you need
- Eigent 데스크톱 앱
- 코드베이스 접근 권한(로컬 또는 연결된 저장소)
Best for
- 저장소나 서비스에 온보딩하는 신규 엔지니어
- 코드를 변경하기 전에 기능이 어떻게 동작하는지 이해하려는 사람
- 협업 전에 새 코드베이스를 검토하는 테크 리드
Starter Prompt
코드베이스에서 [시스템 영역 이름]을(를) 통해 요청이 어떻게 흐르는지 설명하세요. 다음 내용을 포함하세요: - 어떤 모듈이 무엇을 담당하는지 - 데이터가 어디서 검증되는지 - 변경하기 전에 주의해야 할 주요 함정 마지막에는 다음에 읽어야 할 파일로 끝내세요.
작동 방식
- 이해하고 싶은 관련 파일, 디렉터리 또는 기능 영역을 Eigent에 제공하세요.
- 요청 흐름을 추적하고 어떤 모듈이 비즈니스 로직, 전송, 저장소, UI를 담당하는지 설명해 달라고 요청하세요.
- 편집하기 전에 검증, 부작용, 상태 전환이 어디에서 발생하는지 물어보세요.
- 마지막으로 다음에 어떤 파일을 읽어야 하는지와 위험한 부분이 무엇인지 물어보세요.
더 시도해 볼 프롬프트
- 실제 비즈니스 로직과 전송 계층 또는 UI 계층을 각각 어떤 모듈이 담당하나요?
- 검증은 어디에서 이루어지며, 어떤 가정이 그곳에서 강제되나요?
- 이 흐름을 변경할 때 놓치기 쉬운 관련 파일이나 백그라운드 작업은 무엇인가요?
- 이 영역을 편집한 후 어떤 테스트나 점검을 실행해야 하나요?
- 이 저장소를 설명해 주세요 — 본격적으로 들어가기 전에 전체적인 지도를 보여 주세요.
사용 방법
코드베이스가 연결된 상태로 Eigent를 여세요. 처음이라면 넓게 시작해 보세요("이 저장소를 설명해 주세요"), 그런 다음 변경해야 하는 구체적인 영역으로 좁히세요. 요청 범위를 더 명확하게 할수록 — 기능 이름, 디렉터리, 요청 경로처럼 — 설명은 더 구체적이 됩니다. 설명이 첫 수정을 해도 될 만큼 충분히 구체적이라고 느껴질 때까지 후속 질문을 계속하세요.
예상 결과
어떤 코드가 무엇을 담당하는지 보여 주는 구체적인 모듈 지도, 추적된 요청 흐름, 핵심 검증 지점, 위험하거나 놓치기 쉬운 영역 목록, 그리고 변경하기 전에 검토해야 할 다음 파일들의 읽기 목록입니다.
제한 사항
- 전체 저장소에 대해 한 번에 묻기보다, 특정 영역으로 범위를 좁혔을 때 가장 잘 작동합니다.
- 매우 큰 모노레포는 먼저 단일 서비스나 패키지로 범위를 좁히는 것이 좋습니다.
- Eigent는 연결된 코드베이스에 있는 내용만 읽을 수 있으며, 관찰하지 못한 런타임 동작에 대해서는 추론할 수 없습니다.
Related workflows
코드베이스 리팩터링하기
동작은 바꾸지 않으면서 죽은 코드를 제거하고 레거시 패턴을 현대화하세요 — 작고 검토 가능한 단계로 진행합니다.
코드 마이그레이션 실행
레거시 스택을 통제된 체크포인트 단위로 마이그레이션하세요 — 기존 시스템을 새 시스템에 매핑하고, 전환을 마일스톤별로 진행하며, 각 전환 전에 패리티를 검증합니다.
워크플로를 스킬로 저장하기
작동 중인 Eigent 스레드, 리뷰 규칙, 테스트 명령, 릴리스 체크리스트를 팀원이 이후 세션에서 호출할 수 있는 재사용 가능한 스킬로 바꾸세요.