[2팀 정나리] Chapter 1-2. AI와 테스트를 활용한 안정적인 기능 개발

[naringst]

과제 체크포인트

필수 스펙

• 1. 반복 유형 선택
  • 일정 생성 또는 수정 시 반복 유형을 선택할 수 있다.
  • 반복 유형은 다음과 같다: 매일, 매주, 매월, 매년
    • 31일에 매월을 선택한다면 → 매월 마지막이 아닌, 31일에만 생성하세요.
    • 윤년 29일에 매년을 선택한다면 → 29일에만 생성하세요!
  • 반복일정은 일정 겹침을 고려하지 않는다.

2. 반복 일정 표시
   • 캘린더 뷰에서 반복 일정을 아이콘을 넣어 구분하여 표시한다.
3. 반복 종료
   • 반복 종료 조건을 지정할 수 있다.
   • 옵션: 특정 날짜까지
     • 예제 특성상, 2025-12-31까지 최대 일자를 만들어 주세요.
4. 반복 일정 수정
   1. ‘해당 일정만 수정하시겠어요?’ 라는 텍스트에서 ‘예’라고 누르는 경우 단일 수정
      • 반복일정을 수정하면 단일 일정으로 변경됩니다.
      • 반복일정 아이콘도 사라집니다.
   2. ‘해당 일정만 수정하시겠어요?’ 라는 텍스트에서 ‘아니오’라고 누르는 경우 전체 수정
      • 이 경우 반복 일정은 유지됩니다.
      • 반복일정 아이콘도 유지됩니다.
5. 반복 일정 삭제
   1. ‘해당 일정만 삭제하시겠어요?’ 라는 텍스트에서 ‘예’라고 누르는 경우 단일 수정
      1. 해당 일정만 삭제합니다.
   2. ‘해당 일정만 삭제하시겠어요?’ 라는 텍스트에서 ‘아니오’라고 누르는 경우 전체 수정
      1. 반복 일정의 모든 일정을 삭제할 수 있다.

기본 과제

공통 제출

• 테스트를 잘 작성할 수 있는 규칙 명세
• 명세에 있는 기능을 구현하기 위한 테스트를 모두 작성하고 올바르게 구현했는지
• 명세에 있는 기능을 모두 올바르게 구현하고 잘 동작하는지

기본 과제(Easy)

• AI 코드를 잘 작성하기 위해 추가로 작성했던 지침
• 커밋별 올바르게 단계에 대한 작업
• AI 도구 활용을 개선하기 위해 노력한 점 PR에 작성

기본 과제(Hard)

• Agent 구현 명세 문서 또는 코드
• 커밋별 올바르게 단계에 대한 작업
• 결과를 올바로 얻기위한 history 또는 log
• AI 도구 활용을 개선하기 위해 노력한 점 PR에 작성

심화 과제

• 모든 질문에 대해 꼼꼼하게 정리했는지

---

과제 셀프회고

기술적 성장

• 학습 키워드 : agent, TDD
• agent를 '어떻게' '왜' 사용하여 기능 개발을 해야 하는지 배웠습니다.
  • 어떻게? 학습 자료, BMAD-method 등을 활용해 md로 페르소나를 부여하고, 해야할일, 하지말아야 할일, 그리고 규칙들을 부여해 에이전트를 생성할 수 있었습니다.
  • 왜? 업무의 효율성을 높이기 위함입니다. 에이전트로 workflow를 한 번 잘 구성해 놓으면, 훨씬 효율적으로 기능 개발이 가능할 것 같습니다. 실제로 저는 실무에서 반복 기능을 개발한 경험이 있는데, agent와 일주일만에 개발을 해버려서 약간 허무하기도 했습니다....

코드 품질

[진행 과정]

• 초기에는 역할 중심(BMAD의 PO, PM, SM 등)으로 에이전트를 분리했습니다.

• 그러나 PM 역할을 부여한 에이전트가 임의로 기능 명세를 보완·추가하면서 전체 플로우가 어긋나는 문제가 발생했습니다.

• 이를 해결하기 위해 “되묻기 규칙(Human-in-the-loop)”을 도입하여, 명확히 확인되지 않은 내용은 반드시 인간에게 되물어 정확한 스펙을 확보하도록 했습니다.

• 하지만 이 과정에서 한 에이전트가 너무 많은 역할을 맡게 되면서 관리 복잡도가 증가했습니다.

• 따라서 이후에는 “역할 기반 분리 → 도구 기반 분리”로 전환하였고, 각 에이전트를 입력(input)과 출력(output) 단위로 설계했습니다.

• 그 결과, 최종적으로 11개의 에이전트가 명확한 인터페이스로 연결되는 구조가 완성되었습니다.

