# railiance-master

Architecture home for the Railiance framework.

This repository defines how Railiance concepts map to repositories, how the
different repo families compose, and where new architecture decisions should be
recorded before they are spread across implementation repos.

## Current Architecture Baseline

- [docs/repository-axes.md](docs/repository-axes.md)
- [docs/reef-substrate-model.md](docs/reef-substrate-model.md)
- [docs/rail-kubernetes-boundary.md](docs/rail-kubernetes-boundary.md)
- [docs/rapp-first-wave-candidates.md](docs/rapp-first-wave-candidates.md)
- [docs/reef-first-wave-rollout.md](docs/reef-first-wave-rollout.md)
- [docs/fabric-state-hub-adaptation.md](docs/fabric-state-hub-adaptation.md)
- [docs/repo-family-bootstrap-contract.md](docs/repo-family-bootstrap-contract.md)
- [docs/adr/ADR-0001-repository-prefix-architecture.md](docs/adr/ADR-0001-repository-prefix-architecture.md)
- [docs/adr/ADR-0002-rail-kubernetes-wave-1-boundary.md](docs/adr/ADR-0002-rail-kubernetes-wave-1-boundary.md)
- [docs/adr/ADR-0003-rapp-first-wave-selection.md](docs/adr/ADR-0003-rapp-first-wave-selection.md)
- [docs/adr/ADR-0004-first-wave-reef-rollout.md](docs/adr/ADR-0004-first-wave-reef-rollout.md)

## Current Explorations

- [history/260724-InitialExplorationOfOperationModels.md](history/260724-InitialExplorationOfOperationModels.md)
- [history/260724-InitialExplorationOfWrapperConcepts.md](history/260724-InitialExplorationOfWrapperConcepts.md)

## Purpose

`railiance-master` is the canonical place to define:

- repo-family vocabulary such as `railiance-*`, `rail-*`, `rapp-*`, and `reef-*`
- cross-repo architectural boundaries
- the relationship between ownership, execution mode, workload packaging, and
  substrate realities
- the migration direction when current repos must be split or renamed

Implementation repos should follow the architecture recorded here rather than
each inventing local meanings for the same terms.