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

활성화 모드가 매핑되며, 이 매핑은 기록해 둘 가치가 있습니다. Augment는 세 가지 규칙 유형을 지원합니다. 모든 사용자 프롬프트에 내용이 포함되는 Always, 설명(description) 필드를 기반으로 Agent가 규칙을 자동으로 감지하고 첨부하는 Auto, 그리고 @를 통해 규칙 파일을 수동으로 첨부해야 하는 Manual입니다.

Cursor는 세 가지 frontmatter 필드의 상호작용을 통해 동일한 세 가지 상태를 표현합니다. alwaysApply: true는 "항상 포함됨. Globs 및 description은 무시됨"을 의미합니다. alwaysApply: false이고 description은 있지만 globs가 없는 경우, "Agent가 설명을 읽고 관련이 있을 때 규칙을 가져옴"을 의미합니다. 둘 다 없는 경우, 규칙은 "채팅에서 규칙을 @로 언급할 때만 포함됨"이 됩니다.

따라서 Always는 alwaysApply: true에 매핑되고, Auto는 alwaysApply: false와 description에 매핑되며, Manual은 다른 것 없이 alwaysApply: false에 매핑됩니다. Augment의 CLI는 frontmatter에서 처음 두 개를 always_apply 및 agent_requested로 명명하므로 대응 관계가 더욱 명확해집니다.

Cursor는 Augment에 없는 모드를 추가합니다. alwaysApply: false와 globs가 제공되면, Cursor 규칙은 "일치하는 파일이 컨텍스트에 있을 때 자동 첨부"됩니다. Augment의 agent_requested는 모델이 설명을 읽고 결정하는 것에 의존하는 반면, Cursor의 glob 모드는 결정론적인 패턴 매칭입니다. TypeScript 파일에만 정말 중요한 Augment 규칙이 있고 이를 에이전트를 위해 줄글로 설명해 왔다면, 이는 업그레이드입니다. 이를 glob으로 인코딩하고 더 이상 에이전트가 알아차리기를 바라지 마세요.

파일 확장자가 함정입니다. Cursor 문서에 따르면: "프로젝트 규칙은 반드시 .mdc 확장자를 사용해야 합니다. .cursor/rules에 있는 일반 .md 파일은 description, globs, alwaysApply를 지정할 frontmatter가 없기 때문에 규칙 시스템에서 무시됩니다." Augment 규칙은 .md입니다. 변경 없이 그대로 복사하면 올바른 디렉토리에 위치하고 올바르게 보이지만, 아무런 동작도 하지 않습니다. 오류 메시지도 표시되지 않습니다.

디렉토리 중첩은 다르게 작동하며, 이는 Cursor에 유리합니다. Augment는 제한 사항을 명시하고 있습니다: "AGENTS.md 및 CLAUDE.md 파일만 계층적으로 검색됩니다. .augment/rules/에 있는 파일은 작업 공간 루트에서만 로드됩니다." Cursor는 중첩된 규칙 디렉토리를 허용하므로, 규칙이 지배하는 코드 바로 옆에 위치할 수 있습니다. Augment의 요구 사항 때문에 모든 것을 하나의 루트 디렉토리로 평탄화(flatten)해야 했다면, 이제는 그렇게 하지 않아도 됩니다.

User Rules는 이전되지만 구성 가능성을 잃습니다. Augment는 사용자 규칙을 ~/.augment/rules/에 저장하며, 문서에서는 그 동작을 다음과 같이 명시합니다: "사용자 규칙은 항상 always_apply로 처리되며 다른 frontmatter 유형을 지원하지 않습니다. frontmatter 구성은 작업 공간 규칙에만 영향을 미칩니다." Cursor의 User Rules는 "Cursor 환경에 글로벌하게 적용"되며 Agent에 의해 사용됩니다. 동일한 역할, 동일한 무조건적 로딩이므로 이 부분은 그대로 복사하면 됩니다.

AGENTS.md는 있는 그대로 이전됩니다. 두 도구 모두 이를 읽습니다. Augment는 하위 디렉토리를 통해 계층적으로 AGENTS.md 및 CLAUDE.md를 검색합니다. Cursor는 "프로젝트 루트 및 하위 디렉토리에서 AGENTS.md를 지원"하며 이를 "메타데이터나 복잡한 구성이 없는" 단순한 마크다운 형태의 ".cursor/rules의 간단한 대안"으로 설명합니다. Augment 설정의 일부가 이미 AGENTS.md에 있다면, 그 부분은 추가 작업이 필요하지 않습니다.

