# Architecture decision records


The decisions in [the design](https://nats-operator.io/docs/design/v1/index.md) that are hard to reverse, one record each.


- [Three controllers, one API group each](https://nats-operator.io/docs/adr/0001-three-controllers/index.md)
- [No controller reads another’s group; shared kinds live in nats-operator.io](https://nats-operator.io/docs/adr/0002-shared-group-and-one-mode/index.md)
- [Trust roots through trust objects that hold a reference or literal values](https://nats-operator.io/docs/adr/0003-trust-objects/index.md)
- [One StatefulSet per NATS server](https://nats-operator.io/docs/adr/0004-statefulset-per-server/index.md)
- [The Kubernetes cluster holds signing keys only; identities may stay offline](https://nats-operator.io/docs/adr/0005-signing-keys-only/index.md)
- [No supercluster resource; gateways are a property of NatsCluster](https://nats-operator.io/docs/adr/0006-no-supercluster-kind/index.md)
- [Cross-namespace references are gated by NatsReferenceGrant alone](https://nats-operator.io/docs/adr/0007-reference-grants/index.md)
