큰 코드베이스에서 Cursor가 코드를 망가뜨리지 않게 하는 방법
파일이 500개가 넘는 큰 에서 Cursor를 쓰면, 서로 연결된 부분을 충분히 보지 못한 채 코드를 고쳐 문제가 생길 수 있다. 함수 하나를 정리하다가 그 함수를 쓰는 다른 모듈 3곳이 깨지는 식이다.
는 코드 스타일이나 팀 규칙을 맞추는 데는 도움이 되지만, 어떤 파일이 어떤 파일에 기대고 있는지까지 알려주지는 못한다. 예를 들어 utils/auth.ts를 바꾸면 12개 파일에 영향이 갈 수 있는데, Cursor는 그 전체 흐름을 자동으로 알지 못한다.
한 가지 해결책은 를 미리 분석해 으로 를 만들고, Cursor에는 원본 파일을 많이 넣는 대신 압축된 구조 설명과 작업에 필요한 관련 파일만 주는 방식이다. 이렇게 하면 토큰을 덜 쓰면서도 Cursor가 코드 구조를 더 잘 이해해 결과가 좋아질 수 있다.
핵심 포인트
- 파일이 500개 이상인 에서는 Cursor가 코드 연결 관계를 놓칠 수 있다.
- 는 스타일과 규칙에는 도움이 되지만 구조 이해 문제를 완전히 풀지는 못한다.
- utils/auth.ts 같은 핵심 파일을 바꾸면 여러 파일에 연쇄 영향이 생길 수 있다.
- 으로 를 만든 뒤 Cursor에 압축된 구조 설명을 주는 방식이 제안됐다.
- 관련 파일만 골라 제공하면 토큰 사용을 줄이고 결과 품질을 높일 수 있다.