팀 수준 규칙은 모델이 완전히 바뀝니다. Cursor의 Team Rules는 "대시보드에서 관리되는 팀 전체 규칙"으로, Team 및 Enterprise 플랜에서 사용할 수 있으며 규칙 폴더에 있는 그 어떤 것과도 다르게 작동합니다: "Team Rules는 자유 형식 텍스트입니다. Project Rules의 폴더 구조를 사용하지 않습니다." 이 규칙들은 globs를 지원하며, Enforce this rule로 표시하여 "모든 팀원에게 필수로 적용되고 Customize에서 비활성화할 수 없도록" 설정할 수 있습니다. 또한 우선순위 체인의 맨 위에 위치합니다. "Team Rules → Project Rules → User Rules" 순서이며, "적용 가능한 모든 규칙이 병합되고, 지침이 충돌할 때는 이전 소스가 우선합니다."

이것은 정말 유용한 추가 기능이며, 온 팀이 의존하던 Augment 작업 공간 규칙을 이전하기에 가장 적합한 목적지입니다.

Cosmos Experts Memory는 대응하는 기능이 없으며, 이것이 진짜 손실입니다. Augment의 Experts는 "공유 가상 파일 시스템(VFS)에 스코프가 지정된 지식을 저장하여, 향후 세션이 현재 대화에 의존하지 않고도 확립된 선호도, 컨벤션 및 교훈을 적용할 수 있도록 하는" 메모리 레이어를 가지고 있습니다. Expert의 메모리는 "해당 팀에 속하며 워크플로우에 적합한 범위로 분리"되고, 기본적으로 활성화되어 있습니다: "모든 Template Experts에 대해 메모리가 활성화됩니다."

또한 신호 품질에 따라 두 가지 고유한 모델을 실행합니다. "Simple memory가 기본값입니다. 명확하고 고품질의 인간 피드백을 큐레이션된 지식 파일에 직접 기록합니다." 대안인 "Noisy memory는 증거 로그와 큐레이션된 지식 파일을 결합하여 사용합니다. 시간이 지남에 따라 약한 신호들을 결합하고 증거가 충분히 강해진 후에만 학습을 촉진합니다." 두 모델 모두 "독자에게 동일한 큐레이션된 지식 뷰를 노출"합니다.

Cursor가 문서화한 지속성 메커니즘은 규칙(rules)입니다. 규칙의 목적에 대한 자체 프레임워크에서 이를 직접적으로 설명합니다: "대규모 언어 모델은 완료(completions) 간에 메모리를 유지하지 않습니다. 규칙은 프롬프트 수준에서 지속적이고 재사용 가능한 컨텍스트를 제공합니다." 팀 소유의, 스코프가 지정되고 피드백을 통해 스스로 기록되는 메모리 저장소에 상응하는 문서화된 기능은 없습니다. 따라서 Augment VFS에 축적된 학습 내용은 전환하기 전(전환한 후가 아니라)에 계획을 세워야 하는 부분입니다.

1단계: 규칙 파일 변환, 확장자와 frontmatter를 함께 처리하기

이 두 가지 편집을 한 번에 수행하세요. 하나만 수행하고 다른 하나를 수행하지 않으면 아무런 동작도 하지 않는 비활성 파일이 생성되기 때문입니다.

.augment/rules/에 있는 각 파일에 대해, 이름을 .mdc로 변경하고 frontmatter를 다시 작성합니다. type: always_apply가 있는 Augment 규칙은 alwaysApply: true가 됩니다. type: agent_requested가 있는 규칙은 alwaysApply: false와 기존에 가지고 있던 description이 됩니다. Cursor도 Augment와 동일한 방식으로 설명을 사용하므로 해당 설명을 유지하세요. manual 규칙은 설명과 globs 없이 alwaysApply: false가 되며, 파일 이름으로 @-언급됩니다.

그런 다음 두 번째 패스를 수행하여 실제로 glob 범위로 지정해야 하는 규칙을 찾으십시오. 설명이 "X 파일로 작업할 때 이것을 사용하십시오"에 해당하는 모든 것은 globs 대상이 되며, 이는 판단을 매칭으로 변환합니다. 또한 Cursor는 하위 디렉토리 규칙 폴더를 허용하고 Augment는 허용하지 않았으므로, 중첩된 지침을 루트 외부로 이동할 수 있는 시점이기도 합니다.

