AI가 만든 코드 이해하기: 레포지터리를 읽는 순서
code-fix.dev ·
파일이 많은 레포지터리에서 실행 방법, 진입점, 데이터 흐름을 찾고 수정할 위치를 좁히는 방법을 설명합니다.
README와 실행 설정부터 읽으세요
모든 파일을 처음부터 읽을 필요는 없습니다. README에서 프로젝트 목적과 실행 방법을 확인하고 package.json 같은 설정 파일에서 실제 명령을 찾습니다. 예시 환경 변수 파일은 이름과 용도를 파악하는 데 쓰고, 실제 비밀키가 든 파일은 공유하지 않습니다.
화면 하나를 골라 진입점을 찾으세요
고치려는 페이지의 URL이나 화면 문구를 저장소에서 검색합니다. 그 화면을 만드는 파일에서 버튼 이벤트, 호출 함수, API 요청으로 이어지는 경로를 따라갑니다. 프레임워크마다 파일 규칙이 다르므로 파일 이름만으로 역할을 확정하지 않습니다.
입력부터 저장까지 데이터 흐름을 그리세요
예를 들어 “폼 입력 → 검증 → API 요청 → 서버 처리 → 데이터베이스 → 응답 → 화면 갱신”을 적습니다. 각 단계 옆에 확인한 파일 이름을 붙이면 어디까지 이해했고 어디가 불확실한지 드러납니다. UI 파일만 수정해서는 서버의 권한 오류가 해결되지 않을 수 있습니다.
AI의 설명을 코드와 대조하세요
AI에게 폴더 요약만 요청하기보다 특정 버튼을 눌렀을 때 실행되는 함수와 파일 근거를 요청합니다. 설명에 등장한 함수가 실제로 존재하는지, 호출되는지 직접 확인하세요. 추측과 확인된 사실을 나눠 달라고 요청하면 다음 조사 지점을 정하기 쉽습니다.
수정 범위를 한 문장으로 정하세요
“전체 구조 개선” 대신 “로그인 응답 후 이동 경로를 수정한다”처럼 목표를 좁힙니다. 수정 전에 현재 동작을 기록하고 별도 브랜치에서 검증합니다. 구조를 읽기 어렵다면 저장소 링크와 이해하고 싶은 기능을 함께 보내 사전 분석을 예약할 수 있습니다.