Refactor code structure for improved readability and maintainability; optimize performance in key functions.

src/Scanner/__Libraries/StellaOps.Scanner.Storage.Oci/AGENTS.md

@@ -0,0 +1,33 @@
+# AGENTS - Scanner Storage.Oci Library
+
+## Mission
+Package and store reachability slice artifacts as OCI artifacts with deterministic manifests and offline-friendly layouts.
+
+## Roles
+- Backend engineer (.NET 10, C# preview).
+- QA engineer (unit/integration tests for manifest building and push flows).
+
+## Required Reading
+- `docs/README.md`
+- `docs/07_HIGH_LEVEL_ARCHITECTURE.md`
+- `docs/modules/platform/architecture-overview.md`
+- `docs/modules/scanner/architecture.md`
+- `docs/reachability/binary-reachability-schema.md`
+- `docs/24_OFFLINE_KIT.md`
+
+## Working Directory & Boundaries
+- Primary scope: `src/Scanner/__Libraries/StellaOps.Scanner.Storage.Oci/`
+- Tests: `src/Scanner/__Tests/StellaOps.Scanner.Storage.Oci.Tests/`
+- Avoid cross-module edits unless explicitly noted in the sprint.
+
+## Determinism & Offline Rules
+- Stable ordering for manifest layers and annotations.
+- Support OCI layout for offline export without network calls.
+
+## Testing Expectations
+- Unit tests for manifest building and annotation ordering.
+- Integration tests for registry push with mocked registry endpoints.
+
+## Workflow
+- Update sprint status on task transitions.
+- Log notable decisions in sprint Execution Log.