COUNCIL_PATTERN.ko.md

⏳ 크로노스 의회 — 수평적 멀티 에이전트 심의 패턴

"토론은 연극, 판정은 심판의 몫."

Repolis의 크로노폴리스는 작지만 완결된, 실제로 배포된 수평적 멀티 에이전트 심의 루프의 구현체입니다. 여러 동료 LLM 에이전트가 하나의 주제를 동등하게 논쟁하고, 별도의 의장 에이전트가 전체 기록을 읽고 판정을 내립니다. 이 문서는 그 패턴이 무엇이고, 왜 이렇게 생겼으며, 코드의 어디에 있는지를 설명합니다 — 읽고, 재사용하고, 반박할 수 있도록요.

---

한 호흡으로 보는 루프

주제 ─▶ [ 옹호가 ⇄ 회의가 ⇄ 분석가 ]  ↻ 라운드  ─▶ 의장이 전체를 읽고 ─▶ 판정
            (동료, 위계 없음)                        (취합자/심판)

1. 주제가 들어온다. 자유 텍스트 — 완전한 질문, 혹은 reasoning ratio 같은 단어 하나라도 됩니다. 패널은 먼저 그 용어가 뭘 뜻하는지 잡고, 그다음 입장을 정합니다.
2. 패널이 동등하게 논쟁한다. "리더" 에이전트는 없습니다. 각 자리에 역할이 부여되고, 에이전트들은 진행 중인 기록을 읽으며 여러 라운드에 걸쳐 서로의 이름을 부르며 반응하고 반박합니다.
3. 의장이 취합하고, 판정한다. 별도의 의장 에이전트(크로노스)가 토론 전체를 읽고 모든 입장을 종합한 뒤, 논거의 힘으로 결정합니다 — 한쪽을 택하거나 조건부 절충안을 명시하고, 한 줄짜리 근거를 답니다.

핵심 성질은 수평성입니다. 토론자들은 동료입니다. 지능은 어느 한 에이전트 안에 있는 게 아니라, 그들 사이의 구조화된 마찰 더하기 그 결과를 저울질하는 심판에 있습니다.

---

왜 각 자리에 역할을 주나

초기 버전은 세 현자가 "문서 vs 소스 vs 커뮤니티"라는 같은 페르소나를 공유했습니다. 큐레이트된 문서 질문에서는 통했지만, 일반 주제에서는 공허하게 울리고 고정된 시뮬레이션처럼 보였습니다. 역할이 이를 고칩니다 — 각 자리가 어떤 주제에서도 통하는 진짜 토론 입장을 갖습니다:

자리	역할	밀어붙이는 것	말투
🌿 코드짱	옹호가	장점, 이점, 실용적 가치	"이게 되는 이유는…"
📜 올드독	회의가	위험, 함정, 과장, 반례	"정말 그럴까?"
🌀 썰풀이	분석가	맥락, 조건, 트레이드오프	"상황에 따라 다르지 — 핵심은…"

역할은 생산적인 불일치를 만듭니다. 옹호가가 제안하고, 회의가가 스트레스 테스트하고, 분석가가 조건을 답니다 — 그리고 각 에이전트가 서로의 발언을 보기 때문에, 병렬로 독백하지 않고 진짜로 서로에게 답합니다 ("올드독, 비율을 무작정 최대로 올리면 안 된다는 데는 동의해, 그런데…").

---

골든 룰 — 두 가지 판정 모드

판정은 그 출처만큼만 믿을 수 있습니다. 크로노폴리스는 그게 어느 쪽인지 정직하게 밝힙니다:

✅ 큐레이트 사례 → 결정적

직접 작성한 6개 사례(Pydantic, OpenAI SDK, Transformers, HTTP timeout, CSS 가운데정렬, LangChain LCEL)는 고정된 규칙으로 판정됩니다 — 가장 최신의 살아있는 소스가 이깁니다. 같은 입력 → 매번 같은 판정. 검증됨 · 재현 가능 · $0. 그 위의 토론은 연극이고, 그 아래의 계산이 진실입니다. 답을 LLM이 정하지 않습니다.

