역할 분리형 AI 협업을 운영 구조로 만든 프레임워크

// v1: 자연어 한국어 절차 → 사람이 읽고 수정
// v2: TypeScript 클래스 → 컴파일 타임 검증 + 이벤트 기반

export class CoordinatorAgent extends AgentBase {
  readonly role: AgentRole = 'coordinator';

  // 1. 어떤 이벤트에 깨어날지 선언
  readonly wakeOn = [
    'file:board-changed',
    'task:moved-to-review',
    'task:approved',
    'task:rejected',
    'clock:tick',
  ];

  // 2. 깨어날지 결정 (board 상태 + 이벤트 type 기반)
  shouldWake(event: OrchestratorEvent, board: Board): boolean {
    if (board.frozen) return false;
    if (event.type === 'task:approved') return true;
    return board.backlog.length < 3;
  }

  // 3. 시스템 prompt + 동적 컨텍스트로 prompt 빌드
  async buildPrompt(event, board): Promise<string> {
    const systemPrompt = await this.loadSystemPrompt();
    const sections = [systemPrompt];
    sections.push(`Rejected: ${board.rejected.length}`);
    sections.push(`In Progress: ${board.inProgress.length}`);
    return sections.join('\n');
  }

  // 4. structured JSON output schema
  getOutputSchema(): object {
    return COORDINATOR_OUTPUT_SCHEMA;
  }
}

핵심 변화: v1의 "매 루프 절차" 자연어가 v2에서는 wakeOn · shouldWake · buildPrompt · getOutputSchema 4개 메서드로 분리. 시스템 prompt는 외부에서 loadSystemPrompt()로 로드 → 동일 페르소나 정의를 v1과 공유.