28 NOTES
Advanced Platform Development
Rebuilding a complete self-hosted data platform from FOSS on Kubernetes, one working component at a time.
→ Start hereLatest note · folio diagram
sequenceDiagram autonumber participant CD as Claude participant MCP as MCP process (AS) participant KC as Keycloak (IdP) CD->>MCP: GET /authorize (S256 challenge) MCP->>CD: 302 to Keycloak (static client_id) CD->>KC: user logs in KC->>MCP: GET /callback?code=... MCP->>KC: exchange code KC->>MCP: ID token plus access token MCP->>CD: 302 with MCP code CD->>MCP: POST /token plus verifier MCP->>CD: JWT (aud = this issuer)
If you operate the MCP server, you pre-register the clients. A client_id, a secret, redirect URIs in the YAML. That is still first in the 2026-07-28 spec, and it is the default in mcp-data-platform, also hosted as …
Current Series
20 NOTES
MCP Without the SDK
The Model Context Protocol taken apart one JSON message at a time, written by hand in Go.
→ Start here
5 NOTES
MCP Studies
Measured studies of MCP agent behavior: knowledge-layer ablation, stored-knowledge use, the measurement harness, knowledge pollution, and cross-reference document completion.
→ Start here
5 NOTES
AI on a Leash
Mechanical verification for AI-written code: strict linting, coverage gates, mutation testing, and a pre-commit gate that refuses the commit.
→ Start here
Recent Notes
148
REST APIs for Agents
Index the OpenAPI document. Search across catalogs. Then call one operation.
2026-08-30
147Sessions Left the Protocol. Put the Handle in the Argument.
platform_info mints dps_…; the model threads it. Go SDK v1.7.0, MCP 2026-07-28.
2026-08-28
146Don't Ingest the CSV. Point Hive at It.
Hive still maps a table name to a directory of files
2026-08-26
145Don't Sandbox Python. Embed Starlark.
starlark-go in a Go server: FileOptions, host bindings, and a cancel watchdog
2026-08-24
144God Packages and Other Slow Failures
Structural ratchets for AI-assisted Go, six months into make verify
2026-08-22
143Do Cross-References Help LLM Agents Complete Documents?
The agent found every page certified unreachable. Links cut search cost and keep working when search is off; they do not change what it reaches
2026-08-20
142Knowledge Pollution: Verification Displacement, Capability, and the Price of a Curation Gate
A wrong note that passed review spread only where the agent could have checked it, and only on Haiku 4.5: 16 of 24, against 0 of 24 on Sonnet 5 and Opus 5
2026-08-17
141On-Prem GPUs in a Boring Kubernetes Cluster
Adding your own GPUs to the platform with the NVIDIA GPU Operator
2026-08-12