# Storage Variant Guide > Guide for implementing features across all storage variants. Use when Use when this capability is needed. - Skill: `tomevault-io/storage-variant-guide` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/storage-variant-guide` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/storage-variant-guide/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/storage-variant-guide --- # Storage Variant Implementation Guide When implementing a feature that touches the storage layer: 1. **Start with SQL** (`app/src/.../storage/impl/sql/`) — this is the canonical implementation 2. **Adapt for KafkaSQL** (`app/src/.../storage/impl/kafkasql/`) — uses a Kafka journal pattern; state changes are serialized as Kafka messages and replayed 3. **Consider GitOps** (`app/src/.../storage/impl/gitops/`) — file-based, git-backed 4. **Consider KubernetesOps** (`app/src/.../storage/impl/kubernetesops/`) — ConfigMap-based 5. **Update RegistryStorage interface** if adding new operations 6. **Update decorators** (`storage/decorator/`) if the feature needs cross-cutting behavior 7. **DTOs must be serializable** — KafkaSQL journals serialize them 8. **Test with at least SQL and KafkaSQL** integration test profiles --- > Source: [Apicurio/apicurio-registry](https://github.com/Apicurio/apicurio-registry) — distributed by [TomeVault](https://tomevault.io).