알아두면 유용한 두 가지 편의 기능이 있습니다. 채팅에서의 Cursor /create-rule은 "적절한 frontmatter가 포함된 규칙 파일을 생성하고 .cursor/rules에 저장"하므로, 설명할 수 있는 규칙에 대해 frontmatter를 직접 작성하는 것보다 빠릅니다. 그리고 Cursor는 GitHub 리포지토리에서 규칙을 가져올 수 있습니다. "리포지토리의 모든 .mdc 파일을 검색"하여 상대 경로를 유지하면서 .cursor/rules/imported/<repoName> 아래에 배치합니다. 여러 리포지토리를 마이그레이션하는 경우, 공유 규칙 리포지토리로 한 번 변환한 다음 가져오는 것이 매번 변환하는 것보다 수고가 적습니다.

~/.augment/rules/ 콘텐츠를 Cursor의 User Rules로 복사하고, 팀이 반드시 따라야 하는 모든 것을 Team Rules로 승격시키세요. 개별적으로 끌 수 없어야 하는 규칙에는 Enforce this rule을 사용하십시오. 모든 것을 승격시켜서는 안 됩니다: "적용 가능한 모든 규칙이 병합되고, 지침이 충돌할 때는 이전 소스가 우선합니다." 프로젝트 규칙과 모순되는 대규모 강제 적용 Team Rule은 로컬에서 아무도 해결할 수 없는 방식으로 우선권을 갖게 됩니다.

2단계: 액세스 권한을 잃기 전에 Experts의 메모리 읽기

이 단계에는 도구가 없으며 가장 중요한 단계입니다.

Augment는 메모리를 "자체 VFS 디렉토리 아래에 읽기 쉬운 마크다운으로" 기록하므로, 찾아보면 쉽게 읽을 수 있습니다. 찾아보세요. 가치 있는 자료는 아무도 두 번 기록하지 않는 종류의 것들입니다. 리뷰 피드백을 통해 Expert가 학습한 코딩 스타일 선호도, 반복적인 수정을 통해 추론한 컨벤션, Code Review Memory Expert가 수개월 동안의 댓글에서 추출해낸 교훈 등입니다.

찾은 내용을 두 개의 더미로 분류하세요. "항상 API 경계에서 유효성을 검사하십시오", "여기서는 상속보다 구성을 선호하십시오"와 같이 규칙처럼 읽히는 것들은 .mdc 규칙이나 Team Rules가 되며, 1단계에서 이미 이를 위한 메커니즘을 구축했습니다. 의사 결정이 내려진 이유, 내부적으로 용어가 의미하는 바, 어떤 서비스가 무엇을 소유하는지 등 프로젝트에 대한 사실처럼 읽히는 것들은 규칙 파일에 전혀 속하지 않습니다. 규칙은 지침입니다. 이것들은 지식(knowledge)이며, 이를 alwaysApply: true 파일에 밀어 넣는 것은 규칙 디렉토리를 프롬프트마다 컨텍스트를 낭비하는 서류 캐비닛으로 만드는 지름길입니다. 이 차이가 바로 코딩 에이전트가 실제로 읽는 것의 핵심 내용입니다.

또한 절차적으로 무엇을 포기하는지 유념하여 의식적으로 대체할 수 있도록 하십시오. Augment의 메모리는 무언가를 학습했을 때 알려줍니다: "대화형 세션에서 무언가를 기억할 때 알려주므로 이를 수정하거나 거부할 수 있습니다." 그리고 상황이 바뀌면 "현재 증거가 기억된 규칙과 충돌할 때 불일치를 표시합니다." 규칙 파일은 둘 다 수행하지 않습니다. 마이그레이션 후에는 검토하는 습관이 여러분의 몫이 되어야 합니다.

위의 수동 경로는 지침을 깔끔하게 변환하지만, 축적된 지식을 맞지 않는 규칙 파일로 만들거나 아무도 읽지 않는 문서로 만들어 버립니다. 이 두 번째 결과가 바로 도구 마이그레이션 비용을 비싸게 느끼게 만드는 원인입니다.

대안은 두 레이어를 의도적으로 분리하는 것입니다. "커밋하기 전에 린트 실행", "2칸 들여쓰기 사용"과 같은 지침은 도구가 허용하는 한 가장 좁은 범위로 규칙에 속해야 합니다. 프로젝트에 대한 사실은 모든 프롬프트에서 로드되는 저장소가 아니라, 에이전트가 필요할 때 읽는 저장소에 속해야 합니다. 그렇게 하면 마이그레이션은 frontmatter 변환으로 축소되고, 다음 마이그레이션은 더욱 간단해집니다. MemoryLake는 세 단계로 설정할 수 있습니다.

