컨텍스트 손실 없이 Cursor에서 Warp로 마이그레이션하는 방법 (2026)

Warp는 대부분의 마이그레이션 가이드가 숨기곤 하는 문장으로 시작합니다. "Warp에는 원클릭 Cursor 임포터가 없습니다."

그 이유는 기술적으로 타당합니다. "Cursor는 VS Code 코드베이스를 기반으로 구축되었으므로 터미널 설정은 settings.json 내의 terminal.integrated.fontFamily 및 terminal.integrated.defaultProfile.*과 같은 키 아래에 위치합니다. 이 파일은 읽을 수 있으므로, Warp의 Agent가 일치하는 터미널 값을 Warp의 settings.toml로 변환할 수 있습니다."

따라서 자동화는 실제로 존재하지만, 외관 설정에만 국한됩니다. 에이전트 측면에 대해서도 이 페이지는 매우 직설적입니다. "Cursor의 Composer 및 Agent 기능은 일대일 마이그레이션 경로가 없으며, 서로 다른 Warp 개념에 매핑됩니다."

다음은 Warp의 자체 대응 표에서 발췌한 핵심 매핑 정보입니다.

주목해야 할 행은 .cursorrules입니다. Warp의 안내는 놀라울 정도로 직설적입니다. "Agent Mode에서 /init을 실행하여 AGENTS.md를 생성하거나, .cursorrules 내용을 직접 복사하세요."

이것은 Cursor의 4가지 지침 범위 중 하나에 해당합니다. Cursor 문서에는 .cursor/rules의 프로젝트 규칙(Project Rules), "Cursor 환경에 전역적으로 적용되는" 사용자 규칙(User Rules), Team 및 Enterprise 요금제에서 "대시보드에서 관리되는" 팀 규칙(Team Rules), 그리고 .cursor/rules의 "간단한 대안"인 AGENTS.md가 나열되어 있습니다.

Warp에는 전역 규칙(Global Rules)과 프로젝트 규칙(Project Rules)이라는 두 가지 범위만 있습니다. 따라서 매핑 과정에서 특정 방향으로 정보 손실이 발생합니다. 대시보드에서 중앙 집중식으로 관리되는 Cursor의 팀 규칙은 Warp에서 이에 상응하는 기능이 없습니다. 이는 각 사용자의 로컬 장비에 있는 전역 규칙이 되거나, Git에 커밋된 AGENTS.md가 되어야 하며, 오직 두 번째 방법만이 자동으로 동기화 상태를 유지합니다.

본격적으로 시작하기 전에 짚고 넘어가야 할 점이 하나 더 있습니다. Warp에는 지속성 메모리 시스템인 Agent Memory가 있으며, 이는 진정한 크로스 하네스(cross-harness) 방식입니다. 문서에 따르면 메모리는 "내장된 Warp Agent, Claude Code, Codex 및 향후 추가될 기타 지원되는 모든 에이전트 하네스 간에 공유"됩니다. 하지만 가용성 기준은 명확합니다. "Agent Memory는 연구 프리뷰(research preview) 단계에 있으며 디자인 파트너 팀에 한해 활성화됩니다." (액세스 요청 대기자 명단 제공). 여러분의 팀이 디자인 파트너가 아니라면, 이 기능이 아직 제공되지 않는 것처럼 마이그레이션을 계획하십시오. 실제로 여러분에게는 제공되지 않기 때문입니다.

두 단계로 진행됩니다. 첫 번째는 Cursor가 실제로 에이전트에게 제공하고 있던 정보를 인벤토리화하는 것이고, 두 번째는 Warp가 이를 읽을 수 있는 위치에 배치하는 것입니다.

1단계: 기억나는 범위뿐만 아니라 Cursor의 4가지 범위를 모두 인벤토리화하기

