---

name: todo-dev description: TODO CLI 개발 작업(명령·기능 추가, 버그 수정, 테스트 작성, 리뷰, 커밋·push)을 개발자·테스터·리뷰어 에이전트 팀으로 진행하는 오케스트레이터. todo CLI, todo.json, todo/cli.py 관련 구현·수정·테스트 요청에 사용한다. 재실행, 수정, 보완, 이전 결과 개선, 테스트만 다시, 리뷰만 다시 요청에도 사용한다. 단순 질문에는 쓰지 않는다.

todo-dev 오케스트레이터

실행 모드: 서브에이전트 위임 (결과만 한 번 받으면 되고, 에이전트끼리 대화할 필요가 없다. 파일 3개 규모라 워크플로는 과하다.)

팀

에이전트	모델	역할
todo-developer	opus	구현·수정
todo-tester	sonnet	테스트 작성·실행
todo-reviewer	opus	읽기 전용 교차 검증

0단계: 맥락 확인

• _workspace/가 있고 일부만 고쳐 달라는 요청이면 해당 단계만 다시 실행한다.
• 새 요청이면 기존 _workspace/를 _workspace_{타임스탬프}/로 옮긴다.
• 없으면 처음부터 진행한다.

절차

1. 구현: Agent(subagent_type: "todo-developer")에 요청 내용과 목표 동작을 넘긴다.
2. 테스트와 리뷰(병렬): 구현 보고를 받으면 한 메시지에서 todo-tester와 todo-reviewer를 동시에 호출한다. 두 에이전트에 변경 파일과 구현 보고를 전달한다. 결과는 _workspace/02_tester_report.md, _workspace/02_reviewer_findings.md에 저장한다.
3. 수정 루프: 실패한 테스트나 리뷰 지적이 있으면 todo-developer에게 파일 경로와 함께 넘겨 고친 뒤 2단계를 다시 한다. 최대 2회 반복하고, 그래도 남으면 사용자에게 미해결 항목을 보고한다.
4. 마무리: python -m pytest tests -q가 통과하면 커밋한다. git push는 사용자가 허용했으므로 자동으로 한다. force push와 브랜치 삭제는 하지 않고 묻는다.

권한 정책

사용자가 에이전트의 todo.json 실데이터 삭제와 git push를 허용했다. .claude/settings.json에 해당 허용 규칙이 있다. 허용되었더라도 테스트는 임시 DB를 기본으로 쓰고, 실데이터를 지웠다면 최종 보고에 적는다.

오류 처리

• 에이전트 실패는 1회 재시도하고, 또 실패하면 해당 결과 없이 진행하되 최종 보고에 누락을 적는다.
• 권한 거부·인증 만료처럼 재시도해도 같은 실패는 재시도하지 않고 사용자에게 보고한다.
• push가 거절되면(원격 변경 등) 원인을 보고한다. 강제로 밀지 않는다.

테스트 시나리오

• 정상: "todo에 delete 명령 추가해줘" → developer가 구현 → tester가 정상·범위 밖 번호 테스트 추가 후 통과, reviewer 지적 없음 → 커밋·push → 변경 요약 보고.
• 오류: reviewer가 "저장 중 예외 시 todo.json이 잘림"을 지적 → developer가 수정 → 2단계 재실행 → 통과. 2회 후에도 남으면 미해결로 보고.