agent-interaction

name agent-interaction description 에이전트 간 상호작용 구조와 워크플로우 정의 user-invocable false Agent Interaction Guide 에이전트 간 상호작용 구조와 워크플로우를 정의합니다. 팀 구성 ┌─────────────────────────────────────────────────────────┐ │ Strategic Layer │ │ ┌─────────┐ ┌──────────────────┐ │ │ │ CTO │───▶│ Planning Advisor │ │ │ └────┬────┘ └────────┬─────────┘ │ │ │ │ (Codex 호출) │ │ ▼ ▼ │ │ ┌─────────────────────────────────────┐ │ │ │ .context/plan.md │ │ │ └─────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────┐ │ Execution Layer │ │ │ │ ┌───────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ FE Lead │ │ Electron Lead │ │ Platform Lead │ │ │ └─────┬─────┘ └──────┬───────┘ └──────┬───────┘ │ │ │ │ │ │ │ └───────────────┼──────────────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────┐ │ │ │ UX Lead │ (UI 검토) │ │ └─────────────────┘ │ └─────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────┐ │ Support Layer │ │ │ │ ┌──────────────┐ ┌─────────────┐ ┌──────────────┐ │ │ │ DevOps Lead │ │ Test Lead │ │ Tech Writer │ │ │ └──────────────┘ └─────────────┘ └──────────────┘ │ └─────────────────────────────────────────────────────────┘ 워크플로우 Phase 1: 계획 수립 요청 접수 │ ▼ ┌─────────┐ │ CTO │ ─── .context/plan.md 작성 └────┬────┘ │ ▼ ┌──────────────────┐ │ Planning Advisor │ ─── 계획 검토 └────────┬─────────┘ │ ┌────┴────┐ │ 위험도? │ └────┬────┘ │ ┌─────┼─────┐ ▼ ▼ ▼ 저/중 고위험 │ │ │ ▼ │ Codex 검증 │ │ └──┬──┘ ▼ 피드백 반영 │ ▼ 계획 확정 Phase 2: 구현 계획에 명시된 담당 Lead가 작업 수행: 변경 영역 담당 Lead 협업 대상 React 컴포넌트 FE Lead UX Lead Main process Electron Lead Platform Lead IPC 채널 Electron Lead FE Lead launchd 연동 Platform Lead Electron Lead 스타일/디자인 UX Lead FE Lead 빌드/패키징 DevOps Lead - 테스트 Test Lead 해당 Lead 문서 Tech Writer 해당 Lead Phase 3: 검증 구현 완료 │ ▼ ┌──────────────┐ │ Test Lead │ ─── 테스트 커버리지 및 품질 검토 └──────┬───────┘ │ ▼ ┌──────────────┐ │ DevOps Lead │ ─── bun run test && bun run build └──────┬───────┘ │ ▼ ┌──────────────┐ │ UX Lead │ ─── UI 변경 시 시각적 검토 └──────┬───────┘ │ ▼ ┌──────────────┐ │ Tech Writer │ ─── 문서 업데이트 필요 시 └──────────────┘ 공유 아티팩트 파일 용도 작성자 소비자 .context/plan.md 구현 계획 CTO 모든 Lead .context/review.md Planning Advisor 피드백 Planning Advisor CTO CLAUDE.md 프로젝트 가이드 Tech Writer 모든 에이전트 핸드오프 프로토콜 CTO → Planning Advisor ## 계획 검토 요청 plan.md 경로: .context/plan.md 주요 변경: [IPC 추가 / 시스템 연동 / UI 변경 / ...] 예상 위험도: [저 / 중 / 고] Planning Advisor → CTO ## 계획 검토 결과 위험도: [저 / 중 / 고] Codex 검증: [수행 / 생략] ### 이슈 1. ... ### 권고 1. ... 결론: [수정 필요 / 진행 가능] CTO → Lead ## 작업 할당 담당: [FE Lead / Electron Lead / Platform Lead] plan.md 섹션: [해당 섹션 참조] 성공 기준: [구체적 기준] 협업 필요: [다른 Lead와 협업 필요 시] Lead → Lead (협업) ## 협업 요청 요청자: [FE Lead] 대상: [Electron Lead] 내용: IPC 채널 `jobs:newChannel` 추가 필요 스펙: - 입력: { ... } - 출력: { ... } Lead → UX Lead (UI 검토) ## UI 검토 요청 변경 컴포넌트: [JobCard, LogViewer, ...] 스크린샷: [첨부 또는 dev server URL] 체크 포인트: - 디자인 시스템 준수 - 레이아웃 깨짐 Lead → Tech Writer ## 문서 업데이트 요청 변경 내용: [새 IPC 채널 / 새 타입 / ...] 업데이트 대상: [CLAUDE.md / README.md] IPC 변경 시 필수 협업 IPC 채널 추가/수정은 반드시 세 곳을 동시에 변경해야 함: Electron Lead: src/main/ipc.ts (핸들러) │ ├──▶ src/preload/index.ts (contextBridge) │ └──▶ FE Lead: src/renderer/global.d.ts (타입) 협업 순서: Electron Lead가 ipc.ts + preload/index.ts 수정 FE Lead에게 global.d.ts 타입 정의 요청 FE Lead가 렌더러에서 사용 에스컬레이션 Lead → CTO 다음 상황에서 CTO에게 에스컬레이션: 계획에 명시되지 않은 추가 변경 필요 다른 Lead와 의견 충돌 기술적 결정이 필요한 상황 Planning Advisor → CTO 다음 상황에서 계획 수정 요청: Codex가 심각한 이슈 발견 누락된 파일/변경사항 발견 실행 불가능한 계획 완료 조건 모든 작업은 다음을 만족해야 완료: bun run test # 전체 통과 bun run build # 타입 에러 없음 추가로 plan.md에 명시된 성공 기준 충족.