Cursor 문서는 규칙을 영구 보존 메커니즘으로 명시하고 있습니다. "대규모 언어 모델은 완료(completion) 간에 메모리를 유지하지 않습니다. 규칙은 프롬프트 수준에서 지속적이고 재사용 가능한 컨텍스트를 제공합니다." 즉, 규칙 파일이 곧 여러분의 컨텍스트이며, 모든 규칙 파일이 필요하다는 뜻입니다.

각 범위를 열고 내용을 복사해 두세요.

• .cursor/rules에 .mdc 파일로 저장된 프로젝트 규칙(Project rules). 진행 시 주의할 점이 있습니다. "프론트매터(frontmatter)가 없는 .cursor/rules 내의 일반 .md 파일은 규칙 시스템에서 무시됩니다." 해당 디렉토리에 .md 파일로 노트를 보관해 왔다면 Cursor는 이를 전혀 읽지 않았으므로, 이를 규칙으로 마이그레이션할 필요가 없습니다.
• Cursor 환경에 전역적으로 적용되는 사용자 규칙(User rules). 이 규칙은 리포지토리가 아닌 사용자 로컬 환경에 저장되므로 가장 자주 잊어버리는 항목입니다.
• Team 또는 Enterprise 요금제를 사용하는 경우 대시보드에서 제공되는 팀 규칙(Team rules). 액세스 권한을 잃기 전에 내보내기(export)를 받아두세요.
• 이미 사용 중인 경우 AGENTS.md. 이 파일은 그대로 이동하면 되므로 가장 수월합니다.

복사하는 동안 각 규칙의 활성화 유형을 기록해 두세요. Cursor의 유형에는 Always Apply, Apply Intelligently("설명을 바탕으로 에이전트가 관련이 있다고 판단할 때" 실행됨), Apply to Specific Files(패턴 매칭)가 있습니다. Warp의 모델은 더 단순하여 일부 규칙의 카테고리를 변경해야 하므로, Warp 측에서 이 정보가 필요합니다.

또한 어떤 파일에도 나타나지 않는 항목, 즉 지난 6개월 동안 채팅에서 수정했던 사항들을 기록해 두세요. Cursor 문서에 명시되어 있듯이 모델은 완료 간에 메모리를 유지하지 않으므로, 선호 사항이 규칙으로 작성되지 않았다면 매 세션마다 새로 설정해야 했으며 내보낼 수 있는 내용이 없습니다. 지금 바로 이를 기록해 두세요. 이 부분은 마이그레이션 과정 중 유일하게 여러분의 기억에 의존해야 하는 영역입니다. 왜 Cursor가 프로젝트 규칙을 잊어버리는지 또는 기기 간에 설정을 잊어버리는지 궁금했다면, 대개 이 4가지 범위의 분할이 원인입니다.

2단계: Warp의 2가지 범위에 배치하고 파일 이름 규칙에 주의하기

Warp는 정확히 두 가지 규칙 유형을 지원합니다. "전역 규칙(Global Rules)은 모든 프로젝트와 컨텍스트에 적용"되며, "프로젝트 규칙(Project Rules)은 코드베이스에 상주하며 해당 프로젝트 내에서 작업할 때 자동으로 적용됩니다. 이 규칙은 AGENTS.md 파일(또는 하위 호환성을 위한 WARP.md)에 저장됩니다."

다음과 같이 매핑합니다. Always Apply로 설정된 Cursor 프로젝트 규칙은 루트 AGENTS.md 내용이 됩니다. 특정 파일로 범위가 지정된 Cursor 프로젝트 규칙은 디렉토리 수준의 AGENTS.md 파일이 됩니다. "Warp는 루트 및 현재 디렉토리의 AGENTS.md(또는 WARP.md)를 자동으로 적용"하기 때문입니다. Cursor 사용자 규칙은 Warp 전역 규칙이 됩니다. Cursor 팀 규칙은 커밋된 AGENTS.md 내용이 되며, 이것이 공유 상태를 유지할 수 있는 유일한 형태입니다.

그냥 지나치면 문제가 될 수 있는 세 가지 파일 이름 규칙이 있습니다.

