Cline 최신 릴리스, 세 가지 무음 컨텍스트 손실 해결 — 다시 확인해야 할 규칙, Hook 및 장기 작업 요약 (2026)

첫 번째 수정 사항은 규칙(rules)과 관련이 있습니다. 릴리스 노트에 따르면 다음과 같습니다. "Rules 패널에는 .clinerules와 Documents 글로벌 폴더만 표시되었기 때문에, .cline/rules, ~/.cline/rules 또는 ~/Cline/Rules에서 로드된 규칙은 모델에 적용되었지만 패널에서는 누락되었습니다. 그리고 OneDrive로 리디렉션된 Documents 폴더를 사용하는 Windows 환경에서는 글로벌 규칙을 전혀 찾을 수 없었습니다."

이 문장 안에는 두 가지 실패 사례가 들어 있습니다. 세 가지 경로에서 규칙이 작동은 했지만 보이지 않았던 문제와, OneDrive 리디렉션이 적용된 Windows에서 글로벌 규칙이 전혀 로드되지 않았던 문제입니다.

두 번째 수정 사항은 hook과 관련이 있습니다. "UserPromptSubmit 및 TaskStart hook이 다시 컨텍스트를 주입할 수 있게 되었습니다. 이 hook들이 contextModification으로 반환한 값이 누락되고 cancel만 유지되었기 때문에, 저장소 정보나 내부 규칙을 작업에 추가하려던 hook이 아무런 동작도 하지 않았습니다." 릴리스 노트는 이 컨텍스트가 "이제 회귀(regression) 이전과 동일하게 실행의 첫 번째 요청에서 <hook_context> 블록으로 전달된다"고 덧붙였습니다.

세 번째 수정 사항은 장기 작업과 관련이 있습니다. "장기 작업을 수행하는 도중에 compaction이 더 이상 truncation으로 조용히 폴백되지 않습니다. summarizer가 작업 시작 시 캡처된 자격 증명(credentials)을 계속 유지하고 있었기 때문에, 자격 증명이 갱신되면 요청이 권한 오류로 실패하고 이 오류가 무시되었습니다. 이제는 작업의 현재 자격 증명과 모델을 따릅니다."

CLI 릴리스는 사용자 측면에서 동일한 실패 현상을 다음과 같이 설명합니다. "요약본 대신 잘려 나간 대화 기록(chopped transcript)을 받게 되며, 이는 특히 cline-free/* 모델에서 가장 두드러지게 나타났습니다." 또한 "세션 중간에 모델을 전환한 후에도 summarizer가 원래 모델에 머물러 있었다"고 언급합니다.

데스크톱 릴리스는 한 걸음 더 나아갑니다. "데스크톱 앱의 긴 세션이 이제 자동으로 compact됩니다. 이전에는 이곳에서 자동 compaction(Auto-compaction)이 실제로 실행된 적이 없었습니다." 그리고 이것이 최근의 문제가 아니었음을 명시합니다. "이것은 최근의 회귀가 아니었습니다. 이 공백은 지난 4월 코어에서 compaction이 선택 사항(opt-in)으로 변경된 시점까지 거슬러 올라갑니다."

CLI 및 SDK 노트 모두에 compaction 관련 변경 사항이 하나 더 등장합니다. 기존에는 글자 수 추정치(character estimate)를 기준으로 compaction이 트리거되었으나, 밀도가 높은 콘텐츠의 경우 이 추정치가 어긋났습니다. "이제 compaction은 글자 수 추정치 대신 제공업체의 실제 토큰 사용량을 기준으로 실행됩니다." CLI 노트는 기존의 증상을 명확히 설명합니다. 긴 세션이 "실제 컨텍스트 한계에 도달할 때까지 전혀 compact되지 않다가, 결국 턴당 극소수의 출력 토큰만 제공하는 상태로 압착될 수 있었습니다."

가장 중요한 경계선부터 시작하겠습니다. 릴리스 노트는 업데이트하는 순간부터 코드가 어떻게 작동하는지 설명합니다. 이 노트의 어떤 내용도 업데이트 전에 실행된 세션을 복구하는 것에 대해 설명하지 않습니다. 지난 8월에 잘려 나간(truncated) 작업은 그대로 잘려 나간 대화 기록으로 남습니다.