[최종 전체 설계]

• 프로덕션에서 사용할 수 있는 정도의 agent를 만드는 것을 목표로 했습니다.
  • 작은 단위의 작업과 명확한 인풋, 아웃풋이 있어야 가장 좋은 결과물을 낼 수 있다고 생각했습니다.
  • 따라서 전체 workflow를 구성하는 에이전트들을 아래와 같이 나누어 작업했습니다.

폴더 구조)

.cursor/
├── commands/          # 역할별 에이전트 정의
├── outputs/           # 각 단계의 출력물 저장
│   ├── 2-splited-features/
│   ├── 3-integration-test-design/
│   └── 4-integration-to-unit/
└── checklists/        # 검증 체크리스트

에이전트 구성)

1. split-by-number : 번호대로 기능을 나누는 에이전트
2. feature-decomposer: 하나의 번호의 기능을 세분화하여 나누고, 명세를 구체화하는 에이전트
3. test-designer: 통합 테스트를 디자인하는 에이전트
4. integration-test-writer: 통합 테스트를 작성하는 에이전트
5. integration-test-evaluator: 통합 테스트를 체크리스트 기반으로 평가하는 에이전트

• 처음에는 test evaluator를 넣지 않았습니다. 그런데 진행을 하다 보니, 통합 테스트 작성 퀄리티가 매우 떨어진다는 것을 발견했고, 그래서 체크리스트와 evaluator를 도입하여 90점 이상인 통합 테스트의 경우만 사용할 수 있도록 했습니다.

7. unit-candidate-finder: 통합 테스트와 기능 명세를 기반으로 단위테스트 요소를 찾는 에이전트
8. unit-test-writer: 단위 테스트를 작성하는 에이전트
9. developer: 테스트 기반으로 기능 개발하는 에이전트
10. deubg-doctor: 기능 개발이나 테스트 코드에서 에러가 발생했을 때 고치는 에이전트

• 해당 에이전트에게는 제가 사용하는 디버깅 절차를 주고, 그대로 수행하도록 했습니다. debug-doctor도 처음 설계 때에는 포함하지 않았던 에이전트인데, 디버깅을 꽤 많이 해야 해서 도입했습니다.

11. refactor: 리팩토링 에이전트
12. orchestator: 전체 총괄 에이전트

출력물 활용)
앞선 에이전트의 출력물을 뒷 에이전트가 참고하게 하기 위해서 코드 작성을 제외한 모든 에이전트의 output은 각각의 폴더에 저장하도록 했습니다.

checklist 활용)

• 기능을 세부적으로 나눌 때의 output이 뒷 flow에 영향을 많이 미치기 떄문에, breakdown-checklist.md를 주고 해당 체크리스트를 만족하는 output을 내도록 했습니다.
• 또한 테스트 디자인이나 테스트 코드 관련해서는 how-to-design-test.md(직접 작성), how-to-test.md(배휘동님 github 참고), kent-beck-test.md 를 참고하도록 했습니다.
• 또한 integration, unit test 마다 체크리스트를 두고 해당 체크리스트를 만족하도록 진행했습니다.

학습 효과 분석

• 추가 학습이 필요한 영역

1. 같은 input에 대한 output 비교
   사실 과제를 수행할 때, 기능 1번에 대해 전체 과정을 돌려보면서 설계와 프롬프팅을 튜닝하고, 그 다음 2번을 진행한 뒤 오케스트레이터를 도입하는 과정으로 진행했습니다.(점진적 개선)
   하지만 그 과정에서 같은 인풋을 주고 프롬프팅에 따라 어떤 다른 아웃풋이 나오는지는 명확히 비교해보지 못해서, 해당 내용을 추가로 학습하고자 합니다.

2. 통합 테스트에 대한 이해 부족
   가장 시간을 많이 썼던 부분이 통합 테스트 디버깅 과정입니다. 그런데 제가 통합 테스트에 대해 정확히 모르는 부분들이 있다보니 매뉴얼하게 디버깅 하는 시간이 꽤 걸렸습니다. 또한 통합 테스트에 대해 더 잘 알았더라면 프롬프팅을 더 구체적으로 할 수 있었을텐데 하는 아쉬움이 남습니다.

과제 피드백

리뷰 받고 싶은 내용

• 저는 agent 들을 역할 중심이 아니라 도구 중심으로 나누었는데, 어떤 방식으로 진행하는지가 성능에 영향을 미치는지, 아니면 역할 중심으로 하더라도 그 역할을 정확히 맡게 하면 비슷한 ouput이 나오는지, 보통 어떻게 많이 구현하는지 궁금합니다.