# Kubernetes — Nimmerworld

K8s configurations for nimmerworld services running as pods.

## Namespace pattern

`world-{environment}` per [`../conventions/development-conventions.md`](../conventions/development-conventions.md#kubernetes-namespaces).

| Function | Dev | Staging | Prod | Training |
|----------|-----|---------|------|----------|
| world | `world-dev` | `world-staging` | `world-prod` | `world-training` |

## Workloads (per v0.10 architecture)

- **Compositor** — stateless workers; autoscaling on queue-depth (`transient-waiting-flag` backpressure); requests `nvidia.com/gpu` for trait-LoRA inference
- **Director-routines** — ephemeral per-event-chain; spin-up + prune; requests `nvidia.com/gpu` for driver-tier LLM
- **GM / Governor** — long-running singleton or sharded; equilibrium-seeker; catalogue-event dispatcher

## Status

⏳ **Stub** — manifests land in [`../deployments/k8s/`](../deployments/) as services are implemented.

> **Platform K8s patterns:** [`../../nimmerverse.eachpath.local/k8s/`](../../nimmerverse.eachpath.local/k8s/) (Traefik ingress, storage PV/PVC, etc.).

---

**Version:** 0.1 | **Created:** 2026-04-26 | **Updated:** 2026-04-26