AI 코딩은 규칙 문서가 있어야 덜 흔들린다는 주장

r/vibecoding의 한 글은 AI에게 코딩을 맡길 때 규칙을 문서로 남겨야 한다고 말합니다. 핵심은 AI 에이전트가 같은 실수를 반복하지 않게 해서 시간과 토큰 비용을 줄이자는 것입니다.

이 글의 제목은 “Vibe coding is broken until we document the rules”입니다. 즉, 감으로 AI에게 코드를 시키는 방식은 프로젝트 규칙이 정리되어 있지 않으면 쉽게 망가질 수 있다는 문제 제기입니다. 글은 커뮤니티에 도움을 요청하는 형태라, 새 도구 출시나 숫자 자료보다는 실무 습관에 가까운 내용입니다.

실제 의미는 단순합니다. AI 에이전트에게 “이 프로젝트에서는 어떤 파일을 건드리지 말라”, “테스트를 꼭 돌려라”, “비밀키를 코드에 넣지 말라” 같은 규칙을 미리 알려주면 불필요한 재작업을 줄일 수 있습니다. 이는 긴 대화에서 토큰을 낭비하거나, 잘못된 수정 때문에 다시 설명하는 일을 줄이는 데 도움이 됩니다.

핵심 포인트

  • AI 코딩을 잘 쓰려면 프로젝트 규칙을 문서로 남기는 습관이 중요하다는 주장입니다.
  • AI 에이전트가 반복 실수를 줄이면 재작업과 토큰 비용도 줄 수 있습니다.
  • 글은 큰 제품 발표가 아니라 커뮤니티의 문제 제기와 도움 요청에 가깝습니다.
  • 규칙 문서에는 금지할 행동, 꼭 해야 할 확인, 테스트 기준을 짧게 쓰는 것이 실용적입니다.

용어 한 줄 설명

코딩
컴퓨터가 이해할 수 있는 언어로 명령을 작성하여 프로그램을 만드는 일입니다.
AI 에이전트
사람 대신 정보를 찾거나 작업을 처리하도록 만든 AI 프로그램입니다.
토큰 비용
AI가 글을 읽고 답할 때 처리한 글자 조각 수에 따라 드는 비용입니다.
토큰
AI가 글을 읽고 쓸 때 세는 작은 글자 조각 단위입니다.
vibe coding
원하는 결과를 말로 설명하며 AI와 함께 코드를 만드는 방식입니다.
OC
Original Character의 약자로, 사용자가 직접 만들어낸 가상의 창작 캐릭터를 말합니다.
테스트
소프트웨어가 의도한 대로 작동하는지 확인하는 과정으로, 버그(오류)를 찾아내는 작업이다.
원문 보기