1. "Warp가 인식하려면 파일 이름이 대문자여야 합니다 (예: agents.md나 Agents.md가 아닌 AGENTS.md)."
2. "동일한 디렉토리에 WARP.md와 AGENTS.md가 모두 존재하는 경우 WARP.md가 우선합니다." 따라서 이전 테스트에서 남겨진 WARP.md가 방금 작성한 파일보다 우선적으로 적용될 수 있습니다.
3. Warp는 새 프로젝트에 AGENTS.md를 사용할 것을 권장하며, 기존 WARP.md 파일도 계속 지원하므로 다른 변경 없이 언제든지 이름을 바꿀 수 있습니다.

Cursor의 Apply Intelligently 모드에 의존했던 규칙들은 결정을 내려야 합니다. Warp의 프로젝트 규칙은 모델의 판단이 아니라 위치에 따라 자동으로 적용되기 때문입니다. 규칙을 무조건적으로 적용하거나 특정 디렉토리로 범위를 제한하십시오. 모호하게 남겨두고 관련성에 따라 실행되기를 바라는 것은 마이그레이션된 규칙 세트가 무시되는 지름길입니다. 이는 에이전트가 지침 파일을 무시하는 이유와 동일한 실패 패턴입니다.

/init 단계를 건너뛰지 마세요. Agent Mode에서 이를 실행하면 Warp가 예상하는 형태로 AGENTS.md가 생성되므로, 단순히 .cursorrules 파일을 붙여넣는 것보다 더 좋은 시작점이 됩니다.

위의 두 단계를 따르면 올바른 Warp 설정이 완료됩니다. 하지만 동시에 한 가지 불편한 사실을 깨닫게 될 것입니다. 자동화된 마이그레이션 부분은 글꼴만 이동시켰고, 수동 마이그레이션 부분이 중요한 모든 것을 이동시켰다는 점입니다.

이러한 불균형은 Warp나 Cursor의 잘못이 아닙니다. 프로젝트의 누적된 지식이 특정 도구의 파일 형식 내에 존재할 때 발생하는 현상입니다. 이에 대한 Warp 자체의 해답인 Agent Memory는 올바른 방향이지만, 현재는 디자인 파트너 팀으로 제한되어 있습니다. 외부 메모리 레이어를 사용하면 대기자 명단 없이 오늘 바로 동일한 이점을 누릴 수 있습니다. MemoryLake는 세 단계로 설정할 수 있습니다.

1단계: API 키 생성하기

로그인 후 대시보드에서 API 키를 생성합니다. 이 자격 증명은 특정 에디터가 아닌 팀에 귀속되므로, 오늘 Warp에서 읽은 동일한 지식을 다음 분기에 평가할 다른 도구에서도 그대로 읽을 수 있습니다.

2단계: 첫 번째 메모리 업로드하기

1단계에서 기록해 둔, 저장할 파일이 마땅치 않았던 내용들을 입력하세요. 아키텍처 결정 사항과 그 이유, 채팅에서 계속 반복했던 컨벤션, 클라이언트 및 도메인 관련 세부 사항, 특정 임시 방편(workaround)이 존재하는 이유 등이 이에 해당합니다. 중앙 관리가 중요했다면 팀 규칙(Team Rules) 내용도 여기에 입력하세요. 이는 Warp 측에서 대시보드로 관리되는 범위와 가장 유사한 형태입니다.

AGENTS.md는 리포지토리에 커밋되어 검토할 수 있고 항상 적용되어야 하는 규칙과 같이 본연의 목적에 맞게 사용하세요.

3단계: AI 및 에이전트 연결하기

Warp의 Agent가 해당 저장소를 가리키도록 설정합니다. 마이그레이션을 진행하는 합리적인 방법인 '시험 기간 동안 팀의 일부는 Cursor를 계속 사용'하는 경우에도, 나중에 누군가 조정해야 하는 두 개의 서로 다른 규칙 세트로 갈라지는 대신 두 에디터 모두 동일한 레이어를 읽게 됩니다.

