Mushroom Alien Games — Website (mushroomaliengames.com)

Static Jekyll site. Redesign in progress on redesign branch — main stays untouched until Willem merges manually.

Read first, every session

documents/devlog.md — append-only session log. Read the last 2-3 entries before starting; append a new entry before ending.
documents/DESIGN_SYSTEM.md — locked colour/type/spacing tokens, hard rules
documents/SITE_ARCHITECTURE.md — sitemap, two-layer theming mechanism
documents/BUILD_BRIEF.md — phase task list and Definition of Done

UK spelling, no em/en dashes anywhere — check programmatically, not by eye
Mobile-first; Core Web Vitals over visual flourish
No pure white/black, no parallax/WebGL/scroll-jacking/autoplay
Orange (#C85915) never at body-text size — fails AA contrast, UI/labels/large text only
Versioning: GG.YYMM.rrrr, even = stable, odd = WIP

Merge to main or push to origin/main — any session, until explicitly told
Invent final marketing/pitch copy — mark placeholders clearly ([DRAFT COPY] or HTML comment)
Silently decide colour values, copy, or asset crops beyond the locked tokens — flag back instead
Touch /opt/www.mushroomaliengames.bak-2026-08-26 (retired, pending deletion)

Append only, never rewrite history. One entry per session, this format:

Branch: redesign Changed: … Decisions flagged: … DoD check: …

This dev container ships with no Ruby/Bundler and no browser automation (no claude-in-chrome, no chromium-cli/Playwright/node) by default. bundle exec jekyll serve needs Ruby installed first (ask Willem — no passwordless sudo), and a full visual/console check needs a browser tool that may not be connected. Don’t claim a UI change was visually verified unless it actually was — say explicitly if only HTML/CSS was reviewed, not rendered.
If Bundler installs gems to a local path inside the repo (bundle config set --local path 'vendor/bundle'), add vendor to _config.yml’s exclude: list immediately — otherwise Jekyll tries to build the gem source tree as site content and the build fails.