Claude Code를 활용한 에이전트 작업 효율화: 'Goal'과 'Rider' 워크플로

섹션별 상세

Goal 파일은 4000자 제한 내에서 작업의 범위, 제외 사항, 완료 기준을 정의한다. Rider 파일은 10-35kb 분량으로 11개 내외의 세부 단계와 테스트 케이스를 포함하며, 코드를 작성하기 전에 테스트 이름을 구체적으로 명시한다.

에이전트 실행 시 이 두 파일을 참조하게 하여 에이전트가 엉뚱한 코드를 작성하거나 작업 범위를 이탈하는 문제를 방지한다. 37번의 작업 수행 결과, 에이전트가 잘못된 방향으로 나아가 작업을 중단해야 하는 상황이 거의 사라졌다.

작업의 각 단계는 커밋 메시지에 태그(예: rider P5)를 남겨 추적성을 확보한다. 이 방식은 나중에 코드를 수정하거나 왜 특정 임계값이 설정되었는지 파악해야 할 때 git log를 통해 근거를 쉽게 찾을 수 있게 한다.

이 워크플로는 TDD와 유사하지만, 사양을 파일로 체크인한다는 점이 핵심이다. 현재 1인 프로젝트 환경에서 검증되었으며, 다수 엔지니어가 협업하는 환경에서의 적용 가능성은 추가 검토가 필요하다.

테스트 주도 개발(TDD): — 테스트 코드를 먼저 작성하고 이를 통과하는 코드를 구현하는 개발 방법론. 이 아티클에서는 에이전트에게 명확한 사양과 완료 기준을 전달하기 위한 수단으로 활용된다.
Claude Code: — Anthropic에서 제공하는 AI 코딩 에이전트. 코드베이스를 이해하고 수정, 실행, 테스트를 수행하며 개발자의 작업을 자동화한다.
grep: — 유닉스 계열 운영체제에서 텍스트를 검색하는 명령어. 이 글에서는 git log에서 특정 태그를 검색하여 작업 이력을 추적하는 데 사용된다.

Claude Code추천

AI 코딩 에이전트