notify doctors work, audit work, new product advisory sprints

docs/examples/binary-diff/README.md

@@ -0,0 +1,55 @@
+# Binary Diff Examples
+
+This directory contains examples demonstrating the binary diff attestation feature.
+
+## Prerequisites
+
+- StellaOps CLI (`stella`) installed
+- Access to a container registry
+- Docker or containerd runtime (for image pulling)
+
+## Examples
+
+### Basic Comparison
+
+[basic-comparison.md](./basic-comparison.md) - Simple binary diff between two image versions
+
+### DSSE Attestation
+
+[dsse-attestation.md](./dsse-attestation.md) - Generating and verifying DSSE-signed attestations
+
+### Policy Integration
+
+[policy-integration.md](./policy-integration.md) - Using binary diff evidence in policy rules
+
+### CI/CD Integration
+
+[ci-cd-integration.md](./ci-cd-integration.md) - GitHub Actions and GitLab CI examples
+
+## Sample Outputs
+
+The `sample-outputs/` directory contains:
+
+- `diff-table.txt` - Sample table-formatted output
+- `diff.json` - Sample JSON output
+- `attestation.dsse.json` - Sample DSSE envelope
+
+## Quick Start
+
+```bash
+# Compare two image versions
+stella scan diff --base myapp:1.0.0 --target myapp:1.0.1
+
+# Generate attestation
+stella scan diff --base myapp:1.0.0 --target myapp:1.0.1 \
+  --mode=elf --emit-dsse=./attestations/
+
+# Verify attestation
+stella verify attestation ./attestations/linux-amd64-binarydiff.dsse.json
+```
+
+## Related Documentation
+
+- [Binary Diff Attestation Architecture](../../modules/scanner/binary-diff-attestation.md)
+- [BinaryDiffV1 JSON Schema](../../schemas/binarydiff-v1.schema.json)
+- [CLI Reference](../../API_CLI_REFERENCE.md#stella-scan-diff)