From 668dfd9b549f1b9d9fe5ec8399362dc33da00064 Mon Sep 17 00:00:00 2001
From: tegwick <bernd.worsch@gmail.com>
Date: Tue, 10 Mar 2026 00:36:06 +0100
Subject: [PATCH] chore(init): scaffold railiance-apps (S5 Workloads &
 Experience Endpoints)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Initial repo structure per ADR-003: CLAUDE.md, Makefile, workplans/.
No implementation yet — repo claims its OAS stack layer.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 CLAUDE.md          | 65 ++++++++++++++++++++++++++++++++++++++++++++++
 Makefile           |  5 ++++
 workplans/.gitkeep |  0
 3 files changed, 70 insertions(+)
 create mode 100644 CLAUDE.md
 create mode 100644 Makefile
 create mode 100644 workplans/.gitkeep

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..1ec3ec2
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,65 @@
+# railiance-apps — Claude Code Instructions
+
+**OAS Stack Level:** S5 Workloads & Experience Endpoints
+**Scope:** Application Helm releases and Kubernetes manifests for
+user-facing services — Gitea, coulomb services, APIs, web frontends.
+
+**Pre-condition:** The full stack below must be operational:
+`railiance-infra` → `railiance-cluster` → `railiance-platform` → `railiance-enablement`
+
+## Custodian State Hub Integration
+
+Domain: **railiance** — topic ID: `ca369340-a64e-442e-98f1-a4fa7dc74a38`
+State Hub: http://127.0.0.1:8000
+
+### Session Protocol
+
+**Step 1 — Orient**
+```
+get_domain_summary("railiance")
+```
+
+**Step 2 — Scan workplans**
+```
+ls workplans/   # read all active workplans; note todo/in_progress tasks
+```
+
+**Step 3 — Present brief**
+1. Active workstreams for railiance with `[repo:railiance-apps]` tasks
+2. Pending tasks from local workplans
+3. Goal guidance from summary (needs_workplan / alignment_warnings)
+4. Suggested next action
+
+**During work:** use `record_decision()`, `add_progress_event()`, `resolve_decision()`.
+
+**Session close:** `add_progress_event()` with topic_id and workstream_id.
+
+> Design boundary: hub is read model. Bootstrap tools are First Session
+> Protocol only. Work originates as files per ADR-001.
+
+### Repo Boundary Rule (ADR-003)
+
+This repo owns **S5 Workloads & Experience Endpoints only**. Do not manage:
+- OS-level concerns → `railiance-infra` (S1)
+- Kubernetes runtime → `railiance-cluster` (S2)
+- Platform services → `railiance-platform` (S3)
+- Developer tooling → `railiance-enablement` (S4)
+
+Reference: `railiance-infra/docs/adr/ADR-003-railiance-5repo-stack-architecture.md`
+
+### Workplan Convention (ADR-001)
+
+File location: `workplans/RAIL-AP-WP-NNNN-<slug>.md`
+Prefix: `RAIL-AP`
+
+### SBOM
+
+After updating dependencies:
+```bash
+cd ~/the-custodian/state-hub
+make ingest-sbom REPO=railiance-apps SCAN=1 REPO_PATH=/home/worsch/railiance-apps
+```
+
+### Quick Reference
+
+`~/the-custodian/state-hub/mcp_server/TOOLS.md`
diff --git a/Makefile b/Makefile
new file mode 100644
index 0000000..6e6089c
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,5 @@
+SHELL := /usr/bin/env bash
+.DEFAULT_GOAL := help
+
+help: ## Show this help
+	@grep -E '^[a-zA-Z0-9_-]+:.*?## ' $(MAKEFILE_LIST) | sort | sed 's/:.*##/: /'
diff --git a/workplans/.gitkeep b/workplans/.gitkeep
new file mode 100644
index 0000000..e69de29