최적화 체크리스트

Agent 최적화 코드베이스 — 4요소

매분기 감사에 사용할 수 있는 — 진단 프레임워크. 위에 메타 원리로 *Consistency over DRY*가 작동한다
☣️
요소 1
패턴 오염 제거
죽은 코드 · 폐기된 로직 · 미완성 마이그레이션을 끈질기게 정리. 같은 일을 하는 경쟁 패턴이 발견되는 즉시 — 한 쪽을 표준으로 고정하고 나머지를 제거.
📐
요소 2
구조적 일관성
디렉토리 구조와 네이밍 컨벤션을 엄격·예측 가능하게 유지. agent가 "어디에 두지?"를 묻지 않고 — 표준 위치를 예측적으로 찾는다.
📊
요소 3
Agent 전용 로깅
agent 소비용 machine-readable 로그 (JSON line). 인간 가독 텍스트가 아니라 — agent가 파싱·쿼리·자기 수정에 쓸 수 있는 구조화 로그.
📜
요소 4
Golden Rules + RAG 문서
아키텍처 표준과 확고한 규칙을 — repo 안에 agent RAG에 최적화된 포맷으로 인코딩. CLAUDE.md → GOLDEN_RULES.md 검색.
이 4요소를 모두 만족하면 — agent의 출력 분산이 구조적으로 감소한다