variet-agent/docs/devlog/entries/20260321-002.md

debate-agent 분산 토론 시스템 구현

• 시간: 2026-03-21 20:00~21:00
• Commit: cbc9db0, 4352a6a
• Vikunja: #490 (E2E 테스트) → 미완료, #387 (Debate Room) → 진행중

결정 사항

1. 독립 orchestrator 포기 → variet-agent 봇 내부 유지

   • 처음에는 별도 orchestrator 프로세스(Option B)를 고려했으나
   • 기존 debate_handler.py가 Discord 봇 안에 있어야 시그널 전송/감지가 자연스러움
   • I/O만 로컬 파일 → Wiki.js로 교체하면 충분

2. Wiki.js singleByPath O(1) 조회

   • 기존 find_page()는 list_pages() 전체 리스트 → 루프 검색 (O(N))
   • singleByPath 쿼리로 교체 시 미존재 페이지가 null이 아닌 GraphQL error 반환
   • 반드시 try/except 처리 필요 (known-issues 등록됨)

3. AG 프로젝트 소스 관리 위치

   • variet-agent/debate-agent/ 하위에 배치 (git 추적)
   • Desktop/debate-agent/에 배포하여 AG가 프로젝트로 열 수 있게

미완료

• #490 E2E 테스트: 봇에서 !debate → AG /start 전체 흐름 검증