코딩하다가 AI가 갑자기 딴소리?! 🤯 Claude Code 한계 극복하기
혹시 Claude Code 쓰다가 “얘, 왜 이러지?” 싶었던 적 있으신가요? 분명히 잘 따라오다가 갑자기 엉뚱한 코드를 뱉어내거나, 전에 했던 실수를 반복하는 경우! 저도 몇 번 겪어봤는데요. 이 모든 게 바로 ‘컨텍스트 롯(Context Rot)’ 때문이라고 합니다. AgentOS 채널에서 이 문제와 해결책을 아주 명쾌하게 설명해주는 영상을 발견했어요.
이번 영상에서는 Claude Code의 한계점을 짚어보고, 그걸 극복하기 위해 개발된 ‘GSD(Get Shit Done)’라는 메타 프롬프팅 시스템을 소개합니다. 평소 AI 코딩에 관심 많았다면 완전 꿀팁 얻어갈 수 있을 거예요! 바로 영상 먼저 보시죠!
GSD, 너 도대체 뭐하는 녀석이니?
영상을 보면서 가장 먼저 와닿았던 건 ‘컨텍스트 롯’이라는 개념이었어요. 쉽게 말해, Claude Code의 기억력이 한계에 부딪히는 현상인데요. 마치 메모장처럼 작동하는 컨텍스트 윈도우라는 공간이 꽉 차면, 이전에 정했던 규칙을 잊거나 실수를 반복하게 되는 거죠. 프로젝트가 커질수록 이런 문제는 더 심각해진다고 합니다.
이런 문제를 해결하기 위해 등장한 게 바로 ‘GSD’인데요. 클로드 코드 위에 설치해서 사용하는 메타 프롬프팅 시스템이라고 해요. 쉽게 말해, 클로드 코드가 코드를 더 잘 짜도록 컨텍스트를 관리해주는 똑똑한 도우미 같은 거죠. 실제로 아마존, 구글, 쇼피파이 엔지니어들도 사용하고 있다고 하니, 그 효과가 더욱 기대되더라고요.
GSD 작동 방식, 5단계로 뽀개기!
GSD는 5단계 과정을 통해 컨텍스트 롯 문제를 해결하고 코드 품질을 높인다고 합니다. 5단계는 다음과 같아요.
- 프로젝트 초기화:
/GSD뉴 프로젝트명령어로 프로젝트를 생성합니다. 이때 GSD가 프로젝트 목표, 기술 스택, 제약 조건 등을 물어보면서 기획을 구체화하죠. - 논의:
/GSD 디스커스 페이지명령어로 각 단계의 모호한 부분을 명확히 합니다. 예를 들어 “레이아웃은 어떻게 할까요?”, “에러 처리는 어떻게 할까요?” 같은 질문을 던져 사용자의 의도를 파악하는 거죠. 이 단계를 건너뛰면 클로드 코드가 알아서 결정해버리니 주의해야 해요! - 계획:
/GSD 플랜 페이지명령어를 통해 GSD가 필요한 라이브러리나 패턴을 먼저 리서치합니다. 이후 테스크 이름, 수정할 파일, 구체적인 행동, 검증 방법 등이 포함된 계획서를 만들어요. - 실행:
/GSD 엑스ec큐트 페이지명령어로 GSD가 계획서들을 웨이브 단위로 묶어 실행합니다. 의존성이 없는 계획서들은 동시에, 있는 것들은 순차적으로 실행하죠. 신기한 건 각 계획서 실행 시 새로운 서브 에이전트가 생성돼서 신선한 컨텍스트(20만 토큰)를 제공한다는 점! - 검증:
/GSD 베리파이 워크명령어로 자동 검증을 수행합니다. 코드가 잘 만들어졌는지, 테스트는 통과하는지 확인하고, 사용자에게 직접 확인해달라고 요청하기도 합니다. 문제가 생기면 디버그 에이전트가 나서서 원인을 분석하고 수정 계획서를 만들어 다시 실행한다고 하네요.
이처럼 GSD는 질문, 논의, 계획, 실행, 검증 사이클을 반복하면서 프로젝트를 진행하는데요. 마치 숙련된 개발팀과 협업하는 듯한 느낌을 준다고 할까요? 놀라웠던 건, 테스크가 완료될 때마다 자동으로 Git 커밋이 이루어진다는 점이었어요. 진짜 똑똑하죠?
컨텍스트 롯, 이제 안녕! GSD 핵심 장점 파헤치기
GSD가 컨텍스트 롯을 방지하는 핵심 메커니즘은 크게 세 가지라고 합니다.
- 서브 에이전트 격리: 각 서브 에이전트는 독립적인 컨텍스트를 가지기 때문에, 메인 컨텍스트 과부하를 막고 컨텍스트 롯을 방지합니다.
- 구조화된 정보 전달: GSD는 각 단계 산출물을 구조화된 마크다운 파일로 저장하고, 필요한 정보만 서브 에이전트에게 전달합니다. 불필요한 채팅 히스토리를 없애서 컨텍스트 품질을 높이는 거죠.
- 원자적 계획: GSD는 계획서를 서브 에이전트 컨텍스트 안에서 완결될 수 있는 크기로 쪼개고, 각 계획서 안에 검증 단계를 포함시킵니다.
쉽게 비유하자면, 팀장(오케스트레이터)이 팀원들에게 필요한 기획서만 보고 일을 시키는 것과 같아요. 핵심만 정리된 2만 토큰이 잡다하게 섞인 10만 토큰보다 훨씬 효과적인 것처럼요. 일을 시킬 때 완료 후 확인해야 할 사항까지 명확하게 제시하는 것과 같다고 할까요?
단순한 문제 해결을 넘어, 컨텍스트 엔지니어링으로!
GSD는 단순히 컨텍스트 롯을 해결하는 것 이상으로, AI와 인간 사이의 커뮤니케이션 문제까지 해결해준다고 합니다. 여기서 중요한 개념이 바로 ‘컨텍스트 엔지니어링’인데요. AI에게 올바른 컨텍스트를, 올바른 타이밍에, 올바른 형태로 전달하는 기술을 의미합니다.
예전에 ‘프롬프트 엔지니어링’이 유행했던 거 기억하시나요? 프롬프트 엔지니어링이 “어떻게 말하느냐”의 문제였다면, 컨텍스트 엔지니어링은 “무엇을, 언제, 얼마나 보여주느냐”의 문제라고 할 수 있어요. GSD의 모든 기능(질문, 문서화, 서브 에이전트 활용)은 결국 올바른 컨텍스트를 추출하고, 구조화하고, 전달하기 위한 노력인 거죠.
영상을 보면서 개인적으로 인상 깊었던 건, “AI에게 일을 제대로 시키려면 컨텍스트를 설계해야 한다”는 부분이었어요. 결국 AI 도구의 성능이 아무리 좋아지더라도, 우리가 “무엇을 넣느냐”가 가장 중요하다는 거죠. 마치 좋은 재료가 좋은 음식을 만드는 것처럼요.
GSD 없이도 클로드 코드 효율 높이는 방법!
GSD를 당장 사용하지 않더라도, 영상에서 소개된 세 가지 원칙을 통해 클로드 코드 경험을 향상시킬 수 있다고 합니다.
- 대화 축소, 문서 확대: 클로드 코드와 채팅으로 소통하는 대신, 프로젝트 구조나 반복적인 지시사항을 문서로 정리하세요.
- 작업 분할: 큰 작업을 잘게 쪼개서 클로드 코드에게 지시하세요. 로그인 API 개발처럼 구체적인 목표와 스펙, 검증 방법을 명시하는 게 중요합니다.
- 자동 검증: 테스트 코드를 먼저 작성하고, 클로드 코드에게 구현을 맡기세요. 테스트 통과 여부를 통해 결과물을 검증하고 안전망을 확보할 수 있습니다.
저도 앞으로 클로드 코드를 사용할 때 이 원칙들을 꼭 적용해봐야겠다고 생각했어요.
마무리하며
이번 AgentOS 영상 덕분에 클로드 코드의 한계와 그걸 극복할 수 있는 방법에 대해 제대로 알게 됐어요. 특히 ‘컨텍스트 엔지니어링’이라는 개념은 앞으로 AI를 활용하는 데 있어서 정말 중요한 인사이트를 제공해주는 것 같아요. AI 코딩에 관심 있는 분들이라면 꼭 한번 시청해보시길 추천합니다! 저도 GSD 한번 써봐야겠어요! 😉