에이전트 루프 및 태스크 디스패치 가이드

GitHub 이슈를 기반으로 에이전트 루프(run_agent_loop.bat)를 통해 작업을 수행하는 간편한 방법입니다.

작업 흐름

1. 현상 등록: GitHub에 해결해야 할 문제나 할 일을 이슈로 등록합니다. (예: #123 로그인 오류 분석)
2. 태스크 생성 요청: 채팅 중인 에이전트에게 다음과 같이 요청합니다.

   "GitHub 이슈 #123 내용을 바탕으로 giipdb/dispatch에 태스크 문서를 만들어줘. 역할은 Developer로 해줘."

3. 에이전트 조치: 에이전트가 이슈 내용을 읽고 giipdb/dispatch/TASK_[날짜]_[ID].md 파일을 생성합니다.
4. 자동 실행: 현재 실행 중인 에이전트 루프(run_agent_loop.bat)가 새 파일을 감지하여 작업을 시작합니다.

일괄 작업 분배 (Orchestrator 활용)

이슈가 여러 개인 경우, 오케스트레이터(Orchestrator)에게 전체적인 관리를 맡길 수 있습니다.

• 요청 예시:

  "오케스트레이터야, 현재 GitHub의 오픈된 이슈들을 모두 확인해서 적절한 담당자(Developer, Error Analyst 등)에게 giipdb/dispatch 태스크 파일로 분배해줘."

• 효과: 오케스트레이터가 이슈들을 분석하여 각각 독립적인 태스크 파일로 쪼개고, 가장 적합한 역할을 지정하여 파일을 생성합니다.

핵심 변경 사항

• 태스크 경로: .agent/dispatch (숨김) → giipdb/dispatch (사용 가능 상위 폴더)
• 동기화 방식: 복잡한 자동 스크립트 대신, 사용자가 필요할 때 에이전트에게 요청하는 방식으로 단순화되었습니다.

도움말

giipdb/dispatch/TASK_TEMPLATE.md 파일을 참고하여 수동으로 태스크를 작성할 수도 있습니다. 태스크 파일의 Status가 Pending일 때 에이전트가 작업을 가져갑니다.

문제 해결

증상	원인	해결
태스크 파일을 만들었는데 에이전트가 가져가지 않음	태스크의 Status가 Pending이 아님	태스크 파일의 Status를 Pending으로 설정
새 태스크가 감지되지 않음	run_agent_loop.bat 루프가 실행 중이 아님	에이전트 루프를 먼저 실행한 뒤 태스크 생성
생성한 태스크가 인식되지 않음	구 경로 .agent/dispatch(숨김)에 파일 생성	giipdb/dispatch 경로에 태스크 파일 생성
오케스트레이터가 부적합한 역할을 배정	이슈 내용이 모호해 역할 판단이 어려움	요청 시 담당 역할(Developer, Error Analyst 등)을 명시