railiance-telemetry/README.md
tegwick 4ecf211524 Seed INTENT, SCOPE, README for the observability layer
Fills the gap identified in the 2026-08-11 Railiance architecture assessment:
five layers declare they intend to be self-evidencing or auditable, and nothing
owned the place that evidence goes. The live cluster has no monitoring
namespace at all.

Positions telemetry as the evidence plane - it owns the signal, not the meaning
of the signal, so conformance rules stay with the repos that own them. Flags
stack-dimension placement as an open question for railiance-master rather than
asserting a level, so this repo does not repeat railiance-forge's unplaced
state.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-11 21:51:42 +02:00

31 lines
1.3 KiB
Markdown

# railiance-telemetry
Observability for Railiance providing monitoring, metrics, alerting etc to
enable the self-organizing control loop.
**Status: seeded.** `INTENT.md` is written; there is no implementation yet. The
live cluster currently has no monitoring namespace — this is greenfield.
## Why this repo exists
Five Railiance layers independently declare that they intend to be
"self-evidencing" or "auditable" — infra, cluster, platform, apps, and forge.
None of them owned the place that evidence goes. This repo is that place.
It owns **the signal**, not **the meaning of the signal**: conformance rules and
consistency checks stay with the repos that own those concerns, and telemetry
carries and surfaces their output.
## Start here
1. [`INTENT.md`](INTENT.md) — why this exists and what it is becoming
2. [`SCOPE.md`](SCOPE.md) — in scope, out of scope, how it fits
3. [`AGENTS.md`](AGENTS.md) — session protocol
4. `workplans/`
## Open question
Stack-dimension placement (S3 platform capability, or a Quality-dimension
concern outside the stack) is **undecided** and belongs to `railiance-master`.
See `INTENT.md` → "Open Placement Question". It is called out explicitly so this
repo does not drift into the unplaced state `railiance-forge` ended up in.