오래된 코드베이스에서 AI가 작동하도록 하는 커서 규칙 작성

4년 된 코드베이스에서 에이전트 중심 개발을 시작한 첫 주에는 우리가 몇 달 동안 싸워온 세 가지 팀 규칙과 한 가지 아키텍처 결정을 위반하는 아름다운 코드가 생성되었습니다. 수정 사항이 더 이상 프롬프트되지 않았습니다. 헌법을 쓰는 것이었습니다.

좋은 규칙 파일은 짧고 부정적입니다. 내 목록에는 코드베이스가 절대 하지 말아야 할 일이 나열되어 있습니다. 새로운 상태 관리 라이브러리가 없고, 날짜는 Date가 아닌 dayjs이며, 모든 API 경로는 기존 zod 스키마로 유효성을 검사하고, 요청하지 않고 레거시/ 아래의 파일을 절대 건드리지 않습니다. 열망이 아닌 제약 조건이 모델 행동을 변화시킵니다.

예상치 못한 승리는 각 규칙의 이유를 하나의 절에 문서화하는 것이었습니다. 지난 분기에 마이그레이션이 중단되었음을 알고 있는 모델은 단지 조심하라고 말한 것보다 더 신중하게 마이그레이션 코드를 작성합니다. 컨텍스트는 규칙을 준수한 규칙에서 이해한 규칙으로 변환하고, 이해된 규칙은 나열하지 않은 사례로 일반화합니다.

로컬 규칙을 위해 디렉터리별로 두 번째 규칙 파일을 유지하고, 내 구성 요소 폴더에는 자체 폴더가 있으며, 전역 규칙을 부풀리고 싶은 충동에 저항하세요. 나는 첫 번째 초안을 40줄에서 12줄로 줄였고 차이점은 더 좋아졌습니다. 추가하는 줄마다 중요한 줄이 희석되기 때문입니다.

6주 후에 측정 가능한 결과가 나타났습니다. 규칙을 위반하는 차이가 약 3분의 1에서 거의 줄어들었고, 코드 검토 주석이 스타일에서 논리로 다시 전환되었습니다. 규칙 파일은 내가 고용한 수석 엔지니어 중 가장 저렴한 것입니다.