hook 수정 사항 역시 보기보다 범위가 좁습니다. CLI 릴리스 노트는 "실행 시작 hook 제어(agent_start/agent_resume 스크립트의 cancel 및 컨텍스트 주입)는 의도적인 옵트인(opt-in)이 있을 때까지 CLI에서 비활성 상태로 유지됩니다"라고 명시하고 있습니다. 따라서 hook이 CLI를 통해 실행되는 경우, 이번 익스텐션의 수정 사항은 사용자의 설정에 해당하지 않습니다.

규칙 수정 사항은 패널에 표시되는 내용을 변경하며, 문서에서 약속한 바가 실제로 무엇을 의미하는지 바꿉니다. Cline의 규칙 페이지에는 다음과 같이 나와 있습니다. "감지된 모든 규칙 유형은 Rules 패널에 표시되며, 여기에서 개별적으로 토글할 수 있습니다." v4.1.20 이후로 이 문장은 수정 사항에 언급된 세 가지 경로에 대한 익스텐션의 동작을 정확히 설명합니다. 그전에는 해당 경로의 규칙들이 적용은 되었지만 목록에는 표시되지 않았습니다.

이는 패널을 체크리스트로 사용하던 모든 사람에게 직접적인 영향을 미칩니다. 이전에 작성된 작업 시작 전 활성화된 Cline 규칙 매핑 가이드에서는 패널을 감지된 규칙의 인벤토리로 취급합니다. v4.1.20 이전 버전에서는 .cline/rules, ~/.cline/rules, ~/Cline/Rules에 있는 규칙들이 모델에 전달되면서도 인벤토리에는 누락되어 있었습니다. 해당 가이드의 이중 게이트 논리(패널 토글 및 규칙 자체의 조건)는 여전히 유효하지만, 인벤토리 단계가 완전해지려면 최신 버전이 필요합니다.

compaction 수정 사항은 새로운 설계를 도입하기보다는 문서화된 원래 설계를 복원한 것입니다. Cline의 Auto Compact 페이지는 의도된 동작을 "지금까지 일어난 모든 일에 대한 포괄적인 요약을 생성"하고 "대화 기록을 요약본으로 대체"하는 것으로 설명하며, 이전 방식과 대조합니다. "이전에는 컨텍스트 제한에 도달하면 Cline이 오래된 메시지를 잘라내어(truncate) 중요한 컨텍스트를 잃어버렸습니다." 버그로 인해 영향을 받은 장기 작업들은 아무런 알림 없이 이전의 동작 방식으로 돌아갔던 것입니다.

또한 동일한 페이지에서 일부 모델의 경우 여전히 truncation이 기본 설계임을 명시하고 있습니다. "다른 모델의 경우, Auto Compact가 활성화되어 있더라도 Cline은 표준 규칙 기반 컨텍스트 truncation으로 폴백합니다." 따라서 이번 릴리스 이후에 발생하는 truncation이 무조건 버그인 것은 아닙니다. 이는 해당 작업이 어떤 모델에서 실행되고 있었는지 확인해야 한다는 신호입니다.

가장 먼저 퍼질 오해는 "Cline이 내 규칙을 무시하고 있었다"는 생각일 것입니다. 대부분의 사용자에게 이 노트는 그런 의미가 아닙니다. 세 가지 경로의 규칙은 "모델에 적용되었지만 패널에서 누락"되었을 뿐입니다. 모델은 규칙을 따르고 있었고, 단지 사용자가 볼 수 없었을 뿐입니다. 예외는 OneDrive로 리디렉션된 Documents 폴더를 사용하는 Windows 환경으로, 여기서는 글로벌 규칙을 "전혀 찾을 수 없었습니다." 이 그룹에 속한 사용자들은 이번 수정을 단순한 표시 방식의 변경이 아닌 실제 동작의 변화로 받아들여야 합니다.

두 번째 오해는 compaction이 신뢰할 수 없으므로 꺼두어야 한다는 생각입니다. 이는 인과관계를 거꾸로 해석한 것입니다. 요약(summarization)은 truncation을 대체하기 위한 것이며, 이번 실패는 summarizer가 조용히 작업을 truncation으로 넘겨버린 문제였습니다. compaction을 끄는 것은 이전의 동작을 피하는 것이 아니라, 장기 작업 공간이 부족해질 때 이전 동작이 확실히 발생하도록 보장하는 결과를 낳습니다.

