From 82cbae06aab330ea9ae6c6b76c4a70bad0f3501c Mon Sep 17 00:00:00 2001 From: Hannes Rudolph <49103247+hannesrudolph@users.noreply.github.com> Date: Tue, 27 Oct 2026 11:55:10 -0600 Subject: [PATCH 1/2] docs: require live Carapace brand-source preflight --- AGENTS.md | 8 ++++++++ scripts/docs-site/AGENTS.md | 1 + 2 files changed, 9 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 1a749ff071..1c730d3fdd 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -34,6 +34,14 @@ Website UI, translations, and publishing for `docs.openclaw.ai`. English content - `.openclaw-sync/source.json`; generated sync metadata. - `.openclaw-sync/check-docs-mdx.mjs` and `.openclaw-sync/docs-mdx-repair.md`; copied from `openclaw/openclaw`. +## Design and artwork + +Route design work through [OpenClaw Design](.agents/skills/openclaw-design/SKILL.md); renderer and site-asset implementation belongs under `scripts/docs-site/**`. + +Before selecting or creating OpenClaw or OpenClaw Foundation artwork in each task, check the live [Carapace brand kit](https://github.com/openclaw/carapace/tree/main/brand-kit), resolve upstream `main` afresh, and read its current README, inventory, and relevant linked usage/rights guidance. Record the observed commit and selected paths/hashes in task evidence, then download and use the appropriate current assets from that commit within the requested scope. Local SVGs, hero art, vendored skills, old ZIPs, and prior outputs are consumer references or caches, not canonical identity. Report a failed live check or missing/conflicting guidance rather than silently falling back; recheck after a long pause or before delivery when the source may have changed. + +Preserve supplied artwork proportions, outlined lettering, colors, and transparency. Keep page composition, semantic UI tokens, release-pinned runtime CSS, portraits, subbrands, and rights/publication approvals separate; historical reproductions must be explicitly requested, labeled, and pinned. Use reviewed repository-local assets, not mutable-main production hotlinks or an automatic global rebrand. Update vendored Carapace skills through their upstream source and supported updater, not hand-edited copies. + ## Workflow - For a local page preview, run `npm run docs:build:preview -- --page ` (repeat `--page` for more pages). It builds at most 30 pages in English, including the requested pages. Use this for screenshots; do not run translation or full publishing builds just for a preview. See `scripts/docs-site/AGENTS.md` for fixture and validation options. diff --git a/scripts/docs-site/AGENTS.md b/scripts/docs-site/AGENTS.md index e3e5975e72..c75e941f28 100644 --- a/scripts/docs-site/AGENTS.md +++ b/scripts/docs-site/AGENTS.md @@ -2,6 +2,7 @@ Scope: docs shell generator, hidden visual fixtures, local smoke checks, and R2 artifact preparation. +- Before selecting or creating shell, favicon, hero, or OG artwork, follow the root [live brand-source preflight](../../AGENTS.md#design-and-artwork); existing site SVGs and hero art are consumer references, not canonical identity, and do not override composition or semantic UI contracts. - Do not edit generated `dist/docs-site/**`; rebuild it. - Keep authored docs under `docs/**` out of this subtree. Use virtual fixtures or generator code here when testing shell UI. - The hidden component fixture is generated at `/__elements`; keep it `noindex` and out of `sitemap.xml` and `llms.txt`. From 8ea7e875e73570769be810b0841dfd19010add75 Mon Sep 17 00:00:00 2001 From: Hannes Rudolph <49103247+hannesrudolph@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:59:09 -0600 Subject: [PATCH 2/2] docs: simplify logo guidance to brand-kit pointers --- AGENTS.md | 9 +-------- scripts/docs-site/AGENTS.md | 2 +- 2 files changed, 2 insertions(+), 9 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 1c730d3fdd..f6e7eab7d5 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -34,16 +34,9 @@ Website UI, translations, and publishing for `docs.openclaw.ai`. English content - `.openclaw-sync/source.json`; generated sync metadata. - `.openclaw-sync/check-docs-mdx.mjs` and `.openclaw-sync/docs-mdx-repair.md`; copied from `openclaw/openclaw`. -## Design and artwork - -Route design work through [OpenClaw Design](.agents/skills/openclaw-design/SKILL.md); renderer and site-asset implementation belongs under `scripts/docs-site/**`. - -Before selecting or creating OpenClaw or OpenClaw Foundation artwork in each task, check the live [Carapace brand kit](https://github.com/openclaw/carapace/tree/main/brand-kit), resolve upstream `main` afresh, and read its current README, inventory, and relevant linked usage/rights guidance. Record the observed commit and selected paths/hashes in task evidence, then download and use the appropriate current assets from that commit within the requested scope. Local SVGs, hero art, vendored skills, old ZIPs, and prior outputs are consumer references or caches, not canonical identity. Report a failed live check or missing/conflicting guidance rather than silently falling back; recheck after a long pause or before delivery when the source may have changed. - -Preserve supplied artwork proportions, outlined lettering, colors, and transparency. Keep page composition, semantic UI tokens, release-pinned runtime CSS, portraits, subbrands, and rights/publication approvals separate; historical reproductions must be explicitly requested, labeled, and pinned. Use reviewed repository-local assets, not mutable-main production hotlinks or an automatic global rebrand. Update vendored Carapace skills through their upstream source and supported updater, not hand-edited copies. - ## Workflow +- For OpenClaw and OpenClaw Foundation logos, see the [brand kit](https://github.com/openclaw/carapace/tree/main/brand-kit). - For a local page preview, run `npm run docs:build:preview -- --page ` (repeat `--page` for more pages). It builds at most 30 pages in English, including the requested pages. Use this for screenshots; do not run translation or full publishing builds just for a preview. See `scripts/docs-site/AGENTS.md` for fixture and validation options. - Source sync starts in `openclaw/openclaw/.github/workflows/docs-sync-publish.yml`. - Sync mirrors `openclaw/openclaw/docs/**` into this repo and updates `.openclaw-sync/source.json`. diff --git a/scripts/docs-site/AGENTS.md b/scripts/docs-site/AGENTS.md index c75e941f28..6a0da72f48 100644 --- a/scripts/docs-site/AGENTS.md +++ b/scripts/docs-site/AGENTS.md @@ -2,7 +2,7 @@ Scope: docs shell generator, hidden visual fixtures, local smoke checks, and R2 artifact preparation. -- Before selecting or creating shell, favicon, hero, or OG artwork, follow the root [live brand-source preflight](../../AGENTS.md#design-and-artwork); existing site SVGs and hero art are consumer references, not canonical identity, and do not override composition or semantic UI contracts. +- For OpenClaw and OpenClaw Foundation logos in the docs shell or site artwork, see the [brand kit](https://github.com/openclaw/carapace/tree/main/brand-kit). - Do not edit generated `dist/docs-site/**`; rebuild it. - Keep authored docs under `docs/**` out of this subtree. Use virtual fixtures or generator code here when testing shell UI. - The hidden component fixture is generated at `/__elements`; keep it `noindex` and out of `sitemap.xml` and `llms.txt`.