LLM 생성 코드 품질을 높이는 나만의 agent.md

My agent.md to improve LLM-assisted code quality

Fabien Sanglard는 2025년 중반 LLM 코딩에 처음 도전했지만 실망했습니다. 2026년 1월에 다시 시도했고, 이번에는 복잡한 인덱스 바이너리 힙 클래스를 작성하고 Windows IOCP 관련 난해한 버그를 찾아내는 등 성능이 크게 개선되었지만, 코드 품질은 형편없었습니다. 이후 에이전트 IDE(예: Antigravity, VS Code의 Claude Code)를 사용하며 반복적인 지시를 주는 데 지쳐, 프로젝트 루트에 두는 설정 파일인 agent.md에 코딩 스타일 규칙을 정리했습니다. 이 글에서는 규칙 목록과 함께, 컨텍스트 희석 문제를 완화하는 방법(새 세션 시작, 'Reload agent.md' 명령)과 에이전트가 스스로 agent.md를 업데이트하도록 하는 팁을 공유합니다.

LLM은 끊임없이 환각을 일으키며 신뢰할 수 없습니다. 여전히 많은 검증과 반복이 필요하지만, 이제는 코드 스타일 대신 아키텍처와 설계에 집중할 수 있습니다.

이 날의 다른 글

2026-08-23