헤르메스 사례글 4 — [WEEK2] Skill 분해와 엄브렐러 Tree (상세본 v2.0)
2026.08.02
소개
2-1. 이 편의 위치
편 | 노드 | 스킬 | 층 | 역할 렌즈 |
|---|---|---|---|---|
1 | N1 | 명식 파싱 | 판단 | INTAKE |
2 | N2 | 계통 라우팅 | 판단 | ROUTING |
3 | N3 | 계통별 RAG 검색 | 판단 | INTAKE(Retrieval) |
4 | — | 엄브렐러 | 조립 | ORCHESTRATION |
5 | — | Proof·Gate | 규율 | PROOF · GATE |
6 | — | GuardrailAgent | 규율 | VERIFICATION |
장표의 역할 렌즈 9종(INTAKE·ROUTING·GENERATION·VERIFICATION·QA·PROOF·GATE·REPAIR·DELIVERY)에 얹어 보니 빈칸이 드러났습니다. GENERATION(N5 합성)·DELIVERY(리포트 전달)·REPAIR가 아직 없습니다. 12편 시리즈의 나머지가 그 자리입니다.
2-2. 기본과제 5산출물 대조
# | 요구 산출물 | v1.0 | v2.0 |
|---|---|---|---|
1 | 분해된 작은 Skill 1개 이상 | ✅ N1·N2·N3 (1~3편) | ✅ |
2 | Skill 인터페이스 카드 | ❌ 없음 | ✅ 8필드 3장 (§3-4) |
3 | Umbrella Skill Tree | △ 호출 그래프를 트리라 부름 | ✅ 소속 트리 분리 (§3-2) |
4 | 연결 흐름 (순서·분기·조건부 환류) | △ 순서·분기만, 환류 없음 | ✅ 환류 신설 (§3-6) |
5 | 사례글 | ✅ | ✅ |
2-3. 제1원칙 재정의
v1.0의 원칙 — 하위 스킬을 재작성하지 말고 호출로만 엮는다. v2.0의 원칙 — 하위 스킬을 재작성하지 않는다. 그리고 결과·실패·기준이 위로 돌아와 다음 행동을 바꾸게 한다.
앞 문장은 그대로 유효합니다. S6이 S3의 프롬프트를 복사해 오면 진실이 둘이 되고, 감사 추적이 끊깁니다. 등재 심사가 요구하는 것은 정확한 답이 아니라 추적 가능성이므로 이 원칙은 코딩 취향이 아니라 요건입니다.
문제는 뒷문장이 없었다는 것입니다. "재작성 금지"를 지키려다 "환류 금지"까지 해 버린 것이 v1.0의 오독입니다. 조립층이 하지 말아야 할 것은 하위의 판단을 대신하는 일이지, 하위의 실패를 받아 다음 호출을 바꾸는 일이 아닙니다. 후자는 오히려 조립층의 본업입니다.
진행 방법
3-1. 사용 도구
도구 | 용도 | 확정 여부 |
|---|---|---|
LangGraph | 노드·엣지·조건부 분기 | 버전 미실측 (§8-3) |
Python | 상태 스키마 고정 | 확정 |
pytest | 조립층 순수성 검사 | 미작성 |
PostgreSQL | N3만 접근. 조립층은 직접 접근 안 함 | 서버 미접속 |
조립층 도구 목록에 DB가 없는 것이 정상입니다. 조립층이 SELECT를 한 줄이라도 쓰면 N3의 책임을 훔쳐 온 것입니다.
3-2. Umbrella Tree — 소속·주소 (무엇이 어디에 속하는가)
장표의 구분을 그대로 따릅니다. 트리는 소속을 답하고, 그래프는 호출을 답합니다. v1.0은 이 둘을 한 그림에 넣어 트리라고 불렀는데, 그것은 트리가 아니라 회로였습니다.
text
UMBRELLA · hermes-tongbyun
목적 : 명식 질의에 근거를 붙여 답한다
경계 : 합성·전달은 하지 않는다 (12편 시리즈 후반)
공통기준: 근거는 (source, slide_number) 복합키로만 인용한다
│
├── member_of ▸ skill-n1-parse-saju [INTAKE] v0.2.0
├── member_of ▸ skill-n2-route-lineage [ROUTING] v0.3.0
├── member_of ▸ skill-n3-search-evidence [INTAKE·검색] v0.3.0
├── member_of ▸ skill-code-as-gate [GATE] v0.1.0 (5편)
└── member_of ▸ skill-guardrail-eval [VERIFY] v0.2.0 (6편)주 소속은 하나, 연결은 여럿입니다. 예컨대 skill-guardrail-eval은 이 엄브렐러에 속하지만, 프로덕션 11노드 파이프라인의 기존 GuardrailAgent와도 관계를 맺습니다. 그 관계는 트리가 아니라 그래프에 그립니다.
3-3. Umbrella Graph — 호출·전달·환류 (무엇이 무엇을 부르는가)
text
┌──────────────── CONDITIONAL RETURN ───────────────┐
│ (근거 0건 · 계통 재판단 필요) │
▼ │
[N1 파싱] ──chains_with──▶ [N2 라우팅] ──chains_with──▶ [N3 검색]
│ │ │
│ 4주 미확정 │ HELD │ 상한 도달
└────────────┬───────────┴──────────────────────────┘
▼
[OWNER] ← 실패 신호의 수신자
│
├─ 자동 수리 가능 → 재시작
└─ 불가 → blocked + 사유 보존
│
▼
[GATE] ──▶ [PROOF] ──▶ END (5편)연결됨 ≠ 합쳐짐. N2와 N3 사이에 환류 엣지가 생겨도 두 스킬의 책임은 그대로입니다. 계통을 정하는 것은 여전히 N2뿐이고, 조립층은 "다시 정해 달라"고 요청할 뿐 스스로 정하지 않습니다.
3-4. Skill 인터페이스 카드 — 8필드 3장
기본과제 필수 산출물인데 v1.0에 없었습니다. 특히 MUST NOT(하지 않는 일) 필드가 빠져 있던 것이 뼈아픕니다. 책임 경계는 "무엇을 하는가"보다 "무엇을 하지 않는가"에서 더 선명해집니다.
카드 1 — skill-n1-parse-saju
필드 | 내용 |
|---|---|
이름 | 명식 파싱 (N1) |
역할 | 생년월일시를 4주(時|日|月|年)로 확정한다 |
Use when | 통변 요청 최초 1회 (세션당 캐시) |
Input |
|
Output |
|
RETURN(다음 상태) | 4주 확정 → N2로. 경계일 경고는 값이 아니라 꼬리표로 함께 넘김 |
실패·되돌림 | 4주 중 하나라도 미확정 → OWNER("명식 미확정") |
MUST NOT | 절기·경도 값을 추정하지 않는다. 계통을 판단하지 않는다. |
카드 2 — skill-n2-route-lineage
필드 | 내용 |
|---|---|
이름 | 계통 라우팅 (N2) |
역할 | 질의의 각 단계에 어느 계통(①탈XX 4관법 / ②박청화 / ③상리철학)을 배정할지 정한다 |
Use when | N1 완료 후, 또는 N3 근거 0건 환류를 받았을 때 |
Input |
|
Output |
|
RETURN | ROUTED → N3로. HELD → OWNER(사용자 확인 필요) |
실패·되돌림 | 계통 미지정 → HELD. 임의 기본값을 넣지 않는다 |
MUST NOT | 검색하지 않는다. 근거의 질을 평가하지 않는다. 세 계통을 한 단계 안에서 섞지 않는다. |
카드 3 — skill-n3-search-evidence
필드 | 내용 |
|---|---|
이름 | 계통별 RAG 검색 (N3) |
역할 | 배정된 계통 안에서 근거를 회수한다 |
Use when |
|
Input |
|
Output |
|
RETURN | 근거 ≥1 → GATE로. 0건 → N2 재라우팅 환류 또는 재검색 |
실패·되돌림 | 상한 도달 → OWNER("근거 미확보") |
MUST NOT | 계통을 바꾸지 않는다. 근거를 요약·가공하지 않는다. 스텁을 채워 넣지 않는다. |
세 카드의 MUST NOT을 나란히 놓으면 경계가 한눈에 보입니다. N1은 계통을 모르고, N2는 근거를 모르고, N3는 계통을 못 바꿉니다.
3-5. 상태 스키마
python
# hermes_state.py (layer: 조립)
from typing import TypedDict, Literal
class HermesState(TypedDict, total=False):
question: str
birth_info: dict
# N1
saju: dict
warnings: list[str]
# N2
lineage_plan: dict
route_status: Literal["ROUTED", "HELD"]
route_reason: str
reroute_count: int # ★ v2.0 신설 — 환류 횟수
# N3
evidence: list[dict]
retry_count: int
# 조립층 소유
owner_signal: dict # ★ v2.0 신설 — {stage, reason, repairable}
halt_reason: str
skill_versions: dict
call_trace: list[dict]owner_signal과 reroute_count가 v2.0 신설분입니다.
3-6. StateGraph — 환류와 OWNER
python
# hermes_umbrella.py (layer: 조립) — 판단 로직 0줄
from langgraph.graph import StateGraph, START, END
from hermes_state import HermesState
import skill_n1_parse_saju as s1
import skill_n2_route_lineage as s2
import skill_n3_search_evidence as s3
MAX_RETRY = 3 # ⚠ 근거 없는 임의값 — §8-1 1번
MAX_REROUTE = 1 # ⚠ 환류 상한도 임의값 — §8-1 2번
def n1_parse(state):
out = s1.run(state["birth_info"])
return {"saju": out.get("saju", {}), "warnings": out.get("warnings", []),
"skill_versions": {**state.get("skill_versions", {}), "N1": s1.VERSION}}
def n2_route(state):
out = s2.run(state["question"], state["saju"],
failed_plan=state.get("lineage_plan") if state.get("reroute_count") else None)
return {"lineage_plan": out.get("lineage_plan", {}),
"route_status": out.get("status", "HELD"),
"route_reason": out.get("reason", ""),
"retry_count": 0, # 재라우팅 시 검색 회차 초기화
"skill_versions": {**state.get("skill_versions", {}), "N2": s2.VERSION}}
def n3_rag(state):
out = s3.run(state["question"], state["lineage_plan"],
attempt=state.get("retry_count", 0))
return {"evidence": out.get("evidence", []),
"retry_count": state.get("retry_count", 0) + 1,
"skill_versions": {**state.get("skill_versions", {}), "N3": s3.VERSION}}
def owner(state):
"""실패 신호의 수신자. 사유를 만들지 않고 받아 적는다."""
return {"halt_reason": state.get("owner_signal", {}).get("reason", "미상")}
# ── 분기: 상태를 읽기만 한다 ─────────────────────────────
def after_n1(state):
return "N2_route" if len(state.get("saju", {})) == 4 else "OWNER"
def after_n2(state):
return "N3_rag" if state.get("route_status") == "ROUTED" else "OWNER"
def after_n3(state):
if state.get("evidence"):
return "GATE"
if state.get("retry_count", 0) < MAX_RETRY:
return "N3_rag" # 같은 계통 재검색
if state.get("reroute_count", 0) < MAX_REROUTE:
return "N2_route" # ★ 조건부 환류
return "OWNER"
g = StateGraph(HermesState)
for name, fn in [("N1_parse", n1_parse), ("N2_route", n2_route),
("N3_rag", n3_rag), ("OWNER", owner)]:
g.add_node(name, fn)
g.add_edge(START, "N1_parse")
g.add_conditional_edges("N1_parse", after_n1, ["N2_route", "OWNER"])
g.add_conditional_edges("N2_route", after_n2, ["N3_rag", "OWNER"])
g.add_conditional_edges("N3_rag", after_n3, ["N3_rag", "N2_route", "GATE", "OWNER"])
# GATE·PROOF는 5편에서 연결. OWNER → GATE로도 간다 (실패도 증적을 남긴다)
app = g.compile() # ⚠ 미실행 — §8-3환류가 재검색과 다른 점을 보십시오. 재검색은 같은 계통 안에서 다시 찾는 것이고, 환류는 계통 배정 자체가 틀렸을 수 있다고 보고 N2에게 되돌리는 것입니다. 근거가 계속 0건이면 검색어가 나쁜 게 아니라 엉뚱한 계통을 뒤지고 있을 가능성이 큽니다. v1.0은 그 가능성을 구조적으로 배제하고 있었습니다.
환류 시 조립층이 하지 않는 것: 새 계통을 지정하지 않습니다. 실패한 배정(failed_plan)과 함께 "이 배정으로는 근거가 없었다"는 사실만 넘기고, 다시 정하는 것은 N2의 판단입니다.
3-7. 조립층 순수성 검사
python
# test_assembly_purity.py
import pathlib, re
ASSEMBLY = pathlib.Path("hermes_umbrella.py").read_text(encoding="utf-8")
FORBIDDEN = [
r"plainto_tsquery|SELECT\s", # N3의 검색 책임
r"황경|절기|60갑자", # N1의 파싱 책임
r"탈XX|박청화|상리철학", # N2의 계통 판정 책임
]
def test_no_judgment_logic_in_assembly():
hits = [p for p in FORBIDDEN if re.search(p, ASSEMBLY)]
assert not hits, f"조립층에 판단 로직 혼입: {hits}"언젠가 반드시 실패할 테스트입니다. 급할 때 조립층에 한 줄 끼워 넣는 유혹이 오기 때문에, 그때 CI가 막아 주는 것이 목적입니다.
3-8. 점진적 맥락 공개와의 접점
Anthropic 공식 문서가 말하는 점진적 공개는 모든 맥락을 앞에 쌓지 않고, 탐색 결과가 다음 판단을 바꾸도록 층층이 여는 전략입니다. W2 장표는 이것과 Skill 구조가 다른 질문에 답한다고 정리합니다 — 전자는 언제 무엇을 보여줄까, 후자는 누가 어디서 책임질까.
헤르메스에서는 두 가지가 이렇게 만납니다. 조립층은 처음부터 148강 전체를 문맥에 밀어 넣지 않고, N2가 배정한 계통 범위만 엽니다. 그 범위에서 근거가 안 나오면 범위를 넓히는 게 아니라 배정을 다시 묻습니다. 노출 전략과 책임 구조가 각자 자리를 지키는 형태입니다.
(이미지 자리 — Tree 1장 + Graph 1장. React/JSX 스타일, Mermaid 아님)
결과와 배운 점
4-1. 초안·v1.0의 결함 종합
# | 결함 | 발견 시점 | 심각도 |
|---|---|---|---|
① |
| v1.0 | 치명 |
② | 재검색 루프가 무한 동일 재시도가 될 수 있음 | v1.0 | 높음 |
③ | 하위 스킬 버전이 어디에도 안 남음 | v1.0 | 높음 |
④ | Tree와 Graph를 뭉갬 | v2.0 | 중 |
⑤ | 인터페이스 카드 없음 (필수 산출물) | v2.0 | 높음 |
⑥ | 조건부 환류 없음 — 아래로만 흐름 | v2.0 | 치명 |
⑦ | FAIL 신호의 수신자 없음 | v2.0 | 중 |
⑧ | 판정 어휘 | v2.0 | 중 |
①은 판단층 세 개가 각자 옳았는데 붙이는 방식이 틀려서 전체가 틀린 사례였고, ⑥은 붙이는 방식이 한 방향만 있어서 전체가 학습하지 못한 사례입니다. 성격이 다릅니다.
4-2. 설계 변경 기록 (v1.0 → v2.0)
# | v1.0 | v2.0 | 근거 |
|---|---|---|---|
1 | 트리 1장 (호출+소속 혼재) | Tree(소속) + Graph(호출·환류) 2장 | W2-23 |
2 | 계약표 (입력/출력/실패) | 인터페이스 카드 8필드 × 3 | W2-24·35 |
3 | 하향 단방향 | 조건부 환류 (N3→N2) | W2-31 |
4 | HALT 노드 (종점) | OWNER 노드 (신호 수신자) | W2-36 |
5 |
|
| 수행 Skill 규정 |
4-3. 조립층 안티패턴 4종 (1종 추가)
# | 안티패턴 | 증상 |
|---|---|---|
① | 재작성 — 하위 프롬프트를 조립층에 복붙 | 하위 수정이 반영 안 됨. 진실 2개 |
② | 후보정 — 하위 출력을 조립층이 손봄 | 계약 위반이 은폐됨 |
③ | 우회 — 급해서 조립층이 DB를 직접 조회 | 계통 필터·스텁 배제가 통째로 우회 |
④ | 삼킴 — 하위 실패를 위로 올리지 않고 아래로만 흘림 | 실패가 학습 신호가 되지 못함 |
④가 v2.0 신설입니다. ①~③이 "조립층이 너무 많이 한다"는 병이라면, ④는 "조립층이 너무 적게 한다"는 병입니다. 둘 다 존재하고, v1.0은 전자를 피하려다 후자에 걸렸습니다.
4-4. 실패 전파 정책 — 삼키지 않고, 되돌린다
text
하위 실패 → 조립층이 기본값으로 메움 ✗ 그럴듯한 거짓이 생산됨
하위 실패 → 조립층이 사유만 올리고 끝 △ v1.0. 정직하지만 학습이 없음
하위 실패 → 사유를 올리고, 가능하면 되돌려 재판단 ✓ v2.0세 번째만이 유기적 연결입니다. 다만 되돌림에는 반드시 상한이 필요합니다 — 상한 없는 환류는 무한 루프이고, 그것은 fail-closed가 아니라 fail-forever입니다.
4-5. 복합키 인용 — 조립층이 쌍으로 운반해야 하는 것
slide_number는 전역 고유값이 아닙니다. 정진반 上과 제트엔진 上이 7001~7098 대역을 공유합니다. 조립층은 근거를 옮길 때 (source, slide_number) 쌍을 분해하지 않고 그대로 넘깁니다. "보기 좋게 slide 번호만 모아 정리" 같은 가공이 여기서 치명상이 됩니다.
4-6. 관리벽 4층에서 지금 위치
장표는 Skill이 많아지면 Indexer(뭐가 있나) → Navigator(뭘 쓸까) → Taxonomy(무슨 종류) → Ontology(어떻게 얽히나) 순으로 새 질문이 생긴다고 정리합니다. 그리고 이것들은 W2 필수 산출물이 아니라, 복잡성이 늘 때 만나게 될 다음 벽이라고 못 박습니다.
제 상황을 솔직히 적으면 이렇습니다.
층 | 제 현황 | 판단 |
|---|---|---|
Indexer | 스킬 5개 — 목록 폭증 없음 | 불필요 |
Navigator | N2가 계통을 고르지만 스킬을 고르지는 않음 | 아직 불필요 |
Taxonomy | 3대 계통 구분이 사실상 분류 축 | 이미 있음 |
Ontology | 온톨로지 레이어를 별도로 설계 중 (5도메인·6관계유형) | 선행 착수 |
온톨로지를 먼저 손대고 있는 것은 스킬이 많아서가 아니라 RAG 유사도 문제(실측 0.5395 vs 목표 0.80) 때문입니다. 성격이 다른 동기이므로, W2 관리벽 이야기와 혼동하지 않도록 여기 명시해 둡니다.
4-7. 꿀팁 · 시행착오 · 도움 필요
꿀팁 1 — Skill 하나에 역할 하나. 반대로 조립층에 if가 늘어나면 판단이 새어 들어온 신호입니다. 조립층의 if는 상태를 읽는 if만 허용됩니다(§3-6의 after_* 3개가 전부).
꿀팁 2 — 트리는 성공 경로가 아니라 실패 경로로 그린다. 실패 시 줄을 넣자마자 결함 ①이 보였습니다.
꿀팁 3 — MUST NOT을 먼저 쓴다. 세 카드에서 가장 오래 걸린 칸이 MUST NOT이었고, 가장 많이 배운 칸도 그것이었습니다. "N2는 근거의 질을 평가하지 않는다"를 적고 나서야, 제가 N2에게 검색 품질까지 기대하고 있었다는 걸 알았습니다.
시행착오 1. 초기 통합 Skill이 검색·합성을 함께 처리해서, 답이 이상할 때 어디가 나쁜지 구분할 수 없었습니다 → 책임 분리.
시행착오 2. 조립 스킬이 하위를 재작성했다가 진실이 갈라졌습니다 → 호출로 교정, 그리고 문서가 아니라 테스트로 고정.
시행착오 3. 위 둘을 고치고 나서 엣지가 조건부가 아니라는 더 큰 문제를 발견했습니다.
시행착오 4 (v2.0). 그것까지 고치고 나서, 이번엔 되돌아오는 길이 아예 없다는 것을 장표 대조로 알았습니다. 세 번 연속 같은 패턴입니다 — 원칙 위반보다 배선 구조의 결손이 더 조용하고 더 치명적입니다.
도움 필요 1. 환류 상한(현재 1회)의 기준. 회수가 아니라 "직전 배정과 동일한 계통이 다시 나오면 즉시 중단"이 낫다고 보는데, 실제로 쓰시는 종료 조건이 궁금합니다.
도움 필요 2. 하위(S3)를 고쳤을 때 상위 회귀를 어떻게 잡으시는지. 골든셋 4건 + 회귀 러너는 있는데 조립층 단위 골든셋은 아직 없습니다.
4-8. 첫 실행 로그
검증 상태 어휘 (공식 4종) — v1.0에서 쓴 partial은 폐기합니다.
상태 | 뜻 | 이 편의 적용 |
|---|---|---|
| 기준 충족 | 세 질의가 예상 종료 지점 도달 |
| 실행됐으나 기준 미달 | N2 HELD인데 N3로 진행 등 |
| 확인하지 않음 | 현재 상태 |
| 실행을 막는 이유가 있음 | 하위 3종 인터페이스 미구현으로 컴파일 불가 |
엄밀히는 지금 상태가
blocked에 가깝습니다. 하위 스킬이run()·VERSION계약을 구현하지 않아 컴파일 자체가 불가하기 때문입니다. 다만 그 차단을 실제로 확인해 보지 않았으므로not_checked로 둡니다. 차단을 주장하려면 그것도 실행해서 확인해야 합니다.
run-log (6줄 형식)
text
실행한 것: (없음 — 그래프 미컴파일)
입력: 골든셋 명식 1건 + 질의 3종(정상 / N2 HELD 유도 / N3 근거 0건 유도)
관찰한 결과: —
완료 기준 판정: not_checked
막힌 것: 하위 3종의 run()·VERSION 인터페이스 미구현
확인하지 못한 것: LangGraph 버전, add_conditional_edges 시그니처, 환류 경로 동작 전부항목별 상세
# | 항목 | 기록 |
|---|---|---|
01 | 환경 · Skill | (예정) Python 3.11 + LangGraph / |
02 | 입력 · 예상 | 질의 3종 → END·OWNER(계통 미지정)·OWNER(근거 미확보) |
03 | 실제 결과 | — (§3-6은 명세이며 실행 산출물 아님) |
04 | 판정 기준 |
|
05 | 잘된 점 · 막힌 점 | 잘된 점: 장표 대조로 환류 결손(결함 ⑥)을 실행 전 발견 |
06 | 다음에 수정할 한 가지 | 하나만 — 하위 3종에 |
07 | 최종 상태 |
|
08 | 검증 방법 | 미해당 (executable_test / agent_inspection / user_manual 중 무엇도 수행 안 함) |
4-9. 사례글 6요소 대응
장표가 제시한 2주차 사례글 6요소에 본문을 매핑합니다.
요소 | 본문 위치 |
|---|---|
하려던 일 | §2-1·2-2 |
흔들린 지점 | §4-1 결함 ①~⑧ |
분해 기준 | §3-4 MUST NOT 세 줄 |
연결 구조 | §3-2 Tree + §3-3 Graph + §3-6 환류 |
실행 근거 | §4-8 — |
배운 점 · 다음 질문 | §4-7 · §5 |
⑤가 비어 있는 것이 현재의 정직한 상태입니다. 채우지 않고 비었다고 적습니다.
< 앞으로의 계획 >
직접 연결 — 사례글 5 (Proof Artifact & Code as Gate). 4편의 call_trace·owner_signal이 5편 증적의 입력원이 됩니다.
W3 예고 질문. 장표는 W2가 능력과 인터페이스, W3가 시작·통과·중단·수리(Trigger·Context·상태 전환·Approval·Retry·Stop)라고 정리합니다. 4편에서 남은 질문이 정확히 W3의 것입니다.
환류를 몇 번까지 허용할 것인가 (Retry)
어느 지점에서 사람에게 넘길 것인가 (Approval)
무엇을 보면 완전히 멈출 것인가 (Stop)
주의 — 사이드카 원칙. 이 엄브렐러는 기존 11노드 파이프라인(배치 360건 100% 성공)을 호출하지도 수정하지도 않습니다. 별도 그래프로 병렬 운영합니다. 반성문 총괄표에서 가장 자주 반복된 실수가 "기능 추가 시 기존 기능 파괴"이기 때문입니다.
도움 받은 글 (옵션)
23기 W2 정규세션 장표 — Tree·Graph 구분, 인터페이스 카드, 조건부 환류, 역할 렌즈, 관리벽 4층
23기 W2 수행 Skill — 검증 상태 4종 어휘, run-log 형식
Anthropic 공식 — 점진적 맥락 공개(Effective context engineering for AI agents)
韓바둑 통변 고급화 전략 v2.0 —
rtype5종, fail-closed 정책Claude 반성문 총괄표 v3.7 — 기능 추가 시 기존 기능 보존
로그인하고 댓글을 남겨 주세요
트리는 소속을 답하고 그래프는 호출을 답한다는 정리도 평소 헷갈리던 개념. 너무 잘설명해주싱거 같습니다
감사합니다. 사실 저도 오래 헷갈렸고, v1.0에서는 둘을 한 그림에 그려 놓고 모른 채로 있었습니다.
구분이 안 될 땐 이렇게 해보시면 바로 갈립니다. 그림에 "실패하면 어디로 가나"를 적어보는 겁니다. 트리에는 그 줄이 안 써집니다. 소속은 성공하든 실패하든 바뀌지 않으니까요. 반대로 그 줄이 써지기 시작하면 그건 이미 그래프입니다.
회사로 치면 조직도와 업무 흐름도의 차이입니다. 조직도에 "결재 반려될 때는 이쪽으로" 화살표를 그리기 시작하면, 그건 더 이상 조직도가 아니죠.
읎으신 거 감사합니다.
v2.0에서 신설된 안티패턴 ④ "삼킴"이 특히 날카롭습니다. ①~③이 "조립층이 너무 많이 한다"는 병이라면, ④는 "너무 적게 한다"는 병이라는 구분 — v1.0이 전자를 피하려다 후자에 걸렸다고 정직하게 쓰신 게 인상적이었어요. 결손은 위반보다 조용하고 더 치명적이라는 문장, 오래 남을 것 같습니다.
인터페이스 카드에서 MUST NOT 칸을 쓰는 데 가장 오래 걸렸다고 하셨는데, 세 카드의 MUST NOT을 나란히 놓으면 "N1은 계통을 모르고, N2는 근거를 모르고, N3는 계통을 못 바꾼다"는 경계가 한눈에 보인다는 부분도 좋았어요. 책임 경계는 무엇을 하는가보다 무엇을 하지 않는가에서 더 선명해진다는 것, 스킬 설계뿐 아니라 여러 곳에 쓸 수 있는 원칙이네요.
꼬리 흔들며 응원하고 갑니다 🐈⬛



