refactor(topics): 멀티 에이전트용 지식 재편 — _Common(공통 기본기) + Domain_* 구조

에이전트 8종(대화형/프로그래머 C·S/디자이너/설계자/기획자/QA/PD/PM)에게
[공통 기본 능력 + 롤별 Specialty] 2층으로 지식을 주입하기 위한 재분류.
문서 내용·포맷은 무수정, 폴더 이동만 (6,372개 문서 수 보존 확인).

- Topic_Programming → Domain_Programming (내부 구조 보존)
- Topic_Graphic → Domain_Design
- Topic_Business → Domain_Product
- Topic_General → Domain_General
- _Common 신설: Math(구 Topic_Math_Specialty), Reasoning(구 General/From_Thinking & Reasoning),
  Reasoning_Creativity(구 General/From_창의성), Communication(Poetic_Blog_Writing + From_writing)
- 타 도메인의 From_* 폴더는 유지 (출처 표기일 뿐, 이미 도메인에 맞게 분류된 문서)
- 빈 폴더 정리 (memory/procedures)
- 에이전트→폴더 매핑은 workspace의 .astra/agent-knowledge-map.json (9개 에이전트)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Antigravity Agent
2026-07-11 11:05:56 +09:00
parent 6549ead309
commit c24165b8bc
6193 changed files with 1717 additions and 31 deletions
@@ -0,0 +1,32 @@
---
id: HARNESS-RES-2026-05-018
title: Server-Sent Events (SSE)
category: "10_Wiki/Topics/Infrastructure"
status: verified
confidence_score: 0.94
tags: [harness, communication, streaming, sse, real-time, agent-to-agent, mcp]
created_at: 2026-05-05
updated_at: 2026-05-08
---
# Server-Sent Events (SSE)
## 📌 한 줄 통찰 (The Karpathy Summary)
> "에이전트의 실황 중계: 서버가 클라이언트에게 이벤트를 단방향으로 실시간 스트리밍하여, 에이전트의 추론 과정과 결과를 즉각적으로 가시화하는 경량 통신 프로토콜."
## 📖 구조화된 지식 (Synthesized Content)
* **실시간 가시성 지원:** Claude Managed Agents와 같은 플랫폼은 SSE 스트리밍을 기본 기능으로 지원하여 에이전트의 자율적 작동 상태를 사용자가 실시간으로 확인할 수 있게 한다 [1].
* **에이전트 간(A2A) 통신 규격:** Google의 개방형 A2A 프로토콜은 HTTP(S)/SSE 기반의 JSON-RPC를 통신 규격으로 채택하여 에이전트 간의 상호운용성을 확보한다 [2].
* **원격 MCP 전송의 기초:** 원격 MCP 서비스 환경에서 서버는 다중 연결을 처리하기 위해 서버-클라이언트 방향의 SSE 스트림을 활용하며, 이는 Streamable HTTP 전송 체계의 핵심을 이룬다 [2].
## ⚖️ 트레이드오프 및 고려사항
* **상태 저장의 부작용:** 스트림 식별을 위해 `Mcp-Session-Id`와 같은 상태 저장 헤더를 동반하므로, 로드 밸런서의 분산 메커니즘이나 서버의 수평적 확장(Horizontal Scaling)과 구조적으로 충돌한다 [2].
* **웹소켓(WebSockets)과의 차이:** SSE는 HTTP 기반의 단방향 스트리밍에 최적화되어 있어 양방향 통신이 빈번한 환경보다는 모델의 텍스트 생성 결과 전송 등에 더 적합하다. 하지만 상태 유지 제약으로 인해 2026년 이후에는 전송 계층과 세션을 분리하는 아키텍처로의 전환이 요구된다 [2].
## 🔗 지식 연결 (Graph)
- **상위 개념**: [[Communication Protocols]]
- **유사 개념**: [[HTTP+SSE]], [[Streamable HTTP]], [[WebSockets]]
- **관련 프로젝트**: [[ConnectAI]]
---
*Last updated: 2026-05-08*