AI 에이전트 규칙 파일 관리법 (하네스 엔지니어링)
좋은 모델을 붙인다고 끝이 아니다. AI 에이전트 규칙 파일을 어떻게 나누느냐가 결과를 가른다. CLAUDE.md 가 300줄을 넘으면서 정작 중요한 규칙이 파묻힌 경험과, 규칙·메모리·플랜·스킬을 섞으면 안 되는 이유.
AI 코딩 에이전트를 매일 쓰면서 정리한 것들. 규칙 파일과 메모리 파일의 차이, 하네스 엔지니어링, 도구별 설정 방식을 실제 사례 중심으로 씁니다.
좋은 모델을 붙인다고 끝이 아니다. AI 에이전트 규칙 파일을 어떻게 나누느냐가 결과를 가른다. CLAUDE.md 가 300줄을 넘으면서 정작 중요한 규칙이 파묻힌 경험과, 규칙·메모리·플랜·스킬을 섞으면 안 되는 이유.
바이브 코딩으로 기능 하나 던졌다가 멀쩡한 인증 로직이 갈아엎어졌다. 규칙·메모리·계획·스킬로 md 파일을 네 층위로 나누는 방법과, 자주 하는 실수 세 가지.