site-spec

The problem

The browser only shows the visible layer. Search crawlers and AI answer engines depend on another one: robots policy, structured data, response headers, accessibility semantics, sitemaps, and real server-rendered content.

What I built

site-spec audits that invisible layer. It crawls a live URL or a local build, reads the pages and HTTP headers machines actually receive, and reports concrete errors across AI searchability, SEO, structured data, accessibility, privacy, security, performance, and link integrity.

It also includes a deterministic site compiler. A validated SiteSpec becomes deployable HTML with the machine-readable foundation built in, keeping model-written markup and invented facts out of the compile path.

Proof

v0.2.0 ships live-URL and local-directory audits, JSON output, CI-ready exit codes, and deterministic site builds.

What I learned

The invisible parts of a website need the same kind of tests as the visible ones. If the foundation is explicit, it can be audited and compiled instead of hoped for.

Turning web standards into a deterministic tool that can inspect existing sites and build new ones correctly by construction.