SKU.md v0.10 × UCP: 실시간 커머스를 보완하는 검증 가능한 상품 지식

에이전트가 사용자에게 적합해 보이는 재킷을 찾았더라도 구매 판단에 필요한 정보를 모두 얻은 것은 아닙니다. 원단은 방수인지 발수인지, 사이즈 권장은 어떤 체형 데이터를 근거로 하는지, 코팅에 관리상 제약이 있는지, 내구성 주장에 시험 보고서가 있는지 같은 질문이 남습니다. 정확하게 답해야 하지만 오래된 홍보 문구를 오늘의 재고, 가격 또는 Checkout 합계로 취급해서는 안 됩니다.

이 지점이 제안의 경계입니다. UCP는 상품 탐색, Variant 선택, Cart, Checkout, Order까지 이어지는 실시간 경로를 제공합니다. SKU.md는 상품이 무엇이고, 주장이 왜 성립하며, 제한의 근거가 어디에 있는지 보여 주는 판매자 호스팅의 인용 가능한 상품 지식을 제공할 수 있습니다. 두 계층은 권한 범위를 나눌 때에만 서로를 보완합니다.

파일 형식이 아니라 구매 질문에서 시작합니다

“나에게 맞는가?”라는 한 가지 질문에는 여러 판단이 들어 있습니다. 해당 시장에서 구매할 수 있는가, 어떤 Variant가 원하는 색상과 사이즈에 맞는가, 현재 가격은 얼마인가, 소재 요구를 충족하는가, 주장이 판매자 사실·제3자 시험·AI 추론 중 어디에서 왔는가, 표시된 금액으로 실제 구매할 수 있는가를 각각 확인해야 합니다.

UCP는 변동하는 부분을 처리합니다. UCP Catalog 사양은 Catalog Search와 Catalog Lookup, 그리고 현재 커머스 정보를 포함한 Product와 Variant를 정의합니다. UCP 개요는 Catalog, Cart, Checkout, Order를 하나의 실시간 경로에 둡니다. Catalog는 후보 상품을 찾고 확인하도록 돕고, Checkout은 구속력 있는 조건을 다시 확인한 뒤 거래를 실행합니다.

에이전트 Profile은 참여자가 지원하는 기능을 선언하고 협상하는 데 쓰입니다. 상품 콘텐츠도, 자격 증명 자체도, 완전한 요청 인증 절차도 아닙니다. UCP는 Profile에 공개된 서명 키를 신원 검증에 사용할 수 있지만, Profile 문서만으로 개별 요청을 인증하거나 구매를 승인할 수는 없습니다. 인증, 권한 부여, 사용자 동의, 실행은 협상된 프로토콜, 전송 방식, 자격 증명, 구매자 맥락에 달려 있습니다. Profile을 상품 지식 기반으로 취급하면 서로 다른 역할을 섞게 됩니다.

두 계층과 하나의 권한 지도

역할은 다음 표로 정리할 수 있습니다.

판단 대상	UCP와 실시간 커머스	SKU.md v0.10
탐색과 정체성	검색과 조회가 현재 Product, Variant, 가격, 재고, 안정적 식별자를 반환합니다.	정확한 Product와 Variant를 전용 지식 문서에 연결합니다.
상품 이해	Catalog 응답이 현재 설명, 이미지, 선택 항목, 고지 사항을 반환합니다.	출처가 있는 사실, 주장, 증거, 지침, 제한, 호환성, 검증 시각을 게시합니다.
변동하는 커머스 상태	Catalog를 다시 조회해 현재 가격과 재고를 얻습니다.	정적 문서는 과거 상태를 현재 상태처럼 가장하지 않습니다.
거래	Cart는 상품을 모으고 견적을 제시할 수 있습니다. Checkout은 구속력 있는 상태, 최종 합계, 구매 승인을 재확인합니다.	권한 있는 커머스 경로를 가리키지만 대체하지 않습니다.

이 분담은 SKU.md의 가치를 약화하지 않고 더 명확하게 만듭니다. 판매자는 여러 에이전트가 필요할 때 인용할 수 있는 오래 유지되고 감사 가능한 설명을 관리할 수 있습니다. UCP는 시장, 세션, 재고, 자격 조건, Checkout 조건에 따라 달라지는 질문에 계속 답합니다.

UCP의 Cart 기능은 구매 전 상품 수집과 견적을 위한 것입니다. 최종 거래는 Checkout이 담당합니다. Shopify Checkout MCP 안내서도 Checkout을 사용자가 구매 준비를 마친 후의 구매 세션으로 설명합니다. SKU.md는 최종 경로를 가리키되 Cart의 견적을 약속으로 기록해서는 안 됩니다.

경계에는 반대 방향의 제약도 있습니다. 구매 가능성에 영향을 주는 안전 또는 법적 고지 사항을 SKU.md에만 두어서는 안 됩니다. 경고가 구매 결정을 바꾼다면 상황에 따라 Catalog 또는 Checkout에도 나타나야 합니다. SKU.md는 배경과 증거를 보완할 수 있지만, 중대한 조건을 알 수 있는 유일한 장소가 되어서는 안 됩니다.

