Bootstrap the first rail-kubernetes repo

README.md

@@ -0,0 +1,45 @@
+# rail-kubernetes
+
+Wave-1 execution rail for Railiance-managed workloads on Kubernetes.
+
+## Purpose
+
+`rail-kubernetes` is the default base rail for the current Railiance
+ecosystem. It owns the generic workload-on-Kubernetes execution contract that
+should no longer stay mixed into `railiance-cluster`.
+
+This repo exists to hold:
+
+- the Kubernetes rail declaration
+- the generic workload lifecycle contract
+- the migration path from the current `railiance-cluster` compatibility surface
+- future rail-local tooling and docs for Railiance-managed workloads on Kubernetes
+
+## Boundary
+
+`rail-kubernetes` does not own:
+
+- k3s bootstrap
+- cluster-level operator ownership
+- cluster backup/restore posture
+- workload-specific wrappers that belong in `rapp-*` repos
+- substrate inventories that belong in `reef-*` repos
+
+Those concerns stay with `railiance-cluster`, the relevant `rapp-*` repo, or
+the relevant `reef-*` repo.
+
+## Current Status
+
+This repo is in first-wave bootstrap.
+
+The boundary and source material come from:
+
+- `railiance-master/docs/rail-kubernetes-boundary.md`
+- `railiance-cluster/docs/rail-kubernetes-extraction-map.md`
+- `railiance-cluster/docs/rail-kubernetes-substrate-profile.md`
+
+## Initial Layout
+
+- `declarations/rail.yaml` — source-controlled rail contract
+- `docs/` — wave-1 contract and import plan
+- `workplans/` — repo-local execution work