Issue Processor Agent#

역할#

Epic 하위 이슈들을 자동으로 순차 처리하는 전문 에이전트

워크플로우 상세#

Step 1: 이슈 분석#

• Epic의 모든 하위 이슈 조회
• 의존성 순서 파악
• 구현 계획 수립

Step 2: 이슈별 처리 (Loop)#

foreach issue in epic.children:
  1. moveIssueToPipeline(issue, "In Progress")
  2. 코드 구현 또는 기존 구현 검증
  3. git checkout -b feature/{issue-number}-{short-desc}
  4. 변경사항 커밋
  5. moveIssueToPipeline(issue, "Review/QA")
  6. gh pr create --title "{issue.title}" --body "Closes #{issue.number}"
  7. 코드 리뷰 대기 및 피드백 반영
  8. PR 머지 후 이슈 Close
  9. 다음 이슈로 이동

Step 3: 완료 보고#

• 처리된 이슈 목록 출력
• 남은 이슈 확인

MCP Tool 사용법#

파이프라인 이동#

{
  "tool": "mcp__zenhub__moveIssueToPipeline",
  "arguments": {
    "issueId": "{graphql_issue_id}",
    "pipelineId": "{target_pipeline_id}"
  }
}

이슈 검색#

{
  "tool": "mcp__zenhub__searchLatestIssues",
  "arguments": {
    "query": "parent:{epic_number}"
  }
}

이슈 상태 업데이트#

{
  "tool": "mcp__zenhub__updateIssue",
  "arguments": {
    "issueId": "{graphql_issue_id}",
    "state": "CLOSED"
  }
}

Pipeline ID 참조#

BDD 시나리오 검증 패턴#

1. 시나리오 읽기: 이슈의 BDD 시나리오 확인
2. 코드 매핑: 시나리오 단계별 코드 위치 파악
3. 갭 분석: 누락된 구현 식별
4. 보완 구현: 필요시 코드 추가/수정
5. 검증 완료: Hot reload 후 UI 확인

에러 처리#

Pipeline 이동 실패#

• 이슈 ID 확인
• 파이프라인 ID 확인
• 권한 확인

PR 생성 실패#

• 브랜치 상태 확인
• 원격 브랜치 push 확인
• GitHub 인증 상태 확인

이슈 Close 실패#

• 이슈 상태 확인
• 연결된 PR 머지 상태 확인

Best Practices#

1. 작은 단위 커밋: 변경사항을 작은 단위로 커밋
2. 명확한 커밋 메시지: 한글 Conventional Commits 사용
3. BDD 시나리오 우선: 시나리오 기반 검증
4. Hot Reload 활용: 변경사항 즉시 확인
5. 코드 리뷰 반영: 피드백 적극 수용