# Event Schema Registry × Agent

CURRENT_STATUS: CURRENT
OBSERVATION: SPEC_ONLY
FRESHNESS: CURRENT
PAGE_TYPE: reference
CANONICAL_URL: /tools/ea-254-event-schema-registry-agent
CLAIM_IDS: none
EVIDENCE_IDS: EA-254-CURRENT-APPROVAL, EA-254-CURRENT-BODY-READBACK
UNKNOWN_IDS: EA-254-UNKNOWN-01
OPS_IDS: none

## Summary
Event Schema RegistryはAgentのevent contract gateとして有効ですが、`compatibility PASS`をbusiness semantics、全consumerのruntime成功、publish権限、Agent action安全性の保証として扱いません。

## Current judgment
Event Schema RegistryはAgentのevent contract gateとして有効ですが、`compatibility PASS`をbusiness semantics、全consumerのruntime成功、publish権限、Agent action安全性の保証として扱いません。

## Scope
Event Schema Registry × Agent

## Confirmed

## UNKNOWN
- EA-254-UNKNOWN-01: organization registry、chosen product/version、schema formats、subject strategy、compatibility/transitivity/checkpoint policy、consumer fleet、serializer/client pins、schema reference use、auto-registration、event-bus IAM、replay retention、semantic invariants、deployment ordering、tenant region/SLAは未確認です。

## Evidence
- EA-254-CURRENT-APPROVAL (RESEARCH): 現行本文の監査・revision対応
- EA-254-CURRENT-BODY-READBACK (IMPL): 現行本文の収録照合

## Failure / limits
wrong subject/registry、stale cache、non-transitive mode、checkpoint drift、historical revalidation誤認、serializer/client mismatch、reference/import failure、consumer format非対応、JSON Schema open/closed mismatch、default/null差、consumer lag、registry outage、registry-write/publish権限混同、schema-valid semantic-invalid、enum/unit/timezone drift、exact schemaなしreplay、auto-registration誤昇格、AI field捏造、description prompt injection、compatibility bypass、duplicate side effectを想定します。
## Practice
本項は2026-10-06時点のConfluent current Platform/Cloud documentation、AWS Glue Schema Registry current documentation/API、およびbounded maintainer/downstream issue evidenceに基づきます。live registry、Kafka/MSK/Kinesis、MCP producer、schema migration/replayへのmutationは未実施です。
## PUBLIC_CLAIM
Event Schema RegistryはAgentのevent contract gateとして有効ですが、`compatibility PASS`をbusiness semantics、全consumerのruntime成功、publish権限、Agent action安全性の保証として扱いません。

## CONTRACT_IDENTITY
provenanceにはregistry identity/region、subject/schema name、schema ID、exact version/revision、format、compatibility mode、transitivity/checkpoint、serializer/deserializer/client versionを残します。schema名やIDだけでruntime contractを再現できるとは仮定しません。

## COMPATIBILITY_BOUNDARY
BACKWARD、FORWARD、FULL等は構造互換性のpolicyです。同じ名称でもformatとregistry実装によって具体ruleが異なります。Avro、Protobuf、JSON Schemaを同一のfield-change ruleとして扱いません。current/previousだけを見るmodeとall/transitive historyを見るmodeを区別し、checkpointを持つregistryでは位置も記録します。compatibility setting変更だけでhistorical versions全体が再検証されたとはみなしません。

## PRODUCER_CONSUMER_BOUNDARY
schema registration成功とconsumer処理成功を別gateにします。serializer/deserializer support、schema reference/import、unknown/default/null behavior、enum evolution、consumer version envelope、rollout order、cached schema behaviorを確認します。registryがformatを扱えることを全consumer integrationが同formatを扱える証明にしません。

## SEMANTIC_BOUNDARY
schema-validでもbusiness-invalidなeventは作れます。currency/amount、timezone、approval state、identifier、業務禁止enum等のsemantic invariantをschema validationとは別に適用します。

## AUTHORIZATION_BOUNDARY
registry read/write権限、event bus/topic publish権限、Agent/tool action権限を分離します。schema登録可能をevent送信許可や業務action許可として扱いません。

## AUTO_REGISTRATION
productionではauto-registrationの利便性と誤schema昇格riskを分離します。未知schemaをAgentが生成した場合、明示migration/approvalなしにproduction contractへ自動昇格させません。

## REPLAY_AND_AUDIT
replay/auditではevent bytesに対応するexact schema/versionとserializer/client behaviorを追跡可能にします。現在のlatest schemaで読めることをhistorical eventのoriginal interpretationと同一視しません。

## AI_TOOL_BOUNDARY
MCP等からevent producerを呼ぶ場合、tool adapter自身のschema handlingも検証対象です。registryにschemaが存在することとAI tool adapterが正しく再利用・参照できることは別です。

## FAILURE_ENVELOPE
wrong subject/registry、stale cache、non-transitive mode、checkpoint drift、historical revalidation誤認、serializer/client mismatch、reference/import failure、consumer format非対応、JSON Schema open/closed mismatch、default/null差、consumer lag、registry outage、registry-write/publish権限混同、schema-valid semantic-invalid、enum/unit/timezone drift、exact schemaなしreplay、auto-registration誤昇格、AI field捏造、description prompt injection、compatibility bypass、duplicate side effectを想定します。

## IMPLEMENTATION_STATE
本項は2026-10-06時点のConfluent current Platform/Cloud documentation、AWS Glue Schema Registry current documentation/API、およびbounded maintainer/downstream issue evidenceに基づきます。live registry、Kafka/MSK/Kinesis、MCP producer、schema migration/replayへのmutationは未実施です。

## SAFE_WORDING
Event Schema RegistryはAgentのevent contract gateとして有効ですが、compatibility PASSをbusiness semanticsや全consumerのruntime成功、publish権限、Agent action安全性の保証として扱わないでください。schema versionだけでなくformat、compatibility mode、transitivity/checkpoint、serializer/deserializer/client version、consumer envelopeを固定し、AI生成eventはschema validationに加えてsemantic invariant、authorization、idempotency/side-effect gateを通してからpublishします。

## OPEN_UNKNOWN
organization registry、chosen product/version、schema formats、subject strategy、compatibility/transitivity/checkpoint policy、consumer fleet、serializer/client pins、schema reference use、auto-registration、event-bus IAM、replay retention、semantic invariants、deployment ordering、tenant region/SLAは未確認です。

NEXT: /agent/start.json
STOP: This is a knowledge projection, not an execution order.