Cursor한테 “이 프로젝트 리팩토링해줘”라고 했다가 node_modules 폴더를 통째로 날린 적 있다. 진심이다.
AI 코딩 도구가 강력해질수록, 그걸 제어하는 기술도 중요해진다. 가드레일 코딩이 필요한 이유다.
가드레일이 뭔가
철도나 도로 옆에 설치된 방호벽을 생각하면 된다. 차가 길을 벗어나지 않도록 막아주는 그것. AI 코딩에서의 가드레일도 비슷하다. AI가 코드를 생성할 때 특정 범위 안에서만 동작하도록 제한하는 규칙들이다.
실용적인 가드레일 예시
파일 시스템 제한
- “src/ 폴더 안에서만 작업해”
- “config/ 폴더는 읽기만 해”
- “.env 파일은 절대 건드리지 마”
코드 패턴 강제
- “React 컴포넌트는 함수형으로만 작성해”
- “API 호출은 반드시 try-catch로 감싸”
- “console.log 대신 logger 사용해”
외부 의존성 제한
- “새 패키지 설치 금지”
- “기존 package.json에 있는 것만 써”
구현 방법
대부분의 AI 코딩 도구는 시스템 프롬프트나 설정 파일을 지원한다. Cursor는 .cursorrules 파일을, Claude는 시스템 프롬프트를 사용한다.
# .cursorrules 예시
- 이 프로젝트는 TypeScript만 사용합니다
- src/core/ 폴더의 파일은 수정하지 마세요
- 모든 새 함수에는 JSDoc 주석을 추가하세요
- 테스트 파일은 __tests__ 폴더에 생성하세요이게 100% 지켜지진 않는다. AI는 확률적으로 동작하니까. 하지만 80%만 지켜져도 삽질 시간이 확 준다.
경험에서 우러난 팁
구체적으로 써라: “깔끔하게 코드 짜줘”보다 “함수당 20줄 이내로 작성해”가 낫다.
예시를 줘라: 원하는 코드 스타일의 샘플 파일을 보여주면 훨씬 정확하다.
점진적으로 추가해라: 처음부터 100개 규칙 넣으면 AI가 혼란스러워한다. 문제 생길 때마다 하나씩 추가.
생각해볼 점
가드레일이 많아지면 AI의 창의성이 줄어든다. 반대로 적으면 예상치 못한 사고가 난다. 적절한 균형을 찾는 게 개발자의 역량이 됐다.
20년 전에는 코드를 잘 짜는 게 실력이었다. 지금은 AI가 잘 동작하도록 환경을 설계하는 게 실력이다. 세상 참.
이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.
Categories:
