Cursor 멀티파일 리팩토링 워크플로우 정리

배경

3년 된 Next.js 프로젝트의 인증 로직을 전면 개편하는 작업을 맡았다. 30개 이상의 파일이 연관되어 있어 수동 작업은 비효율적이라 판단했다.

Cursor Composer 활용

기존에는 파일 하나씩 열어서 수정 요청했는데, Composer 모드를 사용하니 전체 맥락을 유지하면서 작업할 수 있었다.

# .cursorrules에 프로젝트 컨텍스트 정의
auth/
  ├── middleware.ts
  ├── session.ts
  └── providers/

1. @Codebase로 전체 인증 관련 파일 인덱싱
2. 변경 사항을 자연어로 설명
3. 생성된 diff를 검토 후 일괄 적용

MCP를 통한 DB 스키마 동기화

Prisma 스키마 변경 시 MCP로 로컬 DB 상태를 실시간 참조하도록 설정했다. 마이그레이션 충돌을 사전에 방지할 수 있었다.

// mcpServers.json
{
  "prisma": {
    "command": "npx",
    "args": ["@prisma/mcp-server", "--schema", "./prisma/schema.prisma"]
  }
}

실전 팁

• 변경 범위가 클수록 먼저 타입 정의부터 수정 요청
• git diff를 Cursor에 붙여넣어 이전 변경사항 맥락 제공
• 테스트 파일도 함께 포함시켜야 정확도 향상

작업 시간이 예상 3일에서 1일로 단축되었다. 다만 생성된 코드는 반드시 직접 검증하는 습관을 유지해야 한다.