OpenAPI
How to generate an OpenAPI spec from existing codeFour working ways to get an OpenAPI 3.1 spec out of a codebase that never had one, what each approach misses, and how to keep the result true.4 min readEngineering articles and guides
Engineering notes from building Elva: how a repo becomes a catalog, how agents call APIs, and what the numbers said. How static analysis reads route handlers and validators, how agent-readiness is scored, and where MCP and REST genuinely differ, written from the code.
4 posts, newest first · UpdatedMCP
MCP vs REST: what changes when agents call your APIMCP does not replace REST. It changes who the caller is. What that shift means for interface design, auth, error messages, and operations.4 min readEngineering
How Elva reads a repo: from route handlers to OpenAPI 3.1Static analysis, framework fingerprints, and the messy middle where code and spec disagree.11 min readEngineering
Scoring agent readiness: what the A–E grade actually measuresDescription coverage, schema completeness, auth clarity, and the weights behind the grade.9 min readShip notes, monthly
One email with what shipped and what we learned. Unsubscribe anytime.
Ship APIs anything can call
Humans, tests, partners, agents. One catalog, one contract, one place.