Summary#
실험적 기능이나 분산 실행 경로는 로컬에선 암묵적으로 존재하던 상태가 원격 조각이나 재시도 루프를 거치며 쉽게 깨진다. 실행 계획을 넘기는 경계에서 무엇이 직렬화 가능하고 무엇이 로컬에서 해소돼야 하는지 먼저 정하고, 실패 시 안전한 로컬 실행·재시도·명시적 인자 검증을 준비하는 편이 구현보다 중요하다.
Problem#
ClickHouse의 plan-based parallel replicas처럼 분산 실행 계획이 서브쿼리 상태를 암묵적으로 캡처하면, 로컬에서는 보이지 않던 비직렬화 상태·세션 의존성·포인터/미래값 경계 문제가 발생한다. AI 함수나 외부 API 호출 경로에서도 네트워크 일시 오류, 모호한 인자 위치, 숨은 컬렉션 기반 자격증명 가정이 사용성과 복원력을 떨어뜨린다.
Solution#
- 런타임 전용 객체는 분산 경계 전에 materialize하거나, 불가능하면 안전한 로컬 실행으로 폴백한다.
- API의 필수 식별자(model 등)는 옵션 맵이나 숨은 설정에 묻지 말고 명시적 인자로 강제한다.
- 튜닝 값은 구조화된 파라미터 맵으로 모으고, HTTP 오류뿐 아니라 TLS/connect reset 같은 운영성 네트워크 실패도 공통 재시도 경로에서 다룬다.
- nested runner, compatibility bridge, version-specific fallback 같은 보조 실행 경로에도 capability/fallback 상태가 전파되는지 별도 테스트한다.
Failure Modes#
- Future/pointer/session 같은 비직렬화 상태를 분산 경계 밖으로 그대로 밀어낸다.
- 필수 인자를 옵션 맵이나 숨은 컬렉션 설정에 묻어 호출 계약이 불명확해진다.
- 주 실행 경로만 검증하고 폴백·재시도·중첩 실행 경로의 상태 전파를 놓친다.
- HTTP 오류만 재시도하고 TLS/connect reset 같은 실제 운영 장애는 놓친다.
Related#
- personal_vault/knowledge/agent-experience/external/비동기-분산-경계에서는-원본-데이터와-불변-상태를-먼저-확정하라.md
Source Hygiene#
기존 Sources 목록의 대부분은 유지하되, 마지막 https://github.com/vercel/turborepo/pull/135 항목은 잘린 URL로 보이므로 원 PR 번호를 재확인하거나 제거해야 한다.
Sagwan Revalidation 2026-09-13T14:49:45Z#
- verdict:
ok - note: 직렬화 경계·폴백 설계 원칙은 분산 시스템에서 여전히 유효하며, 의심 URL은 Source Hygiene에 이미 자체 플래그됨.