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

거의 변경되지 않는 귀하의 Skills. 이것이 가장 중요합니다. Manus Skill은 SKILL.md와 "Python 스크립트, 참조 문서 또는 템플릿과 같은 선택적 번들 리소스"로 구성되며, Manus는 이를 ".skill 파일, .zip 아카이브 또는 직접적인 GitHub 리포지토리 링크"로 내보냅니다. Cursor는 시작 시 프로젝트 범위의 .agents/skills/ 및 .cursor/skills/, 사용자 범위의 ~/.agents/skills/ 및 ~/.cursor/skills/ 등 4개 디렉터리에서 스킬을 자동으로 감지합니다. 또한 공식 문서에는 알아둘 만한 내용이 추가되어 있습니다: "호환성을 위해 Cursor는 Claude 및 Codex 디렉터리인 .claude/skills/, .codex/skills/, ~/.claude/skills/, ~/.codex/skills/에서도 스킬을 로드합니다."

따라서 압축을 풀고 폴더에 복사하기만 하면 됩니다. 양쪽 모두 동일한 로딩 동작을 설명합니다. Manus Skills는 "에이전트의 컨텍스트 창을 효율적으로 관리하기 위해 '점진적 공개(Progressive Disclosure)'"를 사용하며, Cursor의 스킬 속성 목록에는 "점진적(Progressive): 스킬이 필요에 따라 리소스를 로드하여 컨텍스트 사용을 효율적으로 유지한다"는 내용이 포함되어 있습니다.

콘텐츠로서의 프로젝트 지침. Manus의 프로젝트 수준 가이드에 넣었던 모든 내용은 리포지토리 루트의 AGENTS.md 또는 .cursor/rules 파일이 됩니다. Cursor의 규칙은 프런트매터(frontmatter)에 의해 적용 시점이 결정되는 .mdc 파일이며, 문서에서는 AGENTS.md를 ".cursor/rules의 간단한 대안"으로 설명합니다.

리포지토리 파일로서의 파일들. 코드베이스에 속해야 하는 Manus의 프로젝트 파일은 그냥 커밋하면 됩니다. 이는 마이그레이션에서 가장 흥미롭지 않은 부분이자 사람들이 가장 많은 시간을 허비하는 부분입니다.

그 외에는 아무것도 이전되지 않습니다. 구체적인 목록은 다음과 같습니다.

지식 베이스를 담을 Cursor 컨테이너가 없습니다. Manus는 이를 엄격하게 제한합니다: "사용자 지식 베이스는 Pro 사용자의 경우 100개 항목, Free 사용자의 경우 50개 항목으로 제한됩니다." Cursor에는 항목 스타일의 지식 저장소가 전혀 없습니다. Cursor의 지속성 메커니즘은 규칙(rules)과 스킬(skills)입니다. 이는 항상 켜져 있거나 호출되는 파일일 뿐, 쿼리할 수 있는 사실 집합이 아닙니다. 즉, 귀하가 축적한 40개 또는 80개의 항목은 규칙 텍스트로 압축되거나, 아예 가져올 수 없습니다.

이 제한은 두 번 읽어볼 가치가 있습니다. Manus가 이 컨테이너를 어떤 용도로 생각했는지 보여주기 때문입니다. 한도에 도달했을 때 Manus가 제공하는 조언은 "가장 중요하고 최근의 필요에 따라 지식 베이스의 항목을 필터링하고 불필요한 항목을 삭제하는 것"이며, "항목이 너무 많으면 시스템의 응답 품질에 영향을 미칠 수 있다"고 경고합니다. 100개의 항목은 아카이브가 아니라 엄선된 세트입니다.

작업 기록은 이동하지 않습니다. 작업 데이터 백업(Task Data Backup)은 잠재적으로 수십 기가바이트에 달하는 과거 실행 기록입니다. Cursor에는 이를 가져올 수 있는 경로가 없으며, 가져온다 하더라도 유용한 형태가 되지 않습니다. 이는 컨텍스트가 아니라 기록일 뿐입니다.