1단계: API 키 생성

로그인하고 대시보드에서 API 키를 생성합니다. 이는 규칙 디렉토리나 작업 공간에 종속되지 않으므로, 요청이 Cursor에서 오든, CLI에서 오든, 다음 분기에 평가할 다른 도구에서 오든 동일한 지식을 사용할 수 있습니다.

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

위의 2단계에서 분류한 두 번째 더미를 입력하세요: 아키텍처 결정 및 그 이유, 도메인 어휘, Augment Experts가 학습한 고정 선호도, 서비스 소유권, 리뷰에서 계속해서 제공하는 답변들입니다.

지침은 .cursor/rules에 남겨두세요. 이곳은 의도적으로 규칙 폴더를 복제하는 곳이 아닙니다.

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

Cursor가 저장소를 가리키도록 하세요. .mdc 파일은 작고 행동 지향적으로 유지되고, 컨텍스트 예산이 배경 사실에 의해 소비되지 않으며, 다음 달에 합류하는 팀원도 에이전트와 동일한 지식을 읽게 됩니다. 이 속성은 도구 간에 하나의 메모리 공유하기에서 다루고 있습니다.

첫 번째 변화는 변환이 기계적으로 바뀐다는 것입니다. 확장자, frontmatter, 끝 — 어떤 학습된 컨벤션이 모든 프롬프트에 포함되어야 하는지에 대한 판단을 내릴 필요가 없습니다.

두 번째는 팀 지식이 플랜 등급에 의존하지 않게 된다는 점입니다. Team Rules는 Team 및 Enterprise 기능이며, 폴더 구조가 없는 자유 형식 텍스트입니다. 강제 적용에는 유용하지만, 지식 베이스로 사용하기에는 적합하지 않습니다.

세 번째는 Augment가 제공했던 검토 가능성을 유지할 수 있다는 점입니다. Augment의 메모리는 무언가를 기억했을 때 알려주고 모순을 표시했지만, 규칙 파일은 침묵합니다. 읽고, 감사하고, 수정할 수 있는 저장소는 이러한 습관을 복원하며, 이것이 바로 AI가 기억하는 내용 감사하기의 목적입니다.

• 확장자 변경과 frontmatter 재작성을 한 번에 수행하세요. .cursor/rules에 있는 .md 파일은 오류 없이 무시됩니다.
• agent_requested 설명을 유지하세요. Cursor는 관련성 기반 포함을 위해 동일한 방식으로 description을 사용합니다.
• 줄글 범위를 globs로 변환하세요. Cursor는 컨텍스트 내 일치하는 파일에 자동 첨부하므로, 조건을 설명하는 것보다 효과적입니다.
• 규칙의 평탄화를 해제하세요. Cursor는 중첩된 규칙 디렉토리를 허용합니다. Augment는 작업 공간 루트에서만 .augment/rules/를 로드했습니다.
• AGENTS.md를 그대로 이동하세요. 두 도구 모두 루트 및 하위 디렉토리에서 이를 읽습니다.
• Team Rules는 강제 적용을 위해서만 남겨두세요. Team Rules는 자유 형식이고, glob이 가능하며, 우선순위 체인의 맨 위에 있고, 선택적으로 비활성화할 수 없게 설정할 수 있습니다.
• 떠나기 전에 VFS 메모리를 읽으세요. 읽기 쉬운 마크다운 형식이며, 자동으로 내보내 주는 도구는 없습니다.
• 검토 습관을 스스로 다시 구축하세요. Augment는 거부를 위해 새로운 메모리를 표면화하고 충돌을 표시했지만, 규칙 파일은 둘 다 수행하지 않습니다.

이 마이그레이션의 규칙 부분은 이름 변경과 frontmatter 재작성뿐이며, Cursor의 glob 범위 지정 모드와 중첩 디렉토리는 기존 환경보다 확실히 개선된 점을 제공합니다.

계획할 가치가 있는 부분은 Augment의 Experts 메모리입니다. 이는 팀 범위 지정, 자체 기록, 두 가지 증거 모델 및 거부 단계를 갖춘 실제 시스템인 반면, 지속성에 대한 Cursor의 문서화된 답변은 규칙이며 이는 다른 역할을 합니다. 전환하기 전에 해당 저장소를 읽고, 찾은 내용을 지침과 사실로 분리하고, 매 프롬프트마다 컨텍스트 비용을 청구하지 않는 곳에 사실을 보관하세요.