28 NOTES
Advanced Platform Development
Rebuilding a complete self-hosted data platform from FOSS on Kubernetes, one working component at a time.
→ Start hereREST APIs for Agents
Index the OpenAPI document. Search across catalogs. Then call one operation.
→ Read this noteLatest note · folio diagram
flowchart TB
A(["agent"]) -->|"list customers"| IDX{{"indexed OpenAPI<br/>hybrid search"}}
subgraph hits["what comes back"]
direction LR
SF["Salesforce<br/>GET /customers"]
BILL["billing<br/>listAccounts"]
CRM["CRM<br/>searchContacts"]
end
IDX --> hits
hits -->|"operation id"| CALL[/the live call/]
A REST API with thousands of endpoints will generate thousands of functions for an agent if you run the usual OpenAPI generator. Speakeasy’s default is still that mapping. Cloudflare measured their own API at 2,594 …
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
147
Sessions 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
140One Cluster Across Clouds and Your Garage: Hybrid k3s With WireGuard
A single Kubernetes cluster spanning cloud regions and your own hardware, encrypted over the public internet
2026-08-10