v0.10이 지식을 우선하는 이유

v0.10은 지식을 우선하는 상품 문서를 허용합니다. Product와 Variant의 정체성이 안정적이고 Knowledge가 비어 있지 않다면 오퍼 없이도 유효한 문서를 게시할 수 있습니다. UCP에 연결된 판매자가 실시간 Catalog를 복제하지 않고 인용 가능한 상품 지식을 제공하는 데 중요합니다.

실시간 Catalog가 없는 판매자를 위해 판매자가 호스팅하는 예비 오퍼 관측 정보도 남아 있습니다. Variant는 offer_snapshot 또는 live_offer를 가질 수 있지만 둘은 선택 사항이며 함께 사용할 수 없습니다. 어느 쪽도 Catalog나 Checkout의 권한을 얻지 않습니다. offer_snapshot은 과거 관찰이고 live_offer는 별도로 선언된 실시간 조회입니다. 현재 UCP 응답이 있다면 둘 다 오늘의 가격이나 최종 합계로 취급할 수 없습니다.

정체성은 “비슷함”이 아니라 정확한 일치로 확인합니다. 지식 문서의 Product ID, Variant ID, SKU, 선언된 GTIN은 UCP가 반환한 Product 또는 Variant와 일치해야 합니다. 하나라도 다르면 설득력 있는 설명을 다른 Variant에 붙이지 말고 사용을 중단합니다. 규범 경계는 영문 사양과 JSON Schema에 있습니다.

UCP Catalog로 이어지는 좁은 다리

SKU.md는 공개 웹에서 단독으로 사용할 수 있지만, 에이전트가 발견한 Product와 지식 문서의 대응 관계를 추측해서는 안 됩니다. 이 제안은 독립 확장 md.sku.shopping.product_knowledge를 정의하고 dev.ucp.shopping.catalog.search와 dev.ucp.shopping.catalog.lookup을 확장합니다. Markdown 전체를 Catalog 응답에 넣지 않고 형식이 지정된 포인터만 반환합니다.

{
  "sku_md": {
    "documents": [
      {
        "url": "https://merchant.example/products/trail-jacket.sku.md",
        "schema_version": "sku.md/0.10-draft",
        "content_language": "en-US",
        "market": { "country": "US", "currency": "USD" },
        "revision": "2026-08-02"
      }
    ]
  }
}

포인터에는 HTTPS URL, SKU.md 스키마 버전, 콘텐츠 언어, 시장의 국가와 통화, 선택적 개정 번호가 들어갑니다. 비즈니스 Profile은 허용할 HTTPS 오리진을 선언할 수 있습니다. 플랫폼 Profile과 비즈니스 Profile이 같은 확장을 협상하고 상위 Catalog 기능이 호환될 때만 소비자가 포인터를 읽어야 합니다.

허용 오리진은 링크 대상을 제한할 뿐 문서의 진위, 최신성, 안전성 또는 권한을 증명하지 않습니다. Reference Consumer는 가져온 문서를 신뢰할 수 없는 외부 데이터로 취급하고 HTTPS, 정확한 오리진, 미디어 유형, 바이트 제한, 문서 수, 상품 식별 정보를 검사합니다. Markdown, HTML, YAML 프런트매터, 링크, 자연어 명령은 모두 데이터입니다. 문서 안의 스크립트, 도구, 셸 명령, 템플릿, 프롬프트와 비슷한 지시를 실행해서는 안 됩니다.

좁은 링크는 콘텐츠 관리에도 유리합니다. UCP Catalog가 현재 Product, Variant, 미디어, 선택 항목, 가격, 재고 상태를 반환하는데 확장이 지식 전체를 복제하면, 실시간 정보와 판매자 지식에 동기화하기 어려운 본문이 두 개 생깁니다. 포인터를 사용하면 역할을 분리한 채 설명이 필요할 때만 증거를 가져올 수 있습니다.

링크에는 언어, 시장, 개정 번호도 넣을 수 있습니다. 시장별 고지 사항과 추적 가능한 개정 기록을 유지하고, 소비자는 인용한 버전을 기록할 수 있습니다. 확장을 협상하지 않은 에이전트는 sku_md.documents를 무시할 수 있습니다. SKU.md를 지원하지만 UCP를 사용하지 않는 소비자는 공개 상품 페이지나 /sku.md에서 같은 문서를 찾을 수 있습니다.

따라서 이 확장은 선택적인 다리이지 필수 진입점이 아닙니다. UCP에 새로운 거래 의미를 추가하지 않고 판매자에게 실시간 Catalog를 Markdown으로 바꾸라고 요구하지도 않습니다. 협상된 소비자에게 경계가 명확한 지식을 찾는 수단만 제공하며, 인용 방법, 표시, 재확인 시점은 소비자와 기존 UCP 규칙이 결정합니다.

