9148c358d0
Topic_Agent/Topic_Blog/Topics/Topics_Biz/Topics_Meeting/Topics_Rag의 마크다운 지식 문서를 Topic_General/Topic_Programming/Topic_Graphic/Topic_Business 4개 카테고리로 재분류. - 중복 제거: frontmatter의 status:duplicate/merged + duplicate_of/redirect_to 필드로 자기 자신을 중복으로 선언한 리다이렉트 stub 1032개 제거, 완전 동일 내용 파일 472개 제거, 동일 파일명·다른 내용 충돌 시 더 큰(완전한) 버전만 유지(162개 제거) — 총 1639개 중복 제거. - 분류: 폴더 단위로 명확한 항목(AI_and_ML/Coding/Architecture 등 → Programming, Comfyui/Visual_Effects → Graphic, Topics_Biz/Topics_Meeting/사업 등 → Business, Poetic_Blog_Writing/창의성/Game_Design 등 → General)은 폴더 우선순위로, 나머지 혼재 폴더(Topic_Agent/Topic_Blog/Topics 루트/Thinking & Reasoning/Other/UI_UX_Assets)는 title/tags 키워드 스코어링으로 파일 단위 분류(불명확한 경우 General로 폴백). 원본 폴더명은 "From_*" 서브폴더로 보존해 추적 가능성 유지. - 최종 배치: Programming 2784 / General 1608 / Graphic 285 / Business 249 = 4926개 문서. - 에이전트 운영 상태(.astra/.agent/.obsidian/sessions/memory/_company/docs/lessons/_shared/src)는 지식 콘텐츠가 아니므로 재분류 대상에서 제외하고 원위치 유지. - Topics/Topic_email(상위 보호 폴더 Topic_email과 파일명 100% 중복) 삭제 — 보호 폴더 자체는 미변경. - 완전히 비게 된 Topic_Agent/Topic_Blog/Topics_Biz/Topics_Rag 폴더 제거.
5.3 KiB
5.3 KiB
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-protocols | Protocols | 10_Wiki/Topics | verified | self |
|
none | A | 0.9 | applied |
|
2026-05-10 | pending |
|
Protocols
매 한 줄
"매 communicating parties 가 매 따라야 하는 rules 의 명시". 매 syntax (frame format), 매 semantics (meaning of fields), 매 timing (sequencing) 의 3 axes 로 정의. 매 2026 의 hot stack: HTTP/3 (QUIC), gRPC, MCP (Model Context Protocol), WebSocket, MQTT 5.
매 핵심
매 protocol 의 layers
- Physical / Link: Ethernet, Wi-Fi 7, 5G NR.
- Network: IPv6 (default 2026), IPv4 legacy.
- Transport: TCP, UDP, QUIC.
- Application: HTTP/3, gRPC, MCP, MQTT, AMQP.
매 design dimensions
- Stateful vs stateless: 매 server-side state 보관 여부.
- Sync vs async: 매 request-response vs publish-subscribe.
- Push vs pull: 매 server-initiated vs client-initiated.
- Text vs binary: 매 human-readable vs efficient.
- Versioning: 매 backward / forward compatibility 의 strategy.
매 응용
- Web: HTTP/3 over QUIC — 매 default.
- AI tools: MCP (Anthropic 2024) 매 LLM ↔ tool 의 universal.
- Microservices: gRPC 매 internal RPC.
- IoT: MQTT 5 매 lightweight pub-sub.
- Realtime: WebSocket / WebTransport.
💻 패턴
MCP server (Anthropic, 2026 standard)
from mcp.server import Server
from mcp.types import Tool, TextContent
server = Server("knowledge-base")
@server.list_tools()
async def tools():
return [Tool(
name="query",
description="Query the KB",
inputSchema={
"type": "object",
"properties": {"q": {"type": "string"}},
"required": ["q"],
},
)]
@server.call_tool()
async def call(name, args):
return [TextContent(type="text", text=search(args["q"]))]
gRPC service (.proto + Python)
// kb.proto
syntax = "proto3";
service KB {
rpc Query(QueryRequest) returns (stream QueryChunk);
}
message QueryRequest { string q = 1; }
message QueryChunk { string text = 1; bool done = 2; }
# server.py
import grpc, kb_pb2_grpc, kb_pb2
class KBServicer(kb_pb2_grpc.KBServicer):
def Query(self, request, context):
for chunk in stream_search(request.q):
yield kb_pb2.QueryChunk(text=chunk, done=False)
yield kb_pb2.QueryChunk(done=True)
HTTP/3 client (QUIC)
# httpx + h2/h3
import httpx
async with httpx.AsyncClient(http2=True, http3=True) as client:
r = await client.get("https://api.example.com/v1/users")
print(r.http_version) # "HTTP/3"
WebSocket realtime
import asyncio
import websockets
async def handler(ws):
async for msg in ws:
await ws.send(f"echo: {msg}")
async def main():
async with websockets.serve(handler, "0.0.0.0", 8765):
await asyncio.Future() # run forever
MQTT 5 pub-sub (IoT)
import paho.mqtt.client as mqtt
def on_message(client, userdata, msg):
print(f"{msg.topic}: {msg.payload.decode()}")
client = mqtt.Client(protocol=mqtt.MQTTv5)
client.on_message = on_message
client.connect("broker.example.com", 1883)
client.subscribe("sensors/+/temperature")
client.loop_forever()
Protocol negotiation (capabilities handshake)
# Common pattern: client sends supported versions, server picks highest mutual
def negotiate(client_versions: set[str], server_versions: set[str]) -> str:
common = client_versions & server_versions
if not common:
raise ProtocolError("no compatible version")
return max(common, key=lambda v: tuple(map(int, v.split("."))))
매 결정 기준
| Scenario | Protocol |
|---|---|
| 매 LLM ↔ tools | MCP |
| 매 internal RPC, polyglot | gRPC over HTTP/2 |
| 매 public web API | HTTP/3 + JSON / OpenAPI |
| 매 realtime browser | WebSocket / WebTransport |
| 매 IoT constrained | MQTT 5 / CoAP |
| 매 message queue | AMQP 1.0 / Kafka |
| 매 streaming chat | Server-Sent Events / WebSocket |
기본값: 매 public = HTTP/3 + JSON, 매 internal = gRPC, 매 LLM tools = MCP.
🔗 Graph
- 부모: Distributed-Systems
- 변형: HTTP · gRPC · MCP
- 응용: API-Design · Microservices · 클라우드 인프라 및 IaC 운영 표준
- Adjacent: Interoperability
🤖 LLM 활용
언제: 매 protocol selection, 매 wire format debugging, 매 backward-compat strategy review. 언제 X: 매 single-process in-memory calls — 매 protocol 무용.
❌ 안티패턴
- Custom snowflake protocol: 매 in-house wire format 매 ecosystem 의 X.
- No version negotiation: 매 deploy mismatch → cascade failure.
- Stateful with no session: 매 load balancer 매 sticky session 강제 → scaling pain.
- Chatty protocols: 매 N round trips 매 single op → latency.
🧪 검증 / 중복
- Verified (RFC 9114 HTTP/3, 9000 QUIC; gRPC.io; Anthropic MCP spec 2024; OASIS MQTT 5; OASIS AMQP 1.0).
- 신뢰도 A.
🕓 Changelog
| 날짜 | 변경 |
|---|---|
| 2026-05-08 | Phase 1 |
| 2026-05-10 | Manual cleanup — protocol layers + 2026 modern stack (MCP, HTTP/3, gRPC) |