MCP 커넥터 및 프로젝트 자격 증명은 남겨집니다. Manus는 "공유 프로젝트 수준 자격 증명"이 있는 커넥터를 지원합니다. Cursor에도 MCP가 있지만, 이는 마이그레이션하기보다 새로 구축해야 하는 도구별 구성이며, 자격 증명은 복사하기보다 새로 발급해야 합니다.

자율 호출의 형태가 바뀝니다. In Manus, a Skill is how you turn "your agent from a general-purpose assistant into a specialized expert." In Cursor, the agent "is presented with available skills and decides when they are relevant based on context," and you can also invoke one by typing /. One detail to plan for: "A skill invoked this way attaches to one message. To keep a skill on for the whole session, use it as a Custom Mode with Option+Enter (Mac) or Alt+Enter (Windows)." Manus workflows that ran start-to-finish become skills a coding agent may or may not pick up mid-task.

별도로 처리해야 하는 계정 수준 항목. Manus는 "서비스 변경 후 Facebook 로그인을 사용할 수 없다"고 명시하고 있으며, 일부 사용자는 "향후 계정을 복구하기 위해 이 파일을 사용해야 한다"고 안내합니다. 이는 컨텍스트가 아니라 계정 관리 작업이므로 마이그레이션 세션에 포함되지 않습니다.

1단계: 아카이브를 포함된 세 가지 요소로 분류하기

무언가를 복사하기 전에 먼저 분류하세요. 거의 모든 사람이 아카이브를 하나의 단위로 마이그레이션하려고 시도하다가 막힙니다. 데이터의 3분의 2는 갈 곳이 없기 때문입니다.

내보낸 파일을 열고 다음 세 가지로 나누세요: Skills(.skill 파일 또는 .zip 아카이브, 또는 이를 푸시한 GitHub 리포지토리), 지식 베이스 항목(귀하, 귀하의 작업, 제약 조건에 대한 짧은 사실적 진술), 그리고 작업 기록(그 외의 모든 것 - 대부분의 용량을 차지함).

Manus는 아직 스킬을 추출하지 않은 경우를 위해 깔끔하게 추출할 수 있는 지름길을 제공합니다. "이 워크플로우를 스킬로 패키징(Package this workflow as a Skill)"하도록 지시하면, Manus가 "필요한 SKILL.md 파일과 관련 스크립트를 생성"합니다. 계속 반복하던 대화로만 존재했던 워크플로우가 있다면, 이 방법을 통해 매번 다시 입력하는 문단 대신 이식 가능한 파일로 만들 수 있습니다.

대용량 내보내기의 경우 Manus가 권장하는 경로를 사용하세요: 이메일이나 브라우저 다운로드를 통해 수십 기가바이트를 이동하려고 하는 대신 "OAuth 인증을 통해 Google Drive 또는 OneDrive로 직접 내보내는 것을 강력히 권장합니다."

지식 베이스 항목을 어떻게 처리할지 결정하기 전에 먼저 읽어보세요. Pro 기준 최대 100개 항목이므로, 15분이면 충분히 읽을 수 있는 분량이며, 마이그레이션 전체에서 가장 가치 있는 15분이 될 것입니다. 또한 이 부분은 다른 어떤 도구도 이해하지 못하는 파일 형식으로 되어 있는 유일한 부분이기도 합니다.

2단계: Skills 배치 후 지식이 들어갈 위치 결정하기

Cursor가 읽는 디렉터리에 Skills를 넣습니다. 단일 리포지토리에 속하는 스킬의 경우 .agents/skills/<name>/SKILL.md에 넣고 커밋합니다. 모든 곳에서 사용하려는 스킬의 경우 ~/.agents/skills/. Cursor는 시작할 때 스킬을 감지하므로 복사 후 재시작하세요.

