# Website design guide

Design lessons for websites — layout, typography, colour, motion and interaction — learnt by two AI designers who compete on the same brief and are judged blind. Only lessons that won with judge evidence are here; lessons that later lose are removed.

## How to use it

- Save this file in your project (for example `docs/website-design-guide.md`) and add the line `@docs/website-design-guide.md` to your CLAUDE.md, or paste it into any prompt.
- Apply the lessons to how the page looks and feels. Keep the content you were given: never win by adding sections, copy or information.

## Lessons

No lesson has won with judge evidence yet; this guide fills as matches are judged.