세 번째 오해는 이제 hook이 모든 곳에서 작동한다는 생각입니다. 익스텐션의 UserPromptSubmit 및 TaskStart 경로에서는 다시 작동합니다. 하지만 CLI 노트는 실행 시작 시의 컨텍스트 주입이 "의도적인 옵트인이 있을 때까지 CLI에서 비활성 상태로 유지된다"고 명시하고 있으며, SDK 릴리스는 이를 기반으로 빌드하는 호스트를 위한 새로운 실행 시작 채널을 설명합니다. hook이 실행되는 환경에 따라 이 중 어떤 문장이 적용되는지가 결정됩니다.

가장 경계해야 할 일반적인 오해는 패널, hook 또는 요약이 존재한다는 사실 자체가 컨텍스트가 제대로 전달되었음을 증명한다고 믿는 것입니다. 이번 릴리스는 눈에 보이는 화면과 실제 컨텍스트가 일치하지 않았던 세 가지 사례를 기록하고 있습니다. 이는 에이전트가 지침 파일을 무시하는 것처럼 보이는 현상과 동일한 범주의 문제입니다. 문제는 파일의 존재 여부가 아니라, 특정 세션이 해당 파일을 실제로 로드했는지 여부인 경우가 대부분입니다.

지나간 세션에서 누락된 컨텍스트를 사후에 검사할 수는 없습니다. 하지만 현재 사용 중인 모든 Cline 환경에서 최신 버전이 실행되고 있는지 확인하고, 도구 외부에 보관된 기록과 세 가지 채널을 대조해 볼 수는 있습니다.

1단계: 실제로 사용하는 모든 Cline 환경 업데이트하기

수정 사항은 환경별로 개별 배포되었습니다. VS Code 익스텐션 수정 사항은 v4.1.20에 포함되어 있습니다. 데스크톱 앱의 compaction 및 규칙 수정 사항은 데스크톱 v0.0.33에 포함되어 있습니다. CLI의 compaction, 토큰 트리거 및 규칙 수정 사항은 cli-v3.0.63에 포함되어 있습니다. 익스텐션과 CLI 간에 작업을 이동하며 사용하는 경우, 릴리스 노트가 각 환경의 동작을 개별적으로 설명하므로 두 환경 모두 최신 상태여야 합니다.

각 환경의 버전을 기록해 두세요. 다음 달에 동작 관련 의문이 생겼을 때 가장 먼저 확인해야 할 정보입니다.

2단계: 디스크에서 규칙 인벤토리를 파악한 후 패널과 비교하기

패널에서 시작하지 마세요. Cline 문서에 명시된 경로에서 시작하여 실제로 어떤 파일이 있는지 목록을 만드세요.

워크스페이스 규칙은 .clinerules/ 또는 .cline/rules/에 위치할 수 있습니다. 문서에 따르면 "두 디렉터리가 모두 존재하면 둘 다 검색하므로 규칙을 두 위치 모두에 복사할 필요는 없습니다." 글로벌 규칙은 Documents 아래의 Cline Rules 폴더에 위치하며, 문서에는 "Cline은 글로벌 규칙을 찾기 위해 ~/.cline/rules 및 ~/Cline/Rules도 검색합니다"라고 명시되어 있습니다. Windows의 경우 OneDrive로 리디렉션된 Documents 경로도 확인합니다. 또한 Cline은 "~/.agents/AGENTS.md에서 도구 간 글로벌 AGENTS 지침을 읽습니다."

찾은 모든 파일의 목록을 작성한 다음, 업데이트된 익스텐션에서 Rules 패널을 열고 하나씩 체크해 보세요. 업데이트 후에도 디스크에는 존재하지만 패널에서 누락된 항목이 있다면 제보할 가치가 있습니다. 패널에 표시된 예상치 못한 항목(예: 오래된 도구의 파일, 수년 전에 작성된 글로벌 규칙)이 있다면 확인해 볼 필요가 있습니다. 이번 릴리스 이전에는 이러한 규칙 중 일부가 패널에 표시되지 않은 채 모델에 전달되고 있었기 때문입니다.