첫 번째 변화는 시험 기간의 비용 부담이 없어진다는 점입니다. 대부분의 Cursor에서 Warp로의 전환 평가는 두 규칙 세트를 동기화하는 작업이 번거롭기 때문에 중단되며, 이로 인해 너무 일찍 결정을 내리거나 시험 사용을 포기하게 됩니다. 두 에디터 외부에 지속 가능한 레이어를 두면, 병행하여 실행하는 데 추가 비용이 들지 않습니다.

두 번째는 팀 규칙(Team Rules)의 공백이 더 이상 문제가 되지 않는다는 점입니다. Warp의 두 가지 범위는 깔끔하지만 대시보드처럼 중앙에서 관리되지 않습니다. 공유 저장소를 사용하면 모든 구성원이 수동으로 동일한 전역 규칙을 유지 관리할 필요 없이 중앙 관리 특성을 회복할 수 있습니다.

세 번째는 프롬프트 공간을 확보하기 위해 경쟁할 필요가 없어진다는 점입니다. 항상 적용되는 규칙은 매번 컨텍스트에 병합되는데, 이는 10개의 컨벤션에는 적합하지만 도메인에 관한 200개의 사실에는 적합하지 않습니다. "에이전트가 준수해야 하는 규칙"과 "에이전트가 알아야 할 사항"을 분리하는 것은 코딩 에이전트가 실제로 읽는 내용에서 다루는 구분의 실질적인 적용 버전입니다.

• 설정 포팅을 먼저 실행한 후 잊어버리세요. Warp의 Agent가 modify-settings 스킬을 사용하여 settings.json을 변환하도록 하고 diff를 검토하세요. 이는 외관만 처리하므로 그 이상을 기대하지 마십시오.
• 삭제하기 전에 Cursor의 4가지 범위를 모두 인벤토리화하세요. 사용자 규칙(User Rules)과 팀 규칙(Team Rules)은 사람들이 가장 자주 분실하는 항목입니다.
• .cursor/rules에 있는 불필요한 .md 파일은 마이그레이션하지 말고 삭제하세요. Cursor는 이를 무시하고 있었으므로, 마이그레이션하는 것은 무의미한 짐을 옮기는 것과 같습니다.
• 남겨진 WARP.md가 있는지 확인하세요. 동일한 디렉토리 내에서는 AGENTS.md보다 우선하므로, 매우 혼란스러운 디버깅 상황이 발생할 수 있습니다.
• 대문자 파일 이름을 사용하세요. agents.md는 인식되지 않습니다.
• Apply Intelligently 규칙을 항상 켜짐 또는 디렉토리 범위로 변환하세요. Warp는 관련성 판단이 아니라 위치에 따라 프로젝트 규칙을 적용합니다.
• 액세스 권한이 없다면 Agent Memory를 전제로 계획하지 마세요. 이 기능은 디자인 파트너 팀을 위한 연구 프리뷰 단계에 있으며 대기자 명단이 있습니다. 이번 주에 바로 사용할 수 있는 기능을 기준으로 마이그레이션을 작성하세요.
• 결정 사항과 도메인 지식은 규칙 파일에 넣지 마세요. 규칙은 행동을 정의하기 위한 것이며, 계속 늘어나는 컨텍스트는 확장 가능한 다른 곳에 보관해야 합니다.

첫 번째 문단에 "원클릭 임포터 없음"이라고 명시한 Warp의 마이그레이션 페이지는 칭찬받을 만합니다. 이러한 솔직함은 작업이 필요한 부분을 명확히 알려줍니다. 터미널 설정은 자동으로 이동하고, .cursorrules는 AGENTS.md로 복사되지만, 에이전트가 프로젝트에 대해 학습한 모든 내용은 이를 기억하는 사람이 직접 다시 작성해야 합니다.

이번 마이그레이션을 위해 그 재작성 작업을 한 번 수행하게 될 것입니다. 다음 마이그레이션 때 이 작업을 다시 해야 할지 여부는 이번에 그 내용을 어디에 저장하느냐에 달려 있습니다.