Files
2nd/10_Wiki/Topics/Domain_General/From_Other/Interoperability.md
T
Antigravity Agent c24165b8bc 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>
2026-07-11 11:05:56 +09:00

4.8 KiB
Raw Blame History

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, verification_status, tags, raw_sources, last_reinforced, github_commit, tech_stack
id title category status canonical_id aliases duplicate_of source_trust_level confidence_score verification_status tags raw_sources last_reinforced github_commit tech_stack
wiki-2026-0508-interoperability Interoperability 10_Wiki/Topics verified self
Interop
System Integration
Cross-Platform Compatibility
none A 0.9 applied
systems
protocols
integration
standards
2026-05-10 pending
language framework
multi standards

Interoperability

매 한 줄

"매 different systems 가 매 friction 없이 함께 작동하는 능력". 매 syntactic (data format), 매 semantic (meaning), 매 organizational (governance) 의 3 layer 로 분해. 매 2026 의 hot topics: MCP (Model Context Protocol), OpenAPI, gRPC, WebAssembly Component Model.

매 핵심

매 3 layers of interop

  • Syntactic: 매 byte-level format 의 agreement (JSON, Protobuf).
  • Semantic: 매 field-meaning 의 agreement (schema + ontology).
  • Organizational: 매 governance, versioning, deprecation policy.

매 enablers

  • Open standards: HTTP, OpenAPI, JSON-Schema, OAuth 2.1.
  • Schema-first: Protobuf, Avro, GraphQL SDL.
  • Capability negotiation: Accept headers, gRPC reflection, MCP capability handshake.
  • Adapter pattern: 매 N×M integration → N+M with hub.

매 응용

  1. AI tool ecosystem: MCP 매 LLM ↔ tools 의 universal protocol.
  2. Microservices: gRPC + Protobuf 매 polyglot interop.
  3. Healthcare: HL7 FHIR 매 EHR interop.
  4. Cross-cloud: Open Container Initiative (OCI), CNCF standards.

💻 패턴

MCP server (2026 standard)

# Model Context Protocol — Anthropic 2024, ubiquitous in 2026
from mcp.server import Server
from mcp.types import Tool, TextContent

server = Server("my-tool")

@server.list_tools()
async def list_tools() -> list[Tool]:
    return [Tool(
        name="search",
        description="Search the knowledge base",
        inputSchema={"type": "object", "properties": {"q": {"type": "string"}}}
    )]

@server.call_tool()
async def call_tool(name: str, args: dict) -> list[TextContent]:
    if name == "search":
        return [TextContent(type="text", text=do_search(args["q"]))]

OpenAPI contract

# 매 syntactic + semantic interop in one file
openapi: 3.1.0
info: { title: User API, version: 2.0.0 }
paths:
  /users/{id}:
    get:
      parameters:
        - { name: id, in: path, required: true, schema: { type: string } }
      responses:
        '200':
          content:
            application/json:
              schema: { $ref: '#/components/schemas/User' }

Protobuf schema-first

// user.proto — language-neutral, version-tolerant
syntax = "proto3";
package user.v1;

message User {
  string id = 1;
  string email = 2;
  reserved 3;  // 매 deprecated field — 매 forward compat
  optional string display_name = 4;
}

Adapter pattern (N+M interop)

class PaymentAdapter:
    def charge(self, amount: int, currency: str) -> str: ...

class StripeAdapter(PaymentAdapter):
    def charge(self, amount, currency):
        return stripe.Charge.create(amount=amount, currency=currency).id

class TossAdapter(PaymentAdapter):
    def charge(self, amount, currency):
        return toss.payments.confirm(amount=amount).payment_key

Wasm Component Model (2026 cross-language)

# 매 binary interop — Rust ↔ Python ↔ Go via Wasm components
[package]
name = "my-component"
version = "0.1.0"

[lib]
crate-type = ["cdylib"]

[dependencies]
wit-bindgen = "0.30"

매 결정 기준

상황 표준
LLM ↔ tools MCP
REST API contract OpenAPI 3.1
High-throughput RPC gRPC + Protobuf
Cross-language binary Wasm Component Model
Healthcare data HL7 FHIR R5
Auth OAuth 2.1 + OIDC

기본값: 매 schema-first + open standard. 매 proprietary format 의 X.

🔗 Graph

🤖 LLM 활용

언제: 매 protocol selection, 매 schema design review, 매 adapter scaffolding. 언제 X: 매 single-team monolith 의 internal modules — over-engineering.

안티패턴

  • Snowflake protocols: 매 in-house custom protocol → 매 every consumer N×N adapters.
  • Schema drift: 매 producer / consumer 매 separate schema copies → 매 silent breakage.
  • No versioning: 매 breaking change broadcast → cascade failure.
  • Tight coupling via DB: 매 shared DB schema 매 anti-interop.

🧪 검증 / 중복

  • Verified (W3C, IETF, IEEE standards; Anthropic MCP 2024 spec; gRPC.io; CNCF landscape 2026).
  • 신뢰도 A.

🕓 Changelog

날짜 변경
2026-05-08 Phase 1
2026-05-10 Manual cleanup — 3-layer interop, MCP/OpenAPI/Wasm patterns