The Website Specification
Website Spec

What a good
website does.

A field guide to the technical details that matter. From your first <title> to your last HTTP header. For humans and agents, whatever your stack.

Explore the spec Get the checklist
177 topics10 areasBuilt in the open ↗
Anatomy of a good website

The document

Start with the essentials

The experience

Make it usable

The trust

Protect people and keep working

The discovery

Be found and understood

One website. All of these responsibilities.

The web moves.
So does the spec.

Full changelog →

Every detail.
A reason behind it.

Ten areas, grounded in web standards.
Pick the part of your site you’re working on.

Read it.
Check it.
Make it better.

Open the checklist →

Every topic explains what it is, why it matters, and how to implement it. Every item in the checklist is a yes/no.

Required36
The platform breaks, or people are harmed, without it.
Recommended87
Something a modern website should do.
Optional48
Useful when the context calls for it.
Avoid6
Outdated, harmful, or superseded.

Audit your site. Learn what’s missing. Fix it, then re-check.

Same spec.
Another pair of eyes.

Let your agent query the whole specification through an open, read-only MCP server. No authentication needed for the reference tools.

Connect MCP ↗Agent Skill →llms.txt →
177 topicsOne specification
For peopleHTML ↗

Standards, not opinions. Primary sources on every topic.

Platform agnostic. The web is the common ground.

Built in the open.Pull requests welcome ↗