내보내기 결과로 파일 대신 GitHub 링크를 받은 경우에도 작동합니다. Cursor의 스킬은 "파일로 저장되어 리포지토리에서 추적하거나 GitHub 리포지토리 링크를 통해 설치할 수 있습니다."

각 스킬의 프런트매터(frontmatter) 설명을 확인하세요. Cursor는 이를 통해 관련성을 판단합니다. 범용 에이전트를 가정하고 작성된 Manus 스킬 설명("연구 요청 처리")은 코딩 세션에서 거의 실행되지 않습니다. 실제로 수행할 작업의 어휘로 설명을 다시 작성하세요.

프로젝트 지침을 변환하고 하나의 형식을 선택하세요. AGENTS.md를 유지하는 것이 작업 공수가 없는 옵션이며 대개 올바른 선택입니다. 조건부 로딩을 원할 때만 .cursor/rules로 변환하세요. .mdc 프런트매터를 사용하면 항상 적용(Always Apply), 지능적 적용(Apply Intelligently - "설명을 바탕으로 에이전트가 관련이 있다고 판단할 때"), 특정 파일에 적용(Apply to Specific Files), 수동 적용(Apply Manually)을 설정할 수 있습니다.

이때 확장자를 주의 깊게 확인하세요: ".cursor/rules에 있는 일반 .md 파일은 규칙 시스템에서 무시됩니다. description, globs, alwaysApply를 지정하는 프런트매터가 없기 때문입니다. 일반 마크다운을 선호한다면 대신 AGENTS.md를 사용하세요." Manus 지침을 해당 폴더에 .md 파일로 붙여넣는 것은 아무것도 적용되지 않게 마이그레이션하는 가장 확실한 방법입니다.

그리고 사람들이 가장 막히는 부분인 지식 베이스 항목입니다. Cursor 자체 가이드는 뻔한 해결책에 반대합니다. 규칙에서 피해야 할 사항 목록에는 "이미 코드베이스에 있는 내용을 중복 작성하는 것"이 포함되어 있으며, 모범 사례에서는 "콘텐츠를 복사하는 대신 파일을 참조할 것 - 이렇게 하면 규칙을 짧게 유지하고 코드가 변경됨에 따라 규칙이 구식이 되는 것을 방지할 수 있다"고 명시하고 있습니다. 80개의 지식 항목을 항상 켜져 있는 규칙에 붙여넣는 것은 모든 요청마다 무거운 문서를 함께 전송하는 것과 같으며, Cursor는 규칙을 500행 미만으로 유지할 것을 권장합니다.

몇 개만 필요하다면 규칙으로 작성하면 됩니다. 하지만 실제 지식 베이스를 가지고 있었다면 실제 컨테이너가 필요합니다. 규칙을 제대로 적용하는 메커니즘은 세션 간 Cursor 컨테이너 유지하기에서 다루며, 반대 방향(Cursor 형태의 설정을 외부로 이동)은 Claude Code에서 Cursor로 마이그레이션하기에서 다룹니다.

방금 일어난 일을 살펴보세요. 두 도구 모두 파일 형식에 동의했기 때문에 Skills는 이동했습니다. 하지만 Cursor에는 해당 컨테이너가 없기 때문에 지식 베이스는 이동하지 못했습니다. 그리고 Manus 자체의 100개 항목 제한은 그것이 애초에 아카이브용으로 설계되지 않았음을 말해줍니다.

이것이 이번 마이그레이션의 진짜 교훈입니다. 이제 절차(Procedures)는 이식 가능합니다. Agent Skills 표준이 이를 해결했습니다. 하지만 사실(Facts)은 그렇지 않습니다. 도구마다 서로 다른 형태로 사실을 보유하고, 서로 다른 개수로 제한하며, 도구를 떠날 때 유실됩니다.