⚡ 자유 주제 → 의장 LLM

여러분이 입력한 어떤 주제든 의장 모델이 실시간으로 판정합니다. 이는 계산된 사실이 아니라 AI 추론이므로, UI에서 항상 ⚡ 미검증으로 표시되고 비용·빈도 가드 뒤에서 동작합니다. 가치는 신탁의 선언이 아니라 여러분이 지켜보는 추론 과정에 있습니다.

이 구분이 패턴 진정성의 핵심입니다: LLM의 추측을 검증된 사실인 양 포장하지 않는다.

---

읽을 수 있는 속도의 페이싱 (LLM 규칙이 아니라 UX 규칙)

라이브 토론은 읽기도 전에 휙 지나가면 무가치합니다. 클라이언트는 생산자/소비자 페이싱 큐를 돌립니다: 스트리밍된 발언을 버퍼에 담고, 문장 크기 말풍선으로 쪼개, 사람이 읽는 속도(말풍선당 ≈2.4–7.2초, 모델이 너무 앞서갈 때만 따라잡기 가속)로 하나씩 보여줍니다. 판정은 큐가 다 비워질 때까지 보류되므로, 결론이 논거보다 먼저 뜨지 않습니다. 따라갈 수 없는 심의는 심의가 아닙니다.

---

비용 & 안전 가드

자유 주제 토론은 실제 모델을 호출하므로 여러 겹의 가드 뒤에 있습니다: 낮춘 일일 라이브 횟수 캡, 발언당·토론당 토큰 한도, 유휴/중단 타임아웃, 그리고 워커가 스트리밍하지 못할 때의 비용 0 앰비언트 무대로의 우아한 폴백. 토론 한 번에 대략 $0.007–0.011. 키 없는 Cloudflare 워커가 Entra 페더레이션으로 Azure OpenAI에 닿으므로, API 키가 브라우저로 나가지 않습니다.

---

계보

이 패턴은 잘 닦인 연구 흐름 위에 서 있습니다. 크로노폴리스는 그것의 장난스럽고 구체적인 한 사례입니다:

• Multi-Agent Debate — 단일 추론을 믿는 대신, 독립 에이전트들이 토론·비평하며 사실성과 추론을 끌어올림.
• Mixture-of-Agents — 뒤의 에이전트가 앞 동료들의 출력을 읽고 종합하는 계층형 에이전트.
• LLM-as-a-Judge — 별도 모델이 후보 답변을 채점·결정함. 여기서는 의장이 기록을 판정.
• Society of Mind (민스키, 1986) — 단순하고 상호작용하는 다수 에이전트에서 창발하는 지능.

여기서의 기여는 새 알고리즘이 아니라 절제되고 정직한 패키징입니다: 진짜 마찰을 위한 역할, 이해 가능성을 위한 읽기 속도 페이싱, 그리고 검증됨(결정적)과 미검증(LLM) 판정 사이의 분명한 선.

---

코드의 어디에 있나

관심사	파일
자유 주제 역할, 페르소나/프롬프트 구성, 발언당 클램프	council/live.js
SSE 스트리밍 엔드포인트, 범용 의장 시스템 프롬프트, 판정 프롬프트, 토큰 캡	cloudflare-taxi/src/grounded.js
튜너블: 라운드, 토큰 예산, 클램프, 의장 max-tokens, 일일 캡	council/council.config.json
클라이언트 페이싱 큐, 역할 칩, 말풍선 분할, 판정 게이트, 라이브 HUD	index.html (renderChronoCase, conveneLive, streamDebate, pumpBubbles, showKronosVerdict)
현자들 본인	SCHOLARS.md

라이브 마을을 열고 크로노폴리스로 걸어 들어가, 주제를 입력하고, 세 동료가 논쟁하는 동안 시간의 의장이 판정하는 걸 지켜보세요 — 토론은 연극, 판정은 심판의 몫.