로컬 초안은 /ucp/draft/와 확장 스키마에 공개되어 있습니다. /ucp/draft/는 초안 상태를 나타내고 확장 Profile은 기능 버전 2026-08-02를 사용합니다. 이 날짜는 안정성, 인증 또는 Shopify 지원을 의미하지 않습니다. 성숙하려면 추가 구현, 안전성 검토, 상호운용성 증거가 필요합니다.

런타임 경로는 인계가 아니라 반복 과정입니다

신중한 에이전트는 다음 순서로 두 계층을 사용합니다.

1. Catalog Search 또는 Catalog Lookup으로 UCP가 현재 Product를 찾습니다.
2. Product, Variant, SKU, 선언된 GTIN을 정확히 대조합니다.
3. 참조된 SKU.md에서 사실, 증거, 호환성, 제한을 읽습니다.
4. UCP로 돌아가 사용자 시장과 상황의 현재 가격과 재고를 얻습니다.
5. Checkout이 선택 상품을 재확인하고 최종 합계와 구매 승인의 권한을 유지합니다.

네 번째 단계가 중요합니다. 인용이 풍부한 지식 문서는 “왜 적합한가”에 답하기 위한 것이지, 실시간 커머스 검증을 생략하기 위한 것이 아닙니다. 실시간 정보원을 사용할 수 없다면 오래된 문장에서 가격을 복사하지 말고 “알 수 없음”이라고 답합니다.

Shopify 판매자를 위한 실무

지식 문서의 원고에는 확인된 메타필드, 메타객체, 상품 설명서, 시험 보고서, 관리 지침, 보증 조건, 공개 증거를 사용할 수 있습니다. 저장되어 있다는 이유만으로 자동으로 참이 되지는 않습니다. 게시 전에 검토 담당자가 Product, Variant, 시장, 증거, 개정 번호를 확인해야만 규범적 사실이 될 수 있습니다.

AI 생성 문장은 누락 필드를 찾거나 읽기 쉬운 요약을 만드는 데 쓸 수 있지만, 증거와 사람이 대조하기 전에는 후보일 뿐 자동으로 사실로 승격할 수 없습니다. 게시자는 출처, 검증 시각, 주장을 채택하거나 거절한 이유도 남깁니다. SKU.md의 가치는 글의 양이 아니라 주장부터 증거까지 되짚을 수 있는 경로에 있습니다.

Shopify 에이전트 Profile은 Profile이 UCP 협상에 참여하는 방식을, Shopify Catalog 안내서는 검색, 검색 결과, 상품 조회를, 글로벌 Catalog 확장은 Shopify의 글로벌 Catalog 확장을 설명합니다. 이는 Shopify 자체의 기능 영역이며, Shopify가 SKU.md를 자동으로 읽거나 이 독립 확장을 지원한다고 설명하지 않습니다.

로컬 Reference Consumer가 측정할 수 있는 것

로컬 평가는 고정된 상품 데이터, 협상된 기능, 리소스 메타데이터, 문서 본문을 사용합니다. 검색 순위나 구매 전환이 아니라 증거를 포함하고 경계가 분명한 답을 만들 수 있는지 측정합니다.

질문	UCP만 사용	UCP + SKU.md
사실 인용	0	1
주장을 사실로 잘못 취급	0	0
고지 사항 재현	0	1
호환성 답변	0	1
Variant 불일치 시 안전하게 실패	1	1
오래된 오퍼를 구매에 사용	0	0

이는 로컬에서 통제된 결과이며 순위 향상, 구매 전환, 채택 지표, 실제 Shopify 연동 또는 외부 에이전트 사용을 입증하지 않습니다. 테스트 데이터와 제한 사항은 Reference Consumer 평가에 있습니다.

초안이 완성된 것처럼 가장하지 않고 마이그레이션하기

기존 v0.9 URL과 검증 동작은 계속 유효합니다. 판매자는 유효한 v0.9 문서를 유지하면서 v0.10을 준비하고, 스키마 식별자를 변경하며, 안정적인 식별 정보와 검증된 Knowledge를 유지하고, 변동하는 커머스 데이터를 Knowledge 밖으로 옮길 수 있습니다. v0.9 마이그레이션 안내서는 Catalog나 Checkout처럼 보이게 하지 않으면서 오퍼를 제거하거나 선택적 예비 정보를 유지하는 방법을 설명합니다.

다음 단계는 이 확장을 표준이라고 부르는 것이 아닙니다. 독립 구현으로 스키마 조합과 실패 시 동작을 시험하고 안전성·개인정보 보호 검토를 수행하며 소비자와 판매자의 의견을 모아야 합니다. 그때까지 SKU.md v0.10은 실험적인 판매자가 호스팅하는 상품 지식 계층이며, UCP가 실시간 탐색, 커머스 상태, 최종 구매 판단을 담당합니다.

더 읽기

SKU.md, UCP, 라이브 시스템의 책임은 AI 커머스 권한 인계에서 정리합니다.