$ sudo science
~/projects/instagrate-me

instagrate-me

prototype

# machine-readable domain observability

A governed surface for seeing what machines try to discover about an organization, then publishing and monitoring the metadata they need.

Agents now read a domain before humans do. What they find is scattered, stale, and unowned — instagrate-me makes it a product with an owner.

instagrate-me.sudoscience.dev

problem

A domain's machine-readable truth leaks across /llms.txt, .well-known, OpenAPI specs, MCP endpoints, schema.org markup, and security.txt — published by different teams, drifting independently, and increasingly acted on by agents that don't ask twice.

thesis

Treat the machine-readable surface as a governed product: one place to observe what machines request, publish what they should find, and monitor the drift between the two.

surfaces

where the truth leaks

/llms.txt

What you want models to know, in the place they now look first.

.well-known/*

The protocol-level front door: policies, identities, capabilities.

OpenAPI & MCP

The executable surface — what agents can actually call.

brand & policy truth

Names, claims, delegations, and the people allowed to change them.

mechanics

observe, publish, monitor

discovery probes

See what crawlers and agents actually request from your domain, including the 404s — demand is data.

surface registry

Every published machine-readable artifact, with an owner, a version, and a review trail.

drift monitors

Alert when the published surface and the operational truth diverge — the machine-readable equivalent of a broken-link checker, but for facts.

delegation

Scoped authority over slices of the surface, so the API team owns the OpenAPI without owning the brand claims.

artifacts

status, honestly

sitelive

instagrate-me.sudoscience.dev

probe catalogueprototype

what machines ask domains for, ranked

drift monitorroadmap

published surface vs. operational truth

edges

connected investigations

Started from watching agent traffic in server logs ask for files nobody owned.