코딩 에이전트는 많은 작업에서 뛰어나지만, 어떤 버그들은 여전히 쉽게 해결하지 못합니다. 그래서 우리는 런타임 정보와 사람의 검증을 중심으로 완전히 새롭게 설계된 Agent 루프인 Debug Mode를 도입했습니다.

이를 만들기 위해, 우리 팀에서 가장 뛰어난 디버거들의 디버깅 방식을 분석했습니다. 그들의 워크플로를 하나의 Agent 모드로 통합하면서, 런타임 로그를 삽입해 코드를 계측하는 도구, 무엇이 잘못되고 있는지에 대한 여러 가설을 생성하는 프롬프트, 그리고 문제를 재현하고 수정 사항을 검증하기 위해 여러분을 다시 호출할 수 있는 능력을 갖추게 했습니다.

그 결과, 이전에는 가장 뛰어난 모델조차 단독으로는 해결하지 못했거나, 해결하는 데 상당한 개발자 시간이 들었던 버그를 안정적으로 고칠 수 있는 대화형 프로세스를 구현했습니다.

#버그 설명하기

시작하려면 드롭다운 메뉴에서 Debug Mode를 선택하고, 버그에 대해 가능한 한 자세히 설명하세요.

에이전트는 곧바로 버그를 고치려 하지 않고, 먼저 코드베이스 전체를 살펴보며 무엇이 문제일 수 있는지에 대한 여러 가설을 세웁니다. 그중 일부는 여러분이 스스로도 떠올렸을 법한 아이디어겠지만, 다른 일부는 아마 생각하지 못했을 만한 접근 방식일 것입니다.

그다음 에이전트는 이러한 가설을 검증하기 위해 로그를 남기는 코드를 여러분의 코드에 삽입합니다. 이를 통해 버그가 발생할 때 실제로 어떤 일이 일어나는지에 대한 구체적인 데이터를 에이전트가 수집할 준비를 하게 됩니다.

#버그 재현하기

다음으로, 애플리케이션에서 에이전트가 런타임 로그를 수집하는 동안 버그를 재현하세요.

에이전트는 버그가 발생하는 순간 코드에서 어떤 일이 일어나는지, 예를 들어 변수 상태, 실행 경로, 타이밍 정보까지 정확히 파악할 수 있습니다. 이 데이터를 바탕으로 근본 원인을 정확히 찾아내고, 그에 맞는 수정안을 생성할 수 있습니다. 이렇게 하면 일반적인 에이전트 사용에서 받게 될 수백 줄의 추측성 코드 대신, 두세 줄 정도의 정밀한 수정만으로 문제를 해결할 수 있는 경우가 많습니다.

#수정 사항 검증하기

이 시점에서 Debug Mode는 제안된 수정이 적용된 상태에서 버그를 한 번 더 재현해 보라고 요청합니다. 버그가 사라졌다면 버그가 수정되었다고 표시하면, 에이전트가 모든 계측 코드를 제거하고 바로 배포할 수 있는 깔끔하고 최소한의 변경만 남겨 둡니다.

이런 사람 개입형(human-in-the-loop) 검증 과정은 매우 중요합니다. 어떤 버그는 명확하지만, 다른 버그들은 수정이 기술적으로는 동작하더라도 뭔가 어색하게 느껴지는 애매한 영역에 속하기도 합니다. 에이전트는 이런 판단을 스스로 내릴 수 없습니다. 버그가 완전히 고쳐지지 않았다고 생각되면, 에이전트가 로그를 더 추가하고 다시 재현해 보게 한 뒤, 문제가 정말로 해결될 때까지 접근 방식을 계속 다듬습니다.

이처럼 빠르게 피드백을 주고받는 상호작용은 우리가 생각하는 AI 코딩의 가장 효과적인 방식 중 하나입니다. 에이전트가 지루한 작업을 처리하는 동안, 여러분은 사람의 판단이 필요한 빠른 결정만 내려 주면 됩니다. 그 결과 Debug Mode를 사용하면 예전에는 손대기 어려웠던 까다로운 버그들도 이제는 안정적으로 고칠 수 있습니다.

Debug Mode 문서를 읽어보세요. Cursor 2.2의 모든 신규 기능도 함께 살펴보세요.