이것이 바로 MemoryLake가 해결하는 문제입니다. 도구가 매 요청마다 전송하는 파일이 아니라, 도구가 쿼리할 수 있는 레이어에서 읽고 수정하고 삭제할 수 있는 항목으로 지속 가능한 지식을 보관합니다. 설정은 세 단계로 진행됩니다.

1단계: API 키 생성

MemoryLake에 로그인하고 API 키를 생성합니다. 연결하는 도구 전반에서 하나의 자격 증명만 사용하면 됩니다.

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

각각 하나의 주장만 담긴 짧은 항목들입니다. Manus 지식 베이스가 소스 자료가 되며, 이미 대략적으로 적절한 형태를 갖추고 있습니다:

이유가 첨부된 제약 조건. "재무 마감이 수요일 밤에 이루어지므로 보고서는 목요일에 발송됩니다." 지침은 마감일만 명시하지만, 누군가 의문을 제기할 때 살아남는 것은 이 제약 조건입니다.

이미 배제된 접근 방식과 그 이유. 어떤 규칙 파일에도 맞지 않고 새로운 에이전트가 올 때마다 다시 제안하는 범주입니다.

아무도 알려주지 않는 환경적 사실. 문서화되지 않은 임계값에서 속도를 제한하는 API, 이틀의 지연이 있는 데이터 세트, PDF를 수락하지 않는 클라이언트 등입니다.

귀하만의 작업 컨텍스트. 역할, 스택, 컨벤션 등 범용 에이전트는 귀하에 대해 알고 있었지만 새로운 코딩 에이전트는 알지 못하는 항목들입니다.

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

사용하는 도구를 연결합니다. MemoryLake는 MCP 및 API를 통해 액세스할 수 있으므로, Claude Code, Codex, OpenClaw를 포함한 MCP 네이티브 에이전트는 MCP 서버를 가리켜 연결하고, 다른 어시스턴트는 API를 통해 동일한 메모리를 읽습니다. 실질적인 효과는 다음 도구 전환이 지식 이전이 아닌 단순한 구성 변경이 된다는 점입니다.

세 가지 솔직한 한계가 있습니다. MemoryLake는 Manus 백업 아카이브를 읽지 않으며 작업 기록을 가져오지 않습니다. 1단계는 여전히 수동 분류로 남으며, 아카이브는 안전한 곳에 보관해야 하는 기록입니다. MemoryLake는 귀하 또는 귀하의 에이전트가 입력한 내용만 보관하므로 2단계는 수동으로 진행됩니다. 또한 자격 증명 저장소가 아니므로 커넥터 및 프로젝트 수준 자격 증명은 복사하지 말고 새 도구에서 다시 발급해야 합니다.

아카이브가 더 이상 걸림돌이 되지 않습니다. 데이터의 3분의 2가 갈 곳이 없다는 사실을 알게 되면, 마이그레이션은 오후 내내 혼란스러워하는 대신 15분 만에 끝나는 분류 작업이 됩니다.

Skills가 더 이상 도구 전용 작업이 아닙니다. 동일한 SKILL.md를 Cursor, Claude Code, Codex가 모두 읽습니다. 한 번 작성한 워크플로우는 이제 온전히 귀하의 자산이 됩니다.

항목 제한이 더 이상 한계가 되지 않습니다. Pro 기준 100개 항목 제한은 저장 공간의 결정이 아니라 큐레이션을 강제하는 기능이었습니다. 큐레이션은 유지하되, 한계는 없애세요.

새 도구에서 규칙 파일이 짧게 유지됩니다. 규칙이 비대해지는 이유는 조종(steering)과 기억(remembering)이라는 두 가지 역할을 동시에 수행하기 때문입니다. 이 둘을 분리하면 Cursor의 500행 제한 가이드는 더 이상 문제가 되지 않습니다.

