# All Supply-Y Documentation

Use this directory when you already know the task you need to complete. New evaluators should begin with Getting Started and one real Package example.

## Start

- [Overview](https://supply-y.net/docs): Understand, integrate and verify the Supply-Y Agent-to-Agent protocol for secure cross-company supply-chain collaboration.
- [Use Cases](https://supply-y.net/docs/use-cases): Compare six fixture-backed Supply-Y collaboration loops for material risk, weekly planning, incident mitigation, quality, engineering change and compliance evidence.
- [Package Example](https://supply-y.net/docs/package-example): Inspect a complete fixture-backed Supply-Y reasoning Package, including shared fields, hidden data, policy boundaries and response requirements.
- [Protocol 1.0 Release](https://supply-y.net/docs/release): Pin the stable Supply-Y Protocol 1.0 release Manifest, immutable contract URLs, exact artifact digests and implementation availability.
- [Changelog](https://supply-y.net/docs/changelog): Review every Supply-Y Protocol wire release, exact Manifest binding, compatibility decision, retired preview identifier and required migration.
- [Availability & Readiness](https://supply-y.net/docs/readiness): See which Supply-Y Protocol 1.0 surfaces are stable, available for evaluation, managed-pilot only or not yet generally available.
- [Getting Started](https://supply-y.net/docs/getting-started): Choose an Agent and transport path, create a controlled Package, exchange it securely and prove the first Supply-Y collaboration loop.
- [Plan a Pilot](https://supply-y.net/docs/pilot): Scope a Supply-Y pilot with explicit entry criteria, customer responsibilities, data boundaries, stage gates, acceptance evidence and exit rules.
- [Common Questions](https://supply-y.net/docs/faq): Direct answers about Supply-Y data ownership, customer deployment, policy, ciphertext audit, Catena-X, failure handling and production readiness.
- [Install In Your Agent](https://supply-y.net/docs/agent-install): Copy one message into a company Agent to discover, install and verify Supply-Y, then review its compatibility report before enabling exchange.

## Understand

- [Protocol Concepts](https://supply-y.net/docs/concepts): Understand controlled reasoning, Packages, policies, collaboration loops, participant value and Native versus Catena-X transport.
- [Glossary](https://supply-y.net/docs/glossary): Find precise Supply-Y definitions, aliases and distinctions for Protocol 1.0, Packages, Skills, policy, receipts, transport, audit and certification.
- [Architecture](https://supply-y.net/docs/architecture): The Supply-Y logical architecture for customer Agents, Native encrypted transport, Catena-X EDC, identity, APIs, storage, events and audit.
- [Catena-X Integration](https://supply-y.net/docs/catena-x): Implement Supply-Y Catena-X Mode with one EDC asset, a signed control manifest, no duplicate payload and explicit interoperability limits.
- [Security & Trust](https://supply-y.net/docs/security): Supply-Y data ownership, encryption, key trust, policy receipts, malicious-input controls, audit integrity and explicit security limits.
- [Trust Center](https://supply-y.net/docs/trust-center): Review Supply-Y Protocol 1.0 data custody, security controls, executable evidence, customer responsibilities and open production assurance gates.
- [Governance & Support](https://supply-y.net/docs/governance): See who owns each Supply-Y decision, how protocol changes become immutable releases, and where to report integration, security or pilot issues.

## Build

- [Signed Skills](https://supply-y.net/docs/skills): Inspect installable Supply-Y Agent Skills, signed release manifests, deterministic update decisions, approval boundaries and production trust requirements.
- [Crypto Profile](https://supply-y.net/docs/crypto): The normative Native Mode encryption, signature, key-ownership and verification profile, with executable sender-recipient test vectors.
- [API Contract](https://supply-y.net/docs/api): The Supply-Y Agent-facing API for identity, Skills, keys, Package lifecycle, threads, notifications, audit and Catena-X transfers.
- [TypeScript SDK](https://supply-y.net/docs/sdk): Use the Supply-Y TypeScript SDK to validate objects and thread context, evaluate Skill updates, keep keys behind KMS adapters and call all 21 Agent API operations.
- [Protocol Playground](https://supply-y.net/docs/playground): Edit and validate Supply-Y protocol objects locally in the browser using the published schemas, fixtures and domain conformance profile.
- [Hosted Sandbox](https://supply-y.net/docs/sandbox): Create a short-lived test session and run signed Policy Receipts, encrypted Packages, recipient receipts, notifications and audit evidence against the Protocol 1.0 API.

## Operate

- [Events & Webhooks](https://supply-y.net/docs/events): Implement signed Supply-Y webhooks, durable Agent inboxes, retry, deduplication, ordered polling, gap recovery and notification acknowledgement.
- [Conformance](https://supply-y.net/docs/conformance): Executable Supply-Y object, thread-context, cryptographic, Safe Agent and transport checks, plus production certification requirements.
- [Versioning](https://supply-y.net/docs/versioning): Supply-Y Protocol, schema, Skill and API version rules, maturity evidence, deprecation policy and conformance levels.

## Reference

- [Schemas & Examples](https://supply-y.net/docs/reference): Inspect Supply-Y JSON Schemas, valid examples, red-team fixtures, machine-readable conformance cases and validation evidence.

---

Canonical HTML: [All Supply-Y Documentation](https://supply-y.net/docs/all)
Agent documentation index: [llms.txt](https://supply-y.net/llms.txt)
