chore(init): scaffold railiance-enablement (S4 Developer Enablement)
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>
This commit is contained in:
commit
6cde99852e
3 changed files with 70 additions and 0 deletions
65
CLAUDE.md
Normal file
65
CLAUDE.md
Normal file
|
|
@ -0,0 +1,65 @@
|
||||||
|
# railiance-enablement — Claude Code Instructions
|
||||||
|
|
||||||
|
**OAS Stack Level:** S4 Developer Enablement
|
||||||
|
**Scope:** Tools that allow system evolution — CI/CD pipelines, developer
|
||||||
|
portal, platform templates, SDKs, buildpacks.
|
||||||
|
|
||||||
|
**Pre-condition:** `railiance-platform` must be operational before
|
||||||
|
enablement tooling can depend on platform services.
|
||||||
|
|
||||||
|
## 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-enablement]` 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 **S4 Developer Enablement only**. Do not manage:
|
||||||
|
- OS-level concerns → `railiance-infra` (S1)
|
||||||
|
- Kubernetes runtime → `railiance-cluster` (S2)
|
||||||
|
- Platform services → `railiance-platform` (S3)
|
||||||
|
- Application deployments → `railiance-apps` (S5)
|
||||||
|
|
||||||
|
Reference: `railiance-infra/docs/adr/ADR-003-railiance-5repo-stack-architecture.md`
|
||||||
|
|
||||||
|
### Workplan Convention (ADR-001)
|
||||||
|
|
||||||
|
File location: `workplans/RAIL-EN-WP-NNNN-<slug>.md`
|
||||||
|
Prefix: `RAIL-EN`
|
||||||
|
|
||||||
|
### SBOM
|
||||||
|
|
||||||
|
After updating dependencies:
|
||||||
|
```bash
|
||||||
|
cd ~/the-custodian/state-hub
|
||||||
|
make ingest-sbom REPO=railiance-enablement SCAN=1 REPO_PATH=/home/worsch/railiance-enablement
|
||||||
|
```
|
||||||
|
|
||||||
|
### Quick Reference
|
||||||
|
|
||||||
|
`~/the-custodian/state-hub/mcp_server/TOOLS.md`
|
||||||
5
Makefile
Normal file
5
Makefile
Normal file
|
|
@ -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/:.*##/: /'
|
||||||
0
workplans/.gitkeep
Normal file
0
workplans/.gitkeep
Normal file
Loading…
Add table
Add a link
Reference in a new issue