"아직 내 작업을 파악하지 못했다"에 대한 진짜 해답을 얻게 됩니다. "규칙을 더 많이 작성하라"가 아니라 "사실은 애초에 규칙에 있지 않았다"는 것입니다. 이에 대한 일반적인 사례는 RAG가 메모리가 아닌 이유에서 확인할 수 있습니다.

무엇보다 먼저 Skills를 파일로 내보내세요. 이는 실제 적용할 대상이 있는 부분이며, .skill, .zip, GitHub 링크 모두 작동합니다.

대용량 내보내기에는 Google Drive 또는 OneDrive로의 OAuth 경로를 사용하세요. 작업 데이터가 수십 기가바이트에 달할 수 있기 때문에 Manus가 특별히 권장하는 방법입니다.

지식 베이스 항목을 직접 읽어보세요. 최대 100개이므로 충분히 읽을 수 있는 목록이며, 파일 형식이 없는 유일한 부분입니다.

새로운 컨텍스트에 맞게 스킬 설명을 다시 작성하세요. Cursor는 설명을 보고 스킬을 선택합니다. 범용 에이전트를 위해 작성된 설명은 코딩 세션에서 실행되지 않습니다.

.cursor/rules 안에 일반 .md 파일을 그대로 두지 마세요. 자동으로 무시됩니다. 프런트매터가 포함된 .mdc를 사용하거나 AGENTS.md를 사용하세요.

이식성을 위해 .agents/skills/를 선호하세요. Cursor, Claude Code, Codex는 모두 겹치는 디렉터리에서 스킬을 읽습니다. 공유 디렉터리를 선택하면 이중 복사를 피할 수 있습니다.

스킬을 복사한 후 Cursor를 재시작하세요. 감지는 시작 시점에 이루어집니다.

자격 증명은 마이그레이션하지 말고 새로 발급하세요. 떠나는 플랫폼의 커넥터 자격 증명은 이동하지 말고 교체(rotate)해야 합니다.

사실(Facts)은 규칙 파일 외부에 두세요. 규칙은 방향과 포인터일 뿐입니다. 에이전트가 귀하가 기록하지 않은 상황을 처리할 수 있게 해주는 것은 추론(reasoning)입니다. 이 형태는 에이전트가 귀하가 작성한 지침 파일을 무시하는 이유에서 다룹니다.

Manus에서 Cursor로의 전환은 대부분의 사람들이 중간쯤 진행하기 전까지는 깨닫지 못하는 경계선을 따라 깔끔하게 나뉩니다. 두 도구 모두 Agent Skills 표준을 구현하고 SKILL.md를 읽기 때문에 Skills는 그대로 이전됩니다. Cursor는 호환성을 위해 .claude/skills/ 및 .codex/skills/에서도 로드하므로, 폴더 복사와 재시작이 사실상 작업의 대부분입니다. 프로젝트 지침은 형식 결정과 확장자 함정 하나만 주의하면 AGENTS.md 또는 .cursor/rules로 변환됩니다.

이전되지 않는 것은 지식 베이스입니다. Manus는 이를 Pro 기준 100개, Free 기준 50개 항목으로 제한하고 늘리기보다 정리할 것을 권장했습니다. Cursor에는 이에 상응하는 컨테이너가 전혀 없으며, 자체 문서에서도 해당 콘텐츠를 항상 켜져 있는 규칙에 붙여넣는 것에 반대합니다. 작업 기록 역시 이동하지 않으며, 이동해서도 안 됩니다.

따라서 무언가를 복사하기 전에 아카이브를 Skills, 항목, 기록으로 분류하세요. Skills는 .agents/skills/에 배치하고, 지침을 변환하고, 제약 조건, 배제된 접근 방식, 아무도 알려주지 않는 사실 등의 항목들은 도구가 쿼리할 수 있는 곳에 두세요. 그렇게 하면 다음 마이그레이션은 이번 마이그레이션이 그랬어야 했던 것처럼 단순한 디렉터리 복사와 구성 변경만으로 끝날 것입니다.