r/vibecoding•5개월 전•59•37

13권의 소프트웨어 공학 명저를 AGENTS.md 규칙으로 정리했습니다.

I rewrote 13 software engineering books into AGENTS.md rules.

핵심 요약

유명 개발 서적 13권의 원칙을 AI 에이전트용 규칙으로 변환한 프로젝트와 그 실용성에 대한 논쟁

명저 13권 변환 — 클린 코드, DDD 등 필독서의 핵심 원칙을 AI 에이전트용 마크다운 규칙으로 정리함.
지시문 한계 논란 — LLM의 지시사항 준수 제한(50~100개) 때문에 방대한 규칙은 오히려 독이 될 수 있다는 지적임.
에이전트 통제 — 모델이 이미 아는 내용이라도 명시적 가이드 없이는 제대로 따르지 않는다는 제작자의 경험담임.
대안적 접근 — 규칙을 '기술(skills)' 단위로 분리하거나 리팩토링 단계에서만 따로 적용하는 방식이 제안됨.

지원되는 도구: Claude Code, Codex 및 Cursor

포함된 도서:

소프트웨어 설계의 철학 — John Ousterhout
클린 아키텍처 — Robert C. Martin
클린 코드 — Robert C. Martin
코드 컴플리트 — Steve McConnell
데이터 중심 애플리케이션 설계 — Martin Kleppmann
도메인 주도 설계 — Eric Evans
도메인 주도 설계 핵심 원칙 — Vaughn Vernon
도메인 주도 설계 구현 — Vaughn Vernon
엔터프라이즈 애플리케이션 아키텍처 패턴 — Martin Fowler
리팩터링 — Martin Fowler
Release It! — Michael T. Nygard
실용주의 프로그래머 — Andrew Hunt 및 David Thomas
레거시 코드 활용 전략 — Michael Feathers

원문

커뮤니티 목록

r/vibecoding•5개월 전•59•37

13권의 소프트웨어 공학 명저를 AGENTS.md 규칙으로 정리했습니다.

I rewrote 13 software engineering books into AGENTS.md rules.

핵심 요약

유명 개발 서적 13권의 원칙을 AI 에이전트용 규칙으로 변환한 프로젝트와 그 실용성에 대한 논쟁

명저 13권 변환 — 클린 코드, DDD 등 필독서의 핵심 원칙을 AI 에이전트용 마크다운 규칙으로 정리함.
지시문 한계 논란 — LLM의 지시사항 준수 제한(50~100개) 때문에 방대한 규칙은 오히려 독이 될 수 있다는 지적임.
에이전트 통제 — 모델이 이미 아는 내용이라도 명시적 가이드 없이는 제대로 따르지 않는다는 제작자의 경험담임.
대안적 접근 — 규칙을 '기술(skills)' 단위로 분리하거나 리팩토링 단계에서만 따로 적용하는 방식이 제안됨.

지원되는 도구: Claude Code, Codex 및 Cursor

포함된 도서:

소프트웨어 설계의 철학 — John Ousterhout
클린 아키텍처 — Robert C. Martin
클린 코드 — Robert C. Martin
코드 컴플리트 — Steve McConnell
데이터 중심 애플리케이션 설계 — Martin Kleppmann
도메인 주도 설계 — Eric Evans
도메인 주도 설계 핵심 원칙 — Vaughn Vernon
도메인 주도 설계 구현 — Vaughn Vernon
엔터프라이즈 애플리케이션 아키텍처 패턴 — Martin Fowler
리팩터링 — Martin Fowler
Release It! — Michael T. Nygard
실용주의 프로그래머 — Andrew Hunt 및 David Thomas
레거시 코드 활용 전략 — Michael Feathers

주요 댓글

r/vibecoding

방대한 규칙이 LLM의 지시 이행 능력을 저하시킬 것이라는 회의론과, 모델의 '게으름'을 방지하기 위해 명시적 가이드가 필요하다는 제작자의 입장이 팽팽하게 맞서고 있습니다.

이거 실전에서 별로 쓸모없을 것 같은데. 물론 이 규칙들을 제대로만 적용하면 코드가 좋아지겠지만, '제대로 적용한다'는 전제 조건이 너무 빡셈. LLM은 신뢰성 있게 따를 수 있는 구체적인 지시사항 개수(50-100개)에 이미 한계가 있음. HumanLayer 같은 곳에서 이걸 아주 잘 증명했지. 여기 있는 책 한 권 분량만으로도 그 한계를 다 써버려서, 정작 네가 기획이나 구현 단계에서 추가하려는 지시사항을 넣을 자리가 없을 거임.

좀 더 살펴보니 아래쪽에 이걸 보완하는 노트를 적어두긴 했네. 그래도 여전히 지시사항이 너무 많음.

-2

응, 무슨 말인지 알겠음. 파일이 크다는 건 나도 앎. Claude Code는 200줄 정도를 권장하더라고. 근데 내가 프로젝트 하면서 계속 에이전트를 다듬으며 쓴 AGENTS.md는 책 한두 권 분량보다 훨씬 길어지더라. .md 파일을 여러 개 만들어서 "새 기능 만들 땐 이 MD 쓰고, 리팩토링할 땐 저 MD 쓰고, 아키텍처 짤 땐..." 이런 식으로 시키면 어떨까 고민 중임.

길이 제한으로 뒷부분이 생략된 댓글입니다 · 원문에서 전체 보기 →

기술적으로 .md 파일로 하는 게 아니라 'skills'로 처리해야 함. 그래야 에이전트가 실행할 때만 해당 기술을 로드하거든.

몇 가지 생각. 첫째, 윗사람 말대로 'skills'로 하는 게 정석임. 둘째, 에이전트한테 어떤 작업할 땐 이 규칙, 다른 거 할 땐 저 규칙 따르라고 시키기보다(보통 작업은 동시에 일어나니까), 일단 네 방식대로 코드를 짜게 둔 다음 나중에 별도의 리팩토링 단계에서 이 규칙들을 적용하는 게 나을 듯. 셋째, 에이전트가 이 모든 패턴을 다 따를 거라 기대하긴 힘듦.

이거 진짜 좋은 아이디어네. 작성자 레포 클론해서 내 cc 토큰으로 규칙 10~15개 정도 뽑아낸 다음 AGENTS.md 파일로 공개해봐야지.

🔗 openai.com

이런 건 이미 존재하는 프로세스 프레임워크로 적용하는 게 훨씬 강력함. 이미 나와 있는 것들을 찾아보지 않고 왜 이런 시도를 하는지 궁금하네.

AI는 이미 이 책들이나 요약본으로 학습됐음. 그냥 "어떤 책의 베스트 프랙티스와 가이드라인을 따라줘"라고만 해도 수고를 덜 수 있음.

이보게, LLM을 뭘로 학습시킨다고 생각하나? Anthropic이나 OpenAI 라이브러리에 1970년부터 2026년까지의 코딩 베스트셀러가 없을 것 같음?

당연히 학습했겠지. 문제는 에이전트가 그 내용을 알고 있으면서도 규칙을 안 지킨다는 거임.

고마워! 내가 이미 쓰고 있는 거버넌스에 네 내용을 좀 추가해서 개선해볼게.

이거 불법 아닌가? LLM 출력물에 MIT 라이선스를 걸 수 있나?

원문r/vibecoding