From 286f49897c490f6677041a1a396140078e67ed14 Mon Sep 17 00:00:00 2001
From: lofyer <lofyer@gmail.com>
Date: Tue, 30 Jun 2026 22:16:54 +0800
Subject: [PATCH] docs(agents): document rebrand step in fork workflow

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 AGENTS.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 83f2b8a4..8a2c7abd 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -38,3 +38,20 @@ PRUNE_BRANCHES=1 ./scripts/sync-github
 ```
 
 Env knobs: `UPSTREAM_URL`, `ORIGIN_REMOTE`, `UPSTREAM_REMOTE`, `PRUNE_BRANCHES`, `DRY_RUN`. After syncing, branch a fresh `v<version>-lofyer` off the updated upstream ref and apply the appearance changes there.
+
+### Re-applying brand customizations
+
+`scripts/rebrand` swaps the standalone brand word `GPUStack` for our brand (`MesaStack`) across user-facing text. It is the first appearance change to re-apply on every new `v<version>-lofyer` branch.
+
+```bash
+# preview hits, no writes
+DRY_RUN=1 ./scripts/rebrand
+
+# apply (default GPUStack -> MesaStack)
+./scripts/rebrand
+
+# custom brand words
+FROM=GPUStack TO=AcmeStack ./scripts/rebrand
+```
+
+It deliberately **does not** touch functional references — lowercase `gpustack` (npm pkg / URLs / paths / k8s namespace), ALL-CAPS `GPUSTACK_*` constants, JS identifiers like `getGPUStackPlugin`, and `X-*` HTTP headers — and carries a line-level skip list for backend-contract strings matched at runtime (see `SKIP_LINE_PATTERNS` in the script). Always review `git diff` afterwards. Logo images under `src/assets/images/` are NOT changed by the script — replace those PNGs separately when new brand assets are available.