diff --git a/AI_CODER_PROMPT.md b/AI_CODER_PROMPT.md index d1c076d..7f7e1cc 100644 --- a/AI_CODER_PROMPT.md +++ b/AI_CODER_PROMPT.md @@ -30,6 +30,10 @@ easy to read for both older and younger visitors, on desktop and on mobile. This is a refresh, not a redesign. Do not add features, do not change the information architecture, do not introduce a block theme or `theme.json`. +**The overriding principle: the site must behave and look the same as it does +today — only cleaner, more readable and more accessible. Do not break any +existing markup, class name or ID.** + ## Deliverables | File | Action | @@ -50,52 +54,83 @@ information architecture, do not introduce a block theme or `theme.json`. ## Non-negotiable constraints -1. **Keep every third-party class name.** These must keep working unchanged: - - RSS plugin: `.rss-feed`, `.rss-title` - - Slideshow plugin: `.super-simple-slideshow`, `img.super-simple-slide`, `.active` - - bbPress: every `.bbp-*`, `#bbp_*`, `.forums`, `.favorite-toggle`, - `#subscription-toggle`, `.pw-weak`, `#new-post`, `.bbp-form`, - `.bbp-submit-wrapper` - - WordPress core: `.screen-reader-text`, `.wp-block-*`, `.alignnone`, - `.has-fixed-layout`, `.pagination`, `.page-numbers`, `.entry-title`, - `.entry-meta`, `.entry-content`, `.search-container`, `.search-form`, - `.search-field`, `.search-submit` -2. **Everything hidden today must stay hidden.** Copy the existing +1. **Do not rename any existing HTML class name or ID.** The site owner may + have custom CSS under Appearance → Customize → Additional CSS that targets + them. Keep all of these exactly as they are: `.header-menu-class`, + `#nav-grid`, `.logo`, `.entry-title`, `.entry-meta`, `.entry-content`, + `.date`, `.categories`, `.author`, `.pagination`, `.prev`, `.page-numbers`, + `.next`, `.search-container`, `.search-form`, `.search-field`, + `.search-submit`, `.footer-logo`, `#logout`, `#org-nr`, `.rss-feed`, + `.rss-title`, `.super-simple-slideshow`, `.super-simple-slide`, every + `.bbp-*`, every `.wp-block-*`, `.screen-reader-text`, `.alignnone`, + `.has-fixed-layout`. + You may **add** new class names, but never remove or rename an existing one. +2. **Keep every third-party class name working.** RSS plugin: `.rss-feed`, + `.rss-title`. Slideshow plugin: `.super-simple-slideshow`, + `img.super-simple-slide`, `.active`. bbPress: every `.bbp-*`, `#bbp_*`, + `.forums`, `.favorite-toggle`, `#subscription-toggle`, `.pw-weak`, + `#new-post`, `.bbp-form`, `.bbp-submit-wrapper`. +3. **Everything hidden today must stay hidden.** Copy the existing `display: none !important` selector list for bbPress verbatim, reindented only. The single exception is `.screen-reader-text`, which must be changed - to a proper visually-hidden technique (see task H below). -3. **Keep the nav menu location slug `header-menu`.** Renaming it would make + to a proper visually-hidden technique. It stays invisible to the eye — it + just becomes readable by screen readers again. +4. **Keep the nav menu location slug `header-menu`.** Renaming it would make the site lose its menu assignment on theme switch. -4. **No external requests.** No Google Fonts, no CDNs. Everything local. -5. **No build step.** Plain CSS in `style.css`. No npm, no minification. -6. **No `!important`** outside the preserved hide list. -7. Escape all output: `esc_html()`, `esc_attr()`, `esc_url()`, `wp_kses_post()`. -8. Comments in code in English. User-facing strings in Norwegian Nynorsk, - wrapped in `__()` / `esc_html__()` / `esc_attr__()` with the text domain - `super-simple-wp-theme`. +5. **Keep content, pagination, slideshow, search and RSS exactly where they are + today.** Do not move them, do not add conditional guards around them beyond + the shortcode check described below. +6. **No external requests.** No Google Fonts, no CDNs. No webfont is + downloaded. +7. **No build step.** Plain CSS in `style.css`. No npm, no minification. +8. **No `!important`** outside the preserved hide list. +9. Escape all output: `esc_html()`, `esc_attr()`, `esc_url()`, `wp_kses_post()`. +10. Comments in code in English. User-facing strings in Norwegian Nynorsk, + wrapped in `__()` / `esc_html__()` / `esc_attr__()` with the text domain + `super-simple-wp-theme`. ## Design tokens to implement -Colour palette. The current `#38629F` only reaches 6.1:1 with white text and -the muted colour `#AAA` on it fails at 2.6:1. Move to a darker blue so both -body text and meta text pass AAA. +Palette. The current `#38629F` only reaches 6.1:1 with white text, and the +muted colour `#AAA` on it fails at 2.6:1. The new palette stays in the same +blue family but is darker, so that **all text reaches AAA (7:1)** and all +functional borders reach 3:1. A second surface colour makes it impossible for +form fields to end up white-on-white. -| Token | Value | Role | Contrast on `--sswt-bg` | -|---|---|---|---| -| `--sswt-bg` | `#1F3E6B` | page background | – | -| `--sswt-text` | `#FFFFFF` | body text, headings | 10.7:1 (AAA) | -| `--sswt-text-muted` | `#C6D3E8` | date, category, feed source | 7.1:1 (AAA) | -| `--sswt-link` | `#FFD479` | links | 7.6:1 (AAA) | -| `--sswt-link-hover` | `#FFFFFF` | link hover and focus | 10.7:1 | -| `--sswt-border` | `#6C8CBF` | rules and borders | 3.1:1 (≥3:1 UI) | -| `--sswt-accent-bg` | `#FFD479` | button background | – | -| `--sswt-accent-text` | `#1F3E6B` | button text | 7.6:1 | +| Token | Value | Role | +|---|---|---| +| `--sswt-bg` | `#1F3E6B` | page background | +| `--sswt-surface` | `#2A4E80` | form fields, notice boxes, table headers | +| `--sswt-text` | `#FFFFFF` | body text, headings | +| `--sswt-text-muted` | `#C6D3E8` | date, category, feed source, meta text | +| `--sswt-link` | `#FFD479` | links | +| `--sswt-link-hover` | `#FFFFFF` | link hover | +| `--sswt-rule` | `#6C8CBF` | decorative separators | +| `--sswt-border` | `#8FA9D4` | form field and button borders | +| `--sswt-accent-bg` | `#FFD479` | button background | +| `--sswt-accent-text` | `#1F3E6B` | button text | +| `--sswt-focus` | `#FFFFFF` | focus outline | + +Measured contrasts — do not regress these: + +| Combination | Contrast | Level | +|---|---|---| +| `--sswt-text` on `--sswt-bg` | 10.7:1 | AAA | +| `--sswt-text` on `--sswt-surface` | 8.4:1 | AAA | +| `--sswt-text-muted` on `--sswt-bg` | 7.1:1 | AAA | +| `--sswt-text-muted` on `--sswt-surface` | 5.6:1 | AA | +| `--sswt-link` on `--sswt-bg` | 7.6:1 | AAA | +| `--sswt-link` on `--sswt-surface` | 6.0:1 | AA | +| `--sswt-accent-text` on `--sswt-accent-bg` | 7.6:1 | AAA | +| `--sswt-rule` on `--sswt-bg` | 3.1:1 | ≥3:1 (UI) | +| `--sswt-border` on `--sswt-surface` | 3.5:1 | ≥3:1 (UI) | +| `--sswt-focus` on `--sswt-bg` | 10.7:1 | AAA | Typography and layout: | Token | Value | |---|---| -| `--sswt-font` | `Manrope, "Segoe UI", system-ui, -apple-system, "Helvetica Neue", Arial, sans-serif` | +| `--sswt-font` | `Manrope, system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif` | | `body` | `font-size: 1.125rem` (18 px), `line-height: 1.6`, `letter-spacing: 0.01em` | | `--sswt-measure` | `42rem` — body text column | | `--sswt-wide` | `64rem` — header, nav, footer | @@ -105,6 +140,10 @@ Typography and layout: | `h4` | `1.15rem` | | interactive target | minimum `44px` tall | +Manrope stays first in the stack but is **not downloaded**. Visitors who have it +locally get it; everyone else gets their system font. No external requests, no +layout shift. + `html` must be `font-size: 100%` — never a pixel value. All sizes in `rem` so that user font-size settings are respected. @@ -140,8 +179,7 @@ it, then move on. Do not batch unrelated changes. 9. Keep the `wp_mail_from` / `wp_mail_from_name` filters, but read the values through `apply_filters( 'sswt_mail_from', ... )` and `apply_filters( 'sswt_mail_from_name', ... )` so they are configurable. -10. Add a small helper `sswt_shortcode_exists()` or use `shortcode_exists()` - directly — see tasks D and E. +10. Do not add anything else. No new features. ### C. `header.php` 1. Add `wp_head()` inside `
`. Add `body_class()` on `` and @@ -151,9 +189,10 @@ it, then move on. Do not batch unrelated changes. `` with the Nynorsk label `Hopp til innhald`. 4. Wrap the header in `