에이전트에게 전체 레포지토리를 붙여넣는 것을 멈추세요

# AGENT_CONTEXT.md
task: 

API 작업을 위해 가장 활용도가 높은 요소(artifact)는 어떤 코드 파일도 아니라, 계약서(contract)입니다. 에이전트가 OpenAPI 사양(spec)을 먼저 읽으면, 시스템이 기대하는 형태를 타입과 예시 페이로드만으로 알기 때문에 세 개의 호출 사이트를 붙여넣어 줄 필요가 없습니다. 저희는 [Powerduck](https://www.powerduck.com/)을 이 원칙에 기반하여 구축했습니다. 즉, 사양이 로컬에 존재하고, 에이전트는 그 사양 파일(spec file)을 참조하며, 생성되는 타입과 예시는 이 사양에서 파생됩니다. 이제 어떤 호출자(caller)를 붙여야 할지 추측할 필요가 없습니다.

## 운영 환경(Production)에서 살아남는 두 가지 규칙

**1. 초기 컨텍스트를 최대로 늘리기보다 제한하세요.** 3~5개 파일로 시작하십시오. 에이전트에게 더 많은 것을 요청하도록 하세요. 추가적인 왕복(round-trip) 한 번의 비용은 몇 분이지만, 4,000줄에 달하는 컨텍스트 전체에서 잘못된 수정 하나를 할 경우 발생하는 비용은 빌드 실패입니다.

**2. "이것을 읽어라"와 "이것이 진실의 원천(source of truth)이다"를 구분하세요.** 붙여넣는 대부분의 파일은 참고 자료일 뿐입니다. 계약서, 스키마, 마이그레이션, 불변성(invariant)을 인코딩하는 테스트처럼 하나의 파일만이 에이전트가 권위적이라고 취급해야 할 원천입니다. 이를 명시적으로 표시하세요. 그렇지 않으면 에이전트는 실제 스키마보다 README에 있는 비공식적인 예시에 더 큰 가중치를 부여하게 됩니다.

## 이번 주에 해야 할 일

-   지난 5개의 에이전트 세션을 열어보세요. 첫 번째 차례에 첨부된 파일 수를 세어보십시오. 다섯 개를 초과한다면, 당신은 희석세(dilution tax)를 지불하고 있는 것입니다.
-   빈번하게 발생하는 작업 하나("API 형태 변경", "CLI 플래그 추가", "X의 불안정한 테스트 수정" 등)를 선택하고, 이를 위한 20줄 분량의 매니페스트(manifest)를 작성하세요. 일주일에 한 번씩 반복 개선하십시오.
-   README 파일을 자동 첨부하는 것을 중단하세요. 이 파일은 에이전트가 가장 필요하지 않은 파일인 경우가 거의 대부분이며, 또한 당신이 가장 먼저 첨부하는 파일인 경우도 거의 대부분입니다.

목표는 완벽한 RAG 시스템을 구축하는 것이 아닙니다. 잘못된 12개의 파일을 추측하기보다 올바른 세 개의 파일을 읽어내는 에이전트를 만드는 것입니다.