.cursorrules를 처음 만들었을 때를 떠올려보자. 팀의 아키텍처 원칙, 사용 금지 패턴, 네이밍 컨벤션—모두 정성스럽게 적어뒀다. 첫 주는 완벽했다. 에이전트는 규칙을 따랐고, 코드는 일관성을 유지했다. 그런데 한 달쯤 지나면 이 파일은 조용히 거짓말쟁이가 된다.
팀은 캐싱 전략을 바꿨지만 파일에는 이전 전략이 남아 있다. 느슨해진 제약 조건은 슬랙 쓰레드에서 합의됐지만 파일에는 여전히 강제 규칙으로 적혀 있다. 새로 합류한 멤버가 PR 코멘트에서 결정한 패턴은 어디에도 기록되지 않았다. dev.to의 Ali Abbas가 정확하게 짚었듯, 이건 팀의 규율 문제가 아니다. 손으로 관리하는 컨텍스트 아티팩트는 구조적으로 실패할 수밖에 없다. 사람은 흐름 중간에 멈춰서 나중에 도움이 될지 불확실한 것을 기록하지 않는다. 수십 년간 축적된 증거가 그것을 말해준다.
문제는 ADR(Architecture Decision Record)이 죽어가던 시절보다 지금 비용이 훨씬 더 크다는 점이다. 낡은 ADR은 미래의 개발자를 잘못 안내했다. 하지만 낡은 .cursorrules는 점심시간 전에 열두 개 파일에 걸쳐 지난 분기 아키텍처를 전파하는 빠른 에이전트를 조종한다. 권위를 가진 채 틀린 컨텍스트—이것이 아무 규칙도 없는 것보다 더 나쁜 이유다.
여기에 Claude Sonnet 5 출시가 더해지면 문제의 규모가 달라진다. Anthropic이 6월 30일 공개한 Sonnet 5는 '끝까지 해내는' 에이전트다. 이전 Sonnet이 중간에 멈추던 복잡한 작업을 완수하고, 요청하지 않아도 결과를 스스로 검증한다. 얼리 액세스 파트너들의 증언은 한결같다—PR 수십 건을 테스트·검증까지 스스로 끌고 갔고, 버그를 재현 테스트로 확인한 뒤 수정하고, 변경을 되돌려 버그가 다시 나타나는지까지 확인했다. 더 적은 단계로 더 많은 일을 해낸다.
즉, 에이전트의 실행 능력이 높아질수록 컨텍스트의 품질이 결과의 품질을 결정하는 비중이 커진다. 약한 에이전트는 틀린 규칙을 무시하거나 중간에 멈춘다. 강한 에이전트는 틀린 규칙을 끝까지, 자신감 있게 완수한다. Sonnet 5급 모델이 저렴하게 일상화된 지금, .cursorrules 엔트로피는 단순한 불편함이 아니라 실질적 리스크다.
해법은 더 열심히 파일을 업데이트하는 게 아니다. 구조를 역전시키는 것이다. 결정이 이미 일어나는 곳—PR 쓰레드, 슬랙 채널, 지라 티켓—에서 선택지와 근거, 기각된 대안을 끌어내고, 거기서 에이전트가 읽을 규칙을 자동으로 생성해야 한다. 파일은 지친 인간이 큐레이션하는 대상이 아니라 팀이 이미 내리고 있는 결정의 투영이 되어야 한다.
이 설계에서 가장 가치 있는 필드는 기각된 옵션이다. "X를 시도했는데 이런 이유로 실패했다, 다시 꺼내지 말 것"—이 한 줄이 에이전트의 회귀를 실제로 막는다. 기존 도구 대부분이 이 필드를 버린다는 게 아이러니다. 그리고 컨텍스트는 단일 표면이 아니다. '왜'는 슬랙과 GitHub과 지라에 흩어져 있다. 하나의 표면만 보는 자동화는 대부분의 결정 이유를 놓친다.
또 하나 중요한 원칙이 있다. 생성 시점의 제약이 결과물 검토 후 경고보다 열 배 가치 있다. 에이전트가 코드를 만들기 전에 읽는 컨텍스트가, 만들어진 코드를 사후에 검토하는 린트 규칙보다 훨씬 효과적이다. 이건 프론트엔드 개발자에게 익숙한 논리다—런타임 에러보다 타입 에러가 낫고, 타입 에러보다 설계 단계에서 잡는 게 낫다.
지금 당장 확인할 것이 하나 있다. 당신의 .cursorrules에서 가장 오래된 줄—그것이 지금도 사실인가? 다섯 개의 뻔한 규칙은 있고, 팀이 힘들게 배운 결정은 없다면 이유는 하나다. 형식이 인간의 본성과 싸우고 있기 때문이다.
Sonnet 5가 Opus 4.8에 근접한 성능을 더 낮은 비용에 제공하면서, 에이전트를 일상 워크플로우에 붙이는 팀이 빠르게 늘고 있다. 이 흐름에서 컨텍스트 설계는 선택이 아니다. 에이전트가 강해질수록, 그것이 읽는 컨텍스트의 정확성이 팀의 실질적 출력 품질을 결정한다. .cursorrules를 더 자주 업데이트하는 것—그 방향으로 에너지를 쓰는 팀은 구조적으로 질 수밖에 없다. 결정이 일어나는 곳에서 컨텍스트를 자동으로 만들어내는 파이프라인을 설계하는 팀이 이긴다.