비싼 모델로 계획을 세우고, 싼 모델로 코드를 쓰게 하는 워크플로우
가장 똑똑한 모델이 코드베이스를 이해하고 우선순위를 정해 문서로 남기면, 그 문서를 바탕으로 싼 모델이나 사람이 실제 작업을 수행합니다. 복잡한 판단은 비싼 모델이, 반복적인 실행은 저렴한 모델이 담당하도록 역할을 나누어 비용을 줄이고 품질을 유지합니다. 이 도구는 코드를 직접 고치지 않고, 어떤 부분을 어떻게 고칠지 상세한 설계도를 만들어 줍니다.
계획이 곧 산출물
이 도구는 어떤 코드를 수정하거나 기능을 추가하지 않습니다. 대신 저장소를 분석하고 발견한 문제를 정리한 후, 각 문제를 해결하기 위한 구체적인 실행 계획서를 plans/ 폴더에 마크다운 파일로 생성합니다. 이 계획서는 현재 코드 상태, 변경할 파일 경로, 검증할 명령어까지 모두 포함하여 독립적으로 읽을 수 있게 작성됩니다. 따라서 이 문서를 받은 다른 에이전트나 개발자가 컨텍스트를 새로 불러오지 않고도 바로 작업을 시작할 수 있습니다. 최종적으로 코드를 병합할지 여부는 항상 사용자가 결정합니다.
분석부터 실행까지의 흐름
사용자는 /improve 명령어를 입력해 전체 감사나 특정 영역(보안, 성능 등)에 대한 집중 감사를 요청할 수 있습니다. 도구는 저장소의 구조와 컨벤션을 파악한 뒤, 9개 카테고리로 나뉜 하위 에이전트들을 병렬로 실행해 문제를 찾습니다. 이때 단순히 문제를 나열하는 것이 아니라, 각 발견 사항에 파일 위치, 영향도, 노력량, 신뢰도를 부여합니다. 이후 사용자가 선택한 항목에 대해 상세 계획서를 작성하며, /improve execute 명령을 통해 저렴한 모델을 격리된 워크트리에서 실행시켜 결과를 검토받기도 합니다.
실행 가능한 계획서의 조건
생성된 계획서는 가장 제한적인 실행자도 이해할 수 있도록 세 가지 원칙을 따릅니다. 첫째, 모든 컨텍스트를 문서 안에 직접 포함시켜 '위에서 논의한 바와 같이' 같은 모호한 표현을 배제합니다. 둘째, 각 단계의 완료 기준을 기계적으로 검증할 수 있는 명령어와 예상 출력으로 명시합니다. 셋째, 계획과 실제 코드가 일치하지 않을 때 실행자가 임의로 판단하지 않도록 '중단하고 보고하라'는 명확한 경계선을 설정합니다. 또한 계획서가 작성된 시점의 git 커밋을 기록해, 실행 전 코드 변경 여부를 자동으로 확인하게 합니다.
사용 전 확인 사항
MIT 라이선스로 공개되어 있으며, 소스 코드 수정 없이 읽기 전용 분석과 계획서 작성에만 집중합니다. 다만, 도구가 생성한 계획서는 반드시 사람이 검토해야 하며, 실행 결과의 병합 권한은 사용자에게 있습니다. 저장소에 ADR이나 디자인 문서가 있다면 이를 참고해 이미 결정된 사항을 다시 문제점으로 지적하지 않도록 하므로, 이러한 문서가 잘 관리된 프로젝트에서 더 높은 효과를 볼 수 있습니다.