업데이트 내역

변경 기록

2026-03-29

변경 요약

• communication.mdx에 대규모 이벤트 스트리밍 아키텍처 섹션 추가: Kafka/Pub-Sub 기반 에이전트 오케스트레이션, Saga 패턴(보상 메커니즘), 메시지 순서 보장(partition key 전략), Dead Letter Queue, Mermaid 다이어그램
• 핸드북 전체 용어 통일: "specialist agent" -> "worker agent"
• index.mdx에 핵심 용어(Glossary) 섹션 추가: Orchestrator, Worker Agent, Handoff, Delegation, Tool 정의
• index.mdx updatedAt 갱신

영향 챕터

• index.mdx — updatedAt 갱신, 핵심 용어 섹션 추가
• communication.mdx — 대규모 이벤트 스트리밍 아키텍처 섹션 추가
• routing-dispatch.mdx — "specialist agent" -> "worker agent" 용어 통일
• updates.mdx

2026-03-27

변경 요약

• A2A v1.0.0 정식 출시 반영: Agent Card 공식 스펙, Task 라이프사이클(working→input-required→auth-required→completed/failed), gRPC 전송, 스트리밍 API, 150+ 조직 참여, Linux Foundation 관리
• MCP 2026 로드맵 반영: Transport Scalability(Streamable HTTP 수평 확장), MCP Server Cards(.well-known/mcp.json), 멀티에이전트 MCP 패턴, Enterprise Readiness(감사 추적, SSO, 게이트웨이), 97M 월간 SDK 다운로드
• Microsoft Agent Framework GA: AutoGen + Semantic Kernel 통합, 그래프 기반 워크플로우, A2A/AG-UI/MCP 프로토콜 지원
• CrewAI v1.12.1: Flows 패턴(이벤트 드리븐, 12M+ 실행/일), Qdrant Edge 메모리, human-in-the-loop
• 2026 프로덕션 오케스트레이션 5가지 패턴: Orchestrator-Worker(~70%), Hierarchical, Swarm, Mesh, Pipeline + 하이브리드 패턴(계층+mesh, 파이프라인+swarm, Agentic Mesh)
• Claude Code --channels: 이벤트 드리븐 에이전트 패턴(MCP 서버 푸시)
• OpenAI Agents SDK 0.13.1: WebSocket 전송, 도구 검색 네임스페이스
• 엔터프라이즈 운영 기반: 감사 추적, SSO 통합, API 게이트웨이, 멀티테넌트 격리 패턴

영향 챕터

• index.mdx — updatedAt 갱신
• mcp-a2a.mdx — A2A v1.0.0, MCP 2026 로드맵, MCP Server Cards
• architecture-patterns.mdx — 2026 프로덕션 패턴 5가지, Swarm, Mesh, 하이브리드
• framework-comparison.mdx — MS Agent Framework GA, CrewAI v1.12.1, OpenAI Agents SDK 0.13.1
• communication.mdx — 이벤트 드리븐 에이전트 패턴, Claude Code --channels
• production.mdx — 엔터프라이즈 운영 기반
• updates.mdx

근거 링크(공식)

• https://a2a-protocol.org/latest/
• https://modelcontextprotocol.io/blog/2026-roadmap
• https://github.com/microsoft/agents
• https://docs.crewai.com/
• https://openai.github.io/openai-agents-js/
• https://google.github.io/adk-docs/

2026-03-15

변경 요약

• 초판 플레이스홀더를 실질적인 핸드북 본문으로 확장
• 장별 공통 구조를 언제 쓰는가 -> 원칙/패턴 -> 실패 모드 -> 체크리스트로 정리
• MCP/A2A와 프레임워크 비교 장에 공식 문서 링크 추가
• 색인 페이지에 추천 독서 경로와 핵심 질문 추가
• 핵심 장에 다음에 읽을 장을 추가해 책 흐름 강화
• 패턴/라우팅/프로덕션 장에 최소 구현 스켈레톤 추가
• 사례 장에 입력·상태·승인·fallback 운영 포인트 표 추가
• handbook 범위 검증이 가능하도록 lint/typecheck 보조 코드 정리

영향 챕터

• index.mdx
• foundations.mdx
• architecture-patterns.mdx
• agent-design.mdx
• tool-design.mdx
• mcp-a2a.mdx
• communication.mdx
• state-memory.mdx
• routing-dispatch.mdx
• error-recovery.mdx
• evaluation.mdx
• production.mdx
• case-studies.mdx
• framework-comparison.mdx
• verification.mdx
• updates.mdx
• apps/handbook/lib/source.ts
• apps/handbook/app/(docs)/books/[[...slug]]/page.tsx
• apps/handbook/next.config.ts
• apps/handbook/scripts/check-handbook-date.mjs
• apps/handbook/scripts/check-update-dates.mjs
• apps/handbook/scripts/check-ios-app-enterprise-operations.mjs
• apps/handbook/scripts/check-android-app-enterprise-operations.mjs

근거 링크(공식)

• https://modelcontextprotocol.io/
• https://a2a-protocol.org/latest/
• https://docs.langchain.com/oss/python/langgraph
• https://docs.crewai.com/
• https://microsoft.github.io/autogen/stable/index.html
• https://openai.github.io/openai-agents-js/
• https://ai-sdk.dev/docs/agents
• https://mastra.ai/

검증 결과

• yarn lint --filter=handbook
• yarn typecheck --filter=handbook
• NEXT_DIST_DIR=.next-codex-build yarn build --filter=handbook

템플릿

### YYYY-MM-DD

**변경 요약**

- ...

**영향 챕터**

- `...`

**근거 링크(공식)**

- ...