저는 코딩 에이전트를 자주 사용하며 LLM(대규모 언어 모델) 과 충분히 글을 써오면서 동일한 문제가 반복적으로 발생했습니다. 에이전트는 리포지토리를 이해하기 전에 코드에 뛰어 들거나, 요청하지 않은 인접 코드를 건드리거나, 실제로 확인하지 않고 작업을 완료했다고 말하기도 했습니다. 그리고 텍스트는 여러분이 잘 아시다시피 별도의 큰 문제입니다: 지나치게 다듬어지고, 너무 일반적이며, 실제 내용이 괜찮더라도 여전히 AI slop(부실한 생성물) 가 넘쳐납니다.

그래서 저는 에이전트가 따르기를 원하는 규칙들을 작성하기 시작했고, 동일한 실패가 다시 발생할 때마다 그 규칙들을 더욱 엄격하게 만들었습니다. 결국 이는 제가 직접 사용하는 두 개의 작은 저장소로 발전했습니다:

• AGENTS.md / CLAUDE.md 는 코딩 에이전트를 위한 전역 지시 파일입니다. 이 파일은 코드 작성 전에 증거 제시, 소규모 범위의 변경 사항 적용, 실제 검증 수행, 그리고 한 번에 모든 일을 처리하는 대신 병렬 작업/서브 에이전트 활용을 더 잘하도록 유도합니다.
• WRITING.md 는 LLM(대규모 언어 모델) 보조 작문을 다듬기 위한 규칙 집합입니다. 주로 채팅봇에서 붙여넣은 것처럼 느껴지는 텍스트의 요소를 제거하는 데 중점을 둡니다: filler, 가상의 구체성, 지나치게 깔끔한 구조, 반복되는 리듬, 그리고 기타 AI slop 패턴들.

두 저장소 모두 이제 공개되었습니다. 그대로 사용하거나 일부만 차용하시거나 규칙에 이견이 있거나, 설정에 따라 작동 방식이 다를 경우 이슈를 열어주세요. 이 규칙들은 저에게 일부 문제를 해결해 주었으며, 다른 분들에게도 어떤 효과가 있는지 궁금합니다.