AI 코딩 에이전트 비용을 줄이는 문서 운영법
몇 달 동안 Codex와 Claude Code 같은 작업 방식을 계속 다듬은 결과, 복잡한 저장소나 프레임워크보다 단순한 문서 중심 흐름이 더 오래 남았다. 핵심은 를 기준 문서로 두고, /docs 폴더에 10~30개의 작은 문서로 세부 지식을 나누는 방식이다.
이 문서들은 아키텍처 결정, 좋은 개발 습관, 코딩 규칙, AI가 피해야 할 일, 특정 업무 지식을 담는다. 문서가 너무 커지면 로 바꾸고 내용을 더 작은 파일들로 쪼갠다.
이렇게 하면 AI가 매번 거대한 지식 묶음을 읽지 않고, 지금 할 일에 필요한 문서만 읽게 된다. 작업 전에는 검증 단계를 먼저 돌려서 에이전트가 일을 시작하기 전에 필요한 점검을 하려는 흐름도 포함되어 있다.
핵심 포인트
- 를 에이전트용 기준 문서로 유지한다.
- /docs 폴더에 10~30개의 작은 문서로 지식을 나눈다.
- 아키텍처 결정, 코딩 규칙, 피해야 할 일, 업무 지식을 문서화한다.
- 큰 문서는 로 바꾸고 세부 내용을 더 작은 파일로 쪼갠다.
- AI가 필요한 문서만 읽게 하면 문맥 사용량과 비용을 줄일 수 있다.