한바둑님, 4편은 앞의 세 편에서 만든 N1·N2·N3를 단순히 한 줄로 이어 붙이는 데서 끝내지 않고, 누가 무엇을 맡고 실패하면 어디로 돌아가는지까지 구조로 끌어올린 글로 읽혔습니다. v1.0에서 “하위 스킬을 재작성하지 않는다”를 “환류도 하지 않는다”로 받아들였던 부분을 스스로 짚고, v2.0에서 Tree와 Graph를 분리한 과정이 특히 좋았어요. 소속과 실행 흐름을 나누니 N3가 근거를 못 찾았을 때 N3 안에서 다시 찾을지, N2에 계통 배정을 다시 물을지가 눈에 보입니다. 독자 입장에서도 엄브렐러 Skill은 하위 기능을 대신하는 층이 아니라, 결과와 실패를 받아 다음 호출을 정하는 층이라는 점이 선명해졌습니다.
설계 원칙을 그림으로만 설명하지 않고 인터페이스 카드, 상태 스키마, 조건부 경로, 테스트 기준까지 내려간 것도 글의 힘이라고 느꼈어요. 무엇을 호출하는지만이 아니라 어떤 실패를 위로 올리고 어디서 사람에게 넘길지를 함께 적었기 때문에, 이후 코드가 바뀌어도 무엇을 지켜야 하는지 추적할 수 있습니다. 표현 하나는 구분해 쓰고 싶어요. “판단 로직 0줄”보다 “도메인 판단 0줄”이 정확해 보입니다. 조립층이 계통이나 근거의 옳고 그름을 다시 판단하지는 않지만, 재시도·환류·중단을 고르는 제어 판단은 실제로 하고 있기 때문입니다.
실행 전에는 세 군데 배선을 먼저 확인하면 좋겠습니다. 제시된 코드만 보면 `reroute_count`를 읽지만 값을 올리는 부분이 없어 환류 예산이 실제로 소진되지 않을 수 있고, N2가 참고할 `failed_plan`도 상태에 남지 않을 수 있습니다. `OWNER`가 읽는 `owner_signal`을 앞 단계에서 채우는 경로도 보이지 않아 중단 이유가 “미상”으로 남을 가능성이 있어요. 또 `GATE`를 조건부 목적지로 적었지만 노드로 등록한 코드가 없고, 주석의 `OWNER → GATE` 연결도 실제 엣지에는 보이지 않습니다. 글에서 그래프 실행을 `not_checked`로 표시해 두셨으니, 이미 실패했다고 단정할 부분은 아니고 첫 실행 전에 확인할 배선 목록에 가깝습니다.
환류를 언제 멈출지에 대해서는 같은 배정이 다시 나오면 즉시 `OWNER`로 넘기고, 전체 환류 횟수에도 별도의 안전 상한을 두는 조합이 가장 이해하기 쉬워 보여요. 직전 결과만 비교하면 A→B→A처럼 한 바퀴 돌아오는 경우를 놓칠 수 있으니, 이번 실행에서 이미 거친 배정인지 확인하는 편이 좋습니다. 실제로 다른 배정이 나왔을 때만 재검색을 허용하고, 아직 실행 로그가 없을 때는 현재 설정인 1회를 유지해도 충분해 보여요. 이후 1회 환류로 회복된 비율과 두 번째 새 배정이 실제로 나온 비율을 보고 숫자를 바꾸면 상한에도 근거가 생깁니다.
하위 Skill의 버전이나 반환 형식이 바뀌는 경우에는 S3의 정답을 상위에서 다시 채점하기보다, 가짜 S3 응답을 넣고 조립층이 어느 경로로 이동하는지만 고정해도 좋은 회귀검사가 됩니다. 정상 근거는 GATE로, 첫 0건은 N3 재검색으로, 상한 뒤 0건은 N2로 한 번 되돌리고, `evidence` 키 누락·자료형 변경·VERSION 누락은 일반 검색 실패와 구분해 `OWNER`로 보내는 식입니다. 현재의 `out.get("evidence", [])`는 반환 형식이 깨진 경우도 검색 0건처럼 숨길 수 있으니, 필수 키와 자료형을 먼저 검사하면 계약 변화가 조용히 삼켜지는 일을 막을 수 있어요. 이 흐름에 `OWNER → GATE → PROOF` 실제 연결과 첫 실행 로그까지 붙으면, 4편의 실패 환류가 5편의 차단 증적으로 자연스럽게 이어질 것 같습니다.
코드 마지막 줄까지 읽고 달아주신 댓글입니다. 지적해 주신 것들이 대부분 제가 첫 실행을 돌리고 나서야 발견했을 것들이라, 순서를 통째로 앞당겨 주셨습니다.
**1. "도메인 판단 0줄" — 표현을 고치겠습니다.**
정확한 교정입니다. 제가 쓴 "판단 로직 0줄"은 틀린 말이었습니다. 조립층은 재시도·환류·중단을 고르는 제어 판단을 실제로 하고 있고, 그게 4편의 주장 자체이기도 합니다. "아무 판단도 안 한다"고 써 놓고 환류를 넣었으니 문장이 스스로 모순이었습니다. 상세본 표기를 바꾸고, 조립층 순수성 테스트도 "if가 있으면 실패"가 아니라 **"상태 이외의 값을 읽는 if가 있으면 실패"**로 조건을 다시 쓰겠습니다.
**2. 배선 4건 — 전부 확인 목록에 올렸습니다.**
reroute_count지적이 가장 아프게 들어왔습니다. 읽기만 하고 올리는 곳이 없으면 환류 예산은 소진되지 않습니다. 그러면 제가 글에서 "환류 상한을 1회로 둘지 수렴 조건으로 둘지"를 여젖던 것도, **애초에 작동하지 않는 값을 두고 한 논의**였던 셀입니다.failed_plan과owner_signal도 성격이 같습니다. 읽는 쪽만 있고 쓰는 쪽이 없습니다. 특히owner_signal이 비면 OWNER는 "무엇이 왜 막혔는지 모르는 채 멈추는 노드"가 되는데, 그런 v1.0의 HALT와 다를 게 없습니다. 제가 고쳤다고 생각한 결함이 실은 이름만 바뀜 상태였습니다. GATE는 목적지로만 적어 놓고 노드 등록이 없으니, 컴파일 단계에서 걸릴 것으로 봅니다.**3. A→B→A — 이건 제가 못 본 것입니다.**
저는 "직전 배정과 같으면 중단"만 생각했습니다. 말씀대로라면 한 바퀴 돌아오는 경우를 놓칩니다. 이번 실행에서 이미 거친 배정을 집합으로 들고 다니면서 확인하는 쪽으로 바꾸겠습니다. 그리고 **"실제로 다른 배정이 나왔을 때만 재검색을 허용한다"**는 조건이 특히 좋습니다. 지금 설계대로라면 N2가 같은 답을 내놓아도 N3가 한 번 더 도는데, 그건 예산만 쓰고 아무것도 바꾸지 못하는 회전입니다. 숫자는 1회로 두겠습니다. 로그가 없는 상태에서 2회로 올리면 그것도 근거 없는 임의값이라, 회복 비율이 나온 뒤에 바꾸는 게 맞습니다.
**4.
out.get("evidence", [])— 이게 가장 뾈아프습니다.**같은 글에서 안티패턴 ④를 "하위 실패를 삼키는 병"이라고 써 놓고, 제 코드가 정확히 그 짓을 하고 있었습니다. 기본값
[]가 **계약 위반을 검색 0건으로 둔갑**시킵니다. 그러면 재검색이 돌고 환류가 돌고 상한까지 소진한 뒤에 "근거를 못 찾았다"고 보고합니다. 실제 원인은 반환 형식이 깨진 것인데도요. 진단이 틀린 채 복구 절차만 성실하게 도는 게 가장 나쁜 형태입니다. 필수 키와 자료형을 먼저 검사하고, 위반은 검색 실패와 다른 경로로 OWNER에 보내겠습니다.**5. 가짜 S3 응답으로 경로만 고정 — 이 방식을 쓰겠습니다.**
상위에서 S3의 정답을 다시 채점하는 건 사실 제가 스스로 금지한 안티패턴 ②(후보정)입니다. 그걸 테스트에서 할 뻔했습니다. 말씀하신 네 갈래 — 정상 근거는 GATE, 첫 0건은 재검색, 상한 뒤 0건은 N2 한 번, 계약 위반은 OWNER — 는 그대로 회귀검사 케이스가 됩니다. 하위 버전이 바뀌어도 조립층이 지켜야 할 것은 정확도가 아니라 경로라는 게 분명해집니다.
정리하면 다음 실행 전에 배선 4건을 고치고, 환류 종료 조건을 방문 집합으로 바꾸고, 계약 검사를 검색 실패와 분리한 뒤, 네 갈래 경로 테스트를 붙이겠습니다. 첫 실행 로그가 나오면 그 결과로
not_checked를 갱신하겠습니다. 5편 증적으로 이어지는 그림까지 그려 주셔서 감사합니다.