더 신뢰할 수 있는 코딩 에이전트 작업과 덜 부실한 AI 텍스트를 위한 전역 AGENTS.md / CLAUDE.md 및 WRITING.md 규칙 공개
요약
본 글은 코딩 에이전트의 신뢰성 문제와 AI 생성 텍스트의 부실함(AI slop)이라는 두 가지 일반적인 문제를 다루고 있습니다. 필자는 이 문제를 해결하기 위해 'AGENTS.md'를 공개하여 코드 작성 전 증거 제시, 소규모 변경 적용, 실제 검증 등을 강제하는 코딩 에이전트용 전역 지시 규칙을 만들었습니다. 또한, 'WRITING.md'는 지나치게 다듬어지고 일반적인 AI 텍스트의 특징(filler, 가상의 구체성 등)을 제거하여 더 자연스럽고 신뢰할 수 있는 글쓰기를 돕는 규칙 집합입니다.
핵심 포인트
- 코딩 에이전트가 코드에 뛰어들기 전에 증거 제시와 소규모 변경 적용 같은 엄격한 절차를 따르도록 강제하는 'AGENTS.md' 가이드라인을 제공합니다.
- AI 텍스트의 흔한 문제점인 과도하게 다듬어지고 일반적인 'AI slop' 패턴을 식별하고 제거하는 규칙 세트인 'WRITING.md'를 공개했습니다.
- 이 두 규칙 파일은 사용자가 직접 코딩 에이전트와 LLM 보조 작문 과정에서 발생하는 신뢰성 및 품질 문제를 해결하기 위해 개발되었습니다.
- 사용자들은 이 오픈 소스 규칙들을 자유롭게 활용하거나, 개선 사항이나 다른 설정에 대한 피드백을 이슈를 통해 공유할 수 있습니다.
저는 코딩 에이전트를 자주 사용하며 LLM(대규모 언어 모델) 과 충분히 글을 써오면서 동일한 문제가 반복적으로 발생했습니다. 에이전트는 리포지토리를 이해하기 전에 코드에 뛰어 들거나, 요청하지 않은 인접 코드를 건드리거나, 실제로 확인하지 않고 작업을 완료했다고 말하기도 했습니다. 그리고 텍스트는 여러분이 잘 아시다시피 별도의 큰 문제입니다: 지나치게 다듬어지고, 너무 일반적이며, 실제 내용이 괜찮더라도 여전히 AI slop(부실한 생성물) 가 넘쳐납니다.
그래서 저는 에이전트가 따르기를 원하는 규칙들을 작성하기 시작했고, 동일한 실패가 다시 발생할 때마다 그 규칙들을 더욱 엄격하게 만들었습니다. 결국 이는 제가 직접 사용하는 두 개의 작은 저장소로 발전했습니다:
- AGENTS.md / CLAUDE.md 는 코딩 에이전트를 위한 전역 지시 파일입니다. 이 파일은 코드 작성 전에 증거 제시, 소규모 범위의 변경 사항 적용, 실제 검증 수행, 그리고 한 번에 모든 일을 처리하는 대신 병렬 작업/서브 에이전트 활용을 더 잘하도록 유도합니다.
- WRITING.md 는 LLM(대규모 언어 모델) 보조 작문을 다듬기 위한 규칙 집합입니다. 주로 채팅봇에서 붙여넣은 것처럼 느껴지는 텍스트의 요소를 제거하는 데 중점을 둡니다: filler, 가상의 구체성, 지나치게 깔끔한 구조, 반복되는 리듬, 그리고 기타 AI slop 패턴들.
두 저장소 모두 이제 공개되었습니다. 그대로 사용하거나 일부만 차용하시거나 규칙에 이견이 있거나, 설정에 따라 작동 방식이 다를 경우 이슈를 열어주세요. 이 규칙들은 저에게 일부 문제를 해결해 주었으며, 다른 분들에게도 어떤 효과가 있는지 궁금합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Reddit AI Engineering의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기