From 0ee48ba004b0776f8e2817694ddc806063dc1eb5 Mon Sep 17 00:00:00 2001 From: Sluijsens Date: Sun, 27 Sep 2026 12:05:38 +0200 Subject: [PATCH] Adds a specific .ai folder for ai related stuff like the layout conventions --- .ai/layout-conventions.md | 33 +++++++++++++++++++++++++++++++++ AGENTS.md | 7 +++++++ LAYOUT.md | 2 ++ 3 files changed, 42 insertions(+) create mode 100644 .ai/layout-conventions.md create mode 100644 AGENTS.md diff --git a/.ai/layout-conventions.md b/.ai/layout-conventions.md new file mode 100644 index 0000000..4c262a1 --- /dev/null +++ b/.ai/layout-conventions.md @@ -0,0 +1,33 @@ +# LAYOUT.md conventions + +[LAYOUT.md](../LAYOUT.md) shows the abstract set-up of each page of the website. Every page section holds a Mermaid `block-beta` diagram showing only the abstract building blocks (sections) of that page, stacked top-to-bottom in the order they appear — no content/copy, just block names. This is meant to give a fast overview of what's on each page and double as a checklist of elements still to implement. + +## Letter/color template + +Used by every page except Shell (see exception below): + +- Blocks are lettered `A`, `B`, `C`, ... in strict alphabetical order, top-to-bottom matching the page's visual order. +- Each letter has a **permanently fixed color** across the whole document — `A` is always `#e76f51`, `B` is always `#f4a261`, etc. (see template below). Colors are not tied to a block's meaning, only to its letter/position. +- To add a new page: write `block-beta` / `columns 1`, list the section labels as `A["..."]`, `B["..."]`, ... top-to-bottom, then copy the matching `style` lines straight from the template — no color decisions needed. +- If a block gets inserted mid-page, reletter every block from that point on so the sequence stays alphabetical (the style lines move with the letters, unchanged). +- If a page needs more blocks than the template currently has letters for, add a new letter/color rather than cycling back to `A` — never reuse a color, since that would visually suggest two different blocks are "the same element." A new color's stroke is always its fill at 25% darker (multiply each RGB channel by 0.75, round, convert back to hex), kept in the same style: medium-high saturation, similar lightness to the existing set. +- For two sections that sit side-by-side in one row (e.g. Contact's Photo + Contact form), switch that page's diagram to `columns 2`, give full-width blocks a `:2` span, and place the side-by-side pair as plain unspanned nodes next to each other in the code (no composite container needed) — small manual width tweaks to line them up are fine, it only needs to look "good enough." + +Current letter → color template (extend with a new letter using the same formula if a 7th block is ever needed): + +``` +style A fill:#e76f51,stroke:#ad533d,color:#fff,font-size:16px,width:400px,height:125px,stroke-width:2px +style B fill:#f4a261,stroke:#b77a49,color:#fff,font-size:16px,width:400px,height:125px,stroke-width:2px +style C fill:#2a9d8f,stroke:#20766b,color:#fff,font-size:16px,width:400px,height:125px,stroke-width:2px +style D fill:#264653,stroke:#1d353e,color:#fff,font-size:16px,width:400px,height:125px,stroke-width:2px +style E fill:#e9c46a,stroke:#af9350,color:#fff,font-size:16px,width:400px,height:125px,stroke-width:2px +style F fill:#b56576,stroke:#884c59,color:#fff,font-size:16px,width:400px,height:125px,stroke-width:2px +``` + +## Exception — Shell + +The Shell page is structural (the Header/Content/Footer wrapper around every page), not a content page, so it deliberately does not follow the letter/color template above. It uses named ids (`Header`, `Content`, `Footer`), a shorter `height:50px`, and a neutral style for `Content` as a placeholder for "wherever each page's own diagram goes." + +## Source of truth + +For a page's real section order/content, check the static design in [design/andreaslop-static/](../design/andreaslop-static/) — the matching HTML file there — when unsure which sections exist or their order. If a page's structure is still ambiguous from the design folder, ask the user rather than guessing. diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..b5b00be --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,7 @@ +# Agent instructions + +This file is the entry point for AI coding agents working in this repository. Project-specific conventions and instructions are kept in the [.ai/](.ai/) directory, one file per topic — check there before making related changes. + +## Index + +- [.ai/layout-conventions.md](.ai/layout-conventions.md) — how to build and update the Mermaid diagrams in [LAYOUT.md](LAYOUT.md). diff --git a/LAYOUT.md b/LAYOUT.md index 2db4f6d..12a734d 100644 --- a/LAYOUT.md +++ b/LAYOUT.md @@ -1,6 +1,8 @@ # Website Lay-out This document shows the abstract set-up of the pages of the website. +> Conventions for how these diagrams are built (colors, lettering, exceptions) live in [.ai/layout-conventions.md](.ai/layout-conventions.md). + ## Shell ```mermaid block-beta