meng shao(@shao__meng)의 스레드

[실용 가이드] 커서를 사용하여 익숙하지 않은 코드베이스를 효율적으로 이해하는 방법: 구조화된 워크플로 및 다양한 모드와 모델 간 전환을 통해 복잡한 코드베이스를 쉽게 이해할 수 있는 문서로 분해 핵심 목표는 AI를 활용하여 새로운 프로젝트의 코드 아키텍처, 기술 스택, 비즈니스 로직을 빠르고 심층적으로 이해하고 반복적으로 참조할 수 있는 문서를 생성하는 것입니다. 자세한 워크플로 분석에서는 코드를 이해하는 과정을 7가지 명확한 단계로 구분합니다. 이를 요약하면 다음과 같습니다. 1. 보안 탐색 및 글로벌 스캔(준비 단계) "질문 모드" 활성화: • 작동: 커서를 질문 모드로 전환합니다. 목적: 탐색 중에 실수로 코드가 수정되는 것을 방지하고 코드베이스의 보안을 보장하기 위한 읽기 전용 모드입니다. 빠른 검색: • 작업: 더 빠른 모델인 Composer 1을 선택하여 전체 코드베이스와 주요 하위 폴더를 스캔(grep)합니다. • 목표: AI가 빠른 스캐닝을 통해 프로젝트에 대한 예비적이고 거시적인 이해를 얻을 수 있도록 합니다. 2. 학습 청사진 개발(계획 단계) 이해 계획을 생성하세요: • 작동: 계획 모드로 전환합니다. • 지침: AI에게 "코드베이스를 이해하는 방법"에 대한 계획을 세우도록 요구합니다. • 콘텐츠 중심: 기술 통합(Resend 및 AI SDK와 같은 타사 라이브러리 등)부터 시작하여 점차적으로 파일 디렉토리 구조로 전환합니다. • 목표: 코드를 맹목적으로 읽는 대신 AI가 논리적으로 명확한 학습 경로를 계획하도록 돕습니다. 3. 자동 문서 생성(실행 단계) 깊이 인덱싱 및 분해: • 작업: 이전 단계의 계획을 마크다운 파일로 저장하고, 에이전트 모드로 전환하고, 강력한 모델을 선택합니다. • 명령: 에이전트에게 전체 데이터베이스를 인덱싱하고 코드베이스를 여러 개의 마크다운 문서로 분해하도록 지시합니다. 문서 범주: • 프런트엔드(Frontend Architecture) • 백엔드(백엔드 아키텍처) • 사용자 여정(비즈니스 프로세스) • 기술적 분석 4. 시각 지원(고급 단계) 복잡한 아키텍처 다이어그램: • 시나리오: 프로젝트에 Redis나 마이크로서비스와 같은 복잡한 구성 요소가 포함되어 있는 경우 간단한 텍스트 설명만으로는 직관적이지 않습니다. • 작업: 클로드 모델로 돌아갑니다. • 목표: 클로드의 강력한 상황적 이해 능력을 활용하여 제품 워크플로의 아키텍처 다이어그램이나 흐름도를 생성하고 시각적 이해를 돕습니다. 5. 검토 및 반복(내재화 단계) 독서 및 Q&A: • 작업: 생성된 문서를 읽으려면 미리 보기 모드로 전환합니다. • 루프: 이해가 되지 않는 세부 사항이 있으면 질문 모드로 전환하여 AI에게 도움을 요청할 수 있습니다. • 반복: 기본적인 인지 프레임워크가 확립될 때까지 이 과정을 여러 번 반복합니다. 💡 핵심 요점: "나쁜 펜은 좋은 기억력보다 나쁘다" — 과정 내내 수동적으로 읽기만 하지 마세요. 두 가지 메모 습관을 기르는 것을 강조하세요. • 엔지니어링 구현 참고 사항: 특정 기능이 구현되는 방식에 대한 논리를 간략하게 기록한 것입니다. • 주요 파일 이름: 나중에 쉽게 찾을 수 있도록 핵심 워크플로에 관련된 중요한 파일의 이름을 기록해 둡니다. 이 접근법의 핵심은 "분할 정복"과 "읽는 대신 쓰기"에 있습니다. 코드의 바다에 직접 뛰어드는 대신, 먼저 AI의 계획 기능을 사용하여 계획을 생성하고, 그다음 AI의 실행 기능을 사용하여 지침을 생성한 후, 마지막으로 목표 다이어그램을 통해 어려움을 해결합니다.