아프니까 개발자다 아프니까 개발자다

AI 에이전트가 개발 도구를 사용할 때 가장 범하기 쉬운 실수는 앞뒤 상황을 파악하지 않고 무작정 파일 전체를 조회(`read`)하거나 전체를 검색(`grep`)하는 '도구 폭격(Tool Bombing)'입니다. 이는 컨텍스트 윈도우(Context Window)를 빠르게 소진시키고, 엉뚱한 방향으로 코드를 고쳐 시스템을 망가뜨리는 주원인입니다.`open-code` 프로젝트와 커뮤니티는 이를 방지하기 위해 "도구를 호출하기 전에 반드시 가설을 수립하고 계획 문서를 명세화"하는 철저한 계획(Plan) 단계를 거칩니다.① 계획(Plan) 단계의 핵심 철학`open-code` 규칙 파일(`config/AGENTS.md`)에 기술된 계획 단계의 핵심 제약 사항은 다음과 같습니다.Tool 호출 규율 (Plan 관련..

사용자가 에이전트에게 "이 프로젝트 전체를 리팩터링해서 성능을 올려줘"라고 명령한다. 이는 한 번에 수행할 수 있는 단일 작업이 아니다. 에이전트가 이처럼 크고 모호한 목표를 받았을 때 길을 잃지 않고 차근차근 나아갈 수 있게 돕는 나침반이 바로 계획(Planning) 단계다.아무리 똑똑한 AI 모델이라도 계획을 세우지 않고 코딩부터 시작하면 백전백패다. 이 글에서는 에이전트 루프의 중추인 계획 단계의 중요성과 작동 기법을 알아본다.① 계획(Planning) 단계에서 수행하는 일계획은 관찰을 통해 수집한 '현재의 환경 정보'와 사용자가 전달한 '최종 목표'를 융합하여, 실행 가능한 로드맵을 설계하는 과정이다. 이 단계에서 에이전트는 다음과 같은 구체적인 작업을 수행한다.목표 해체 (Goal Decompo..