OneDrive를 사용하는 Windows 환경이라면 한 가지 더 확인하세요. 신뢰하고 있던 글로벌 규칙이 이제 실제로 적용되고 있는지 확인해야 합니다. 릴리스 노트에 따르면 해당 규칙들을 "전혀 찾을 수 없었다"고 하므로, 업데이트 후 동작이 달라질 수 있습니다.

3단계: 긴 작업을 하나 실행하고 눈에 보이는 신호 확인하기

Cline의 Auto Compact 페이지는 눈에 보이는 신호를 다음과 같이 설명합니다. "이 작업이 수행되면 다른 API 호출과 마찬가지로 비용을 보여주는 요약 도구 호출(summarization tool call)이 표시됩니다." 장기 작업을 진행할 때 이 호출이 나타나는지 확인하세요. Auto Compact를 지원하는 모델에서 장기 작업을 수행하는 도중 공간이 부족해졌음에도 요약 호출이 나타나지 않는다면, 그것이 바로 이번 수정 사항이 설명하는 버그 케이스입니다. 제보하기 전에 버전과 모델명을 캡처해 두는 것이 좋습니다.

hook의 경우, hook이 주입하는 컨텍스트에 날짜가 포함된 한 줄짜리 무해한 마커를 추가하고, 작업 시작 시 에이전트에게 이를 다시 말해달라고 요청해 보세요. 에이전트가 이를 반복할 수 있다면 컨텍스트가 제대로 전달된 것입니다. CLI를 통해 hook을 실행하는 경우, 노트에 언급된 "비활성 상태 유지" 동작을 예상하고 그에 맞게 계획을 세우십시오.

이 세 가지 확인 작업의 밑바탕에 깔린 일반적인 원칙은 auto-compact가 실행될 때 보존해야 할 사항에 언급된 내용과 같습니다. 긴 세션 동안 어떤 사실이 반드시 유지되어야 하는지 미리 결정하고, 요약 과정에서 누락되지 않도록 안전한 곳에 보관하는 것입니다.

위의 세 가지 확인 작업은 모두 한 가지 전제 조건에 의존합니다. 바로 에이전트가 알아야 할 사항을 도구 외부에 짧은 기록으로 보관하는 것입니다. MemoryLake는 특정 세션에서 패널, hook 또는 summarizer가 올바르게 작동했는지 여부와 관계없이 해당 기록을 안전하게 보관할 수 있는 공간입니다.

기록은 사용자가 직접 본인의 언어로 작성합니다. Cline의 규칙 폴더, 작업 기록 또는 타사 저장소에서 데이터를 읽거나 쓰거나 삭제하지 않습니다.

1단계: API 키 생성하기

로그인한 후 대시보드에서 키를 생성합니다. 이 키를 통해 에이전트는 현재 어떤 Cline 환경(익스텐션, 데스크톱, CLI)에서 작업을 실행 중인지와 관계없이 사용자가 작성한 기록을 읽을 수 있습니다.

2단계: 첫 번째 기억 업로드하기

대화 기록이 잘려 나갈 때 가장 먼저 손실될 수 있는 정보부터 시작하세요. 장기 작업 초기에 내려진 결정, hook이 주입하려 했던 제약 조건, 글로벌 폴더에 있는 내부 규칙 등이 이에 해당합니다. 항목당 하나의 사실을 이유와 함께 기록합니다.

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

에이전트가 워크스페이스를 바라보도록 설정하세요. 이제 모든 작업이 시작될 때 해당 결정 사항들을 사용할 수 있으므로, 긴 세션이 진행되면서 초기 대화 내용이 유실되더라도 중요한 부분은 그대로 유지됩니다.

첫 번째 실질적인 변화는 패널이 가질 수 있는 신뢰도입니다. 업데이트 후 패널은 더 나은 인벤토리 역할을 하게 되지만, 여전히 사용자의 의도를 기록한 것이라기보다는 Cline이 감지한 내용을 보여주는 뷰에 불과합니다. 자신만의 목록을 유지해야만 다음번에 발생할 수 있는 불일치를 그대로 수용하지 않고 알아차릴 수 있습니다.

