The Guide · v0.23.0 · patent pending
Operating the Instrument
Holonograph is an instrument. This is how to operate it — how to call the lens, what to feed it, what it gives back, and what to do with the answer.
The Guide is definitive. Reality is frequently inaccurate. — Douglas Adams
Start here
| If you are a… | Enter at | Then |
|---|---|---|
| Developer | SDK reference · Surface contracts | Snapshot, columns, conformance, multiplexer, sidecar |
| Operator | Run modes · Lessons pipeline | Topology, conformance, drift and variance (read-level) |
| CTO | Overview & first principles | Mediating lens · Run modes (skim) |
| AI researcher | Overview · Mediating lens | Drift attribution · Variance isolation — at capability depth |
- 01 Overview & first principles What Holonograph is, what it observes, and why position beats instrumentation. live
- 02 Surface contracts Declaring an evaluation surface — its dimensions, cohort tags, substrate columns, and routings — and versioning it. live
- 03 The four-layer snapshot The atomic record captured per evaluation, and how to read it back. live
- 04 Substrate columns The named columns you populate so drift can be attributed to what changed about your deployment. live
-
05
SDK reference
The
HolonographClientsurface end-to-end: constructor, calls, outcomes, headers. live - 06 The mediating lens: placement & call flow Where the lens sits in the call path, and what it captures at the boundary. live
- 07 Run modes Separating evaluation from production with an enforced, fail-closed envelope. live
- 08 Sidecar / OTel integration Capturing what doesn't pass through the lens, via OpenTelemetry. live
- 09 Surface topology scanner Comparing what you declared against what the lens observed, and closing the gaps. live
- 10 Conformance & the fixture generator Turning a capability surface (tools + prose rules) into reproducible, mechanically-checkable fixtures. live
- 11 The multiplexer Fanning one surface's calls across multiple vendors for head-to-head comparison, with zero awareness at the calling agent. live
- 12 The lessons pipeline Captured overrides and approvals becoming drafted, human-gated corrective artifacts. live
- 13 Drift attribution Assigning an observed change to exactly one source: substrate, light source, lens, or noise. live
- 14 Variance isolation Separating real movement in your scores from the noise of measuring with a language model. live
Deeper technical validation of the methodology is available under NDA — request a pilot.