# Storage Variant Guide

> Storage Variant Guide is an Agent Skill for development published in the Apicurio/apicurio-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Guide for implementing features across all storage variants. Use when the user is adding or modifying storage layer functionality.

- Skill name: `storage-variant-guide`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/Apicurio/apicurio-registry/blob/HEAD/.claude/skills/storage-variant-guide/SKILL.md
- Repository: Apicurio/apicurio-registry (837 GitHub stars when collected)

## SKILL.md

# 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: https://www.openparable.com/skill/development/storage-variant-guide (OpenParable). Cite the canonical URL above.