두 번째는 장기 작업을 파악하는 방식입니다. 잘려 나간 대화 기록과 요약된 대화 기록은 대화 내부에서 비슷해 보일 수 있습니다. 두 경우 모두 에이전트가 시작할 때보다 적은 정보를 가지고 작업하기 때문입니다. 차이점은 초기의 결정 사항들이 살아남았는지 여부입니다. Cline이 작업 초기에 하던 일을 잊어버리는 현상을 겪어본 사람이라면 이 증상을 경험한 것입니다. 이번 릴리스는 그 원인 중 하나를 밝혀냈습니다.

세 번째는 Memory Bank의 용도입니다. Cline의 Memory Bank 가이드는 "일상적인 컨텍스트 관리는 Auto Compact에 맡기고" 수동 업데이트는 체크포인트용으로 남겨두라고 제안합니다. 이 조언은 Cline Memory Bank 설정 가이드에서도 반복됩니다. 이러한 역할 분담은 여전히 유효하지만, 이번 버전 이전의 환경에서는 주의가 필요합니다. 일상적인 컨텍스트 관리가 문서에 설명된 대로 항상 작동하지는 않았기 때문에, 체크포인트 파일이 예상보다 더 많은 부담을 지고 있었을 수 있습니다.

네 번째는 Cline을 위한 메모리 설정을 비교하는 방식입니다. 모든 것이 정상적으로 작동할 때의 동작뿐만 아니라, 하위 레이어에서 실패가 발생했을 때 무엇이 살아남는지를 기준으로 각 설정을 평가해야 합니다.

규칙 파일의 자체 인벤토리를 유지하세요. 경로 목록과 각 파일의 목적을 한 줄로 정리하는 것만으로도 충분합니다. 패널이 완전한지 확인할 수 있는 유일한 방법입니다.

증상이 발생한 버전을 기록하세요. 같은 날 세 가지 환경에 대해 별도의 수정 사항이 배포되었습니다. 환경과 버전을 명시한 제보라야 담당자가 조치를 취할 수 있습니다.

초기 결정 사항은 대화 기록 외부의 어딘가에 기록해 두세요. 장기 작업의 첫 한 시간은 truncation에 가장 취약한 부분입니다. 이후 작업이 의존하는 초기 결정 사항은 결정되는 즉시 따로 기록해 두어야 합니다.

주입된 컨텍스트에 마커를 표시하여 도달 여부를 확인하세요. hook의 출력에 날짜가 포함된 한 줄을 추가하면, "hook이 작동했는가"라는 질문을 단 한 번의 턴으로 확인할 수 있습니다.

기능을 탓하기 전에 모델을 확인하세요. Cline 문서에 따르면 일부 모델은 Auto Compact가 활성화되어 있어도 규칙 기반 truncation으로 폴백합니다. 이러한 모델에서의 truncation은 버그가 아니라 원래 설계된 동작입니다.

에이전트가 기억하고 있는 내용을 주기적으로 다시 검사하세요. AI가 기억하는 내용을 검사하는 것과 동일한 습관이 여기에도 적용됩니다. 가장 확실한 확인 방법은 에이전트에게 무엇을 알고 있는지 물어보고 그 답변을 자체 기록과 비교하는 것입니다.

Cline의 v4.1.20 릴리스 노트와 함께 발표된 데스크톱 및 CLI 노트는 일반적인 릴리스 노트와 달리 매우 구체적입니다. 패널이 놓친 경로, 폐기되고 있던 hook 결과, 그리고 summarizer가 실패한 정확한 원인을 명시하고 있습니다. 또한 이러한 공백 중 하나가 지난 4월까지 거슬러 올라간다는 사실도 솔직하게 밝히고 있습니다.

이 중 어떤 것도 이미 실행된 세션을 복구해 주지는 않습니다. 하지만 이번 업데이트는 우리가 확인해야 할 위치를 명확히 짚어줍니다. 디스크의 규칙과 패널의 비교, hook 컨텍스트와 에이전트가 반복할 수 있는 내용의 비교, 그리고 장기 작업에서 확인해야 할 요약 호출 등이 그것입니다.

모든 환경을 업데이트하고, 디스크에서 인벤토리를 파악하며, 중요한 결정 사항은 잘려 나간 대화 기록이 앗아갈 수 없는 곳에 보관하세요. 패널, hook, summarizer 모두 지난주보다 개선되었습니다. 하지만 이들 중 하나가 다시 오작동할 때 이를 알아차릴 수 있게 해주는 것은 결국 사용자가 직접 유지하는 기록입니다.