From 4150070829da9d351663d288249b782cc1e1095f Mon Sep 17 00:00:00 2001 From: lofyer 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) --- AGENTS.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 84ea03ff..a2510bcf 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -47,3 +47,28 @@ PRUNE_BRANCHES=1 ./scripts/sync-github Env knobs: `UPSTREAM_URL`, `ORIGIN_REMOTE`, `UPSTREAM_REMOTE`, `PRUNE_BRANCHES`, `DRY_RUN`. After syncing, branch a fresh `v-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-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.