diff --git a/SKILL.md b/SKILL.md
index d868e83b5..bf179fc4f 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -135,7 +135,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "gstack" --outcome OUTCOME \
diff --git a/autoplan/SKILL.md b/autoplan/SKILL.md
index f0530ddf7..2cc659589 100644
--- a/autoplan/SKILL.md
+++ b/autoplan/SKILL.md
@@ -404,7 +404,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "autoplan" --outcome OUTCOME \
diff --git a/benchmark-models/SKILL.md b/benchmark-models/SKILL.md
index 4c6c47dca..d4c4f13ca 100644
--- a/benchmark-models/SKILL.md
+++ b/benchmark-models/SKILL.md
@@ -139,7 +139,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "benchmark-models" --outcome OUTCOME \
diff --git a/benchmark/SKILL.md b/benchmark/SKILL.md
index 9e9b90ad9..874e8ea5d 100644
--- a/benchmark/SKILL.md
+++ b/benchmark/SKILL.md
@@ -139,7 +139,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "benchmark" --outcome OUTCOME \
diff --git a/browse/SKILL.md b/browse/SKILL.md
index 5910fa923..f471c4b71 100644
--- a/browse/SKILL.md
+++ b/browse/SKILL.md
@@ -135,7 +135,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "browse" --outcome OUTCOME \
diff --git a/canary/SKILL.md b/canary/SKILL.md
index 62be3abaa..72deeaa9f 100644
--- a/canary/SKILL.md
+++ b/canary/SKILL.md
@@ -356,7 +356,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "canary" --outcome OUTCOME \
diff --git a/codex/SKILL.md b/codex/SKILL.md
index 8e9c99cc4..69e5f723d 100644
--- a/codex/SKILL.md
+++ b/codex/SKILL.md
@@ -388,7 +388,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "codex" --outcome OUTCOME \
diff --git a/context-restore/SKILL.md b/context-restore/SKILL.md
index 7a6a0a14e..bb75f43c1 100644
--- a/context-restore/SKILL.md
+++ b/context-restore/SKILL.md
@@ -358,7 +358,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "context-restore" --outcome OUTCOME \
diff --git a/context-save/SKILL.md b/context-save/SKILL.md
index 1476c6375..2ab4b73a7 100644
--- a/context-save/SKILL.md
+++ b/context-save/SKILL.md
@@ -357,7 +357,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "context-save" --outcome OUTCOME \
diff --git a/design-consultation/SKILL.md b/design-consultation/SKILL.md
index 2397f1752..3cd1673c8 100644
--- a/design-consultation/SKILL.md
+++ b/design-consultation/SKILL.md
@@ -411,7 +411,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "design-consultation" --outcome OUTCOME \
diff --git a/design-html/SKILL.md b/design-html/SKILL.md
index 6c2532a75..9cec50ffc 100644
--- a/design-html/SKILL.md
+++ b/design-html/SKILL.md
@@ -363,7 +363,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "design-html" --outcome OUTCOME \
diff --git a/design-review/SKILL.md b/design-review/SKILL.md
index 4fc69f108..dfb0c7a90 100644
--- a/design-review/SKILL.md
+++ b/design-review/SKILL.md
@@ -389,7 +389,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "design-review" --outcome OUTCOME \
diff --git a/design-shotgun/SKILL.md b/design-shotgun/SKILL.md
index 5a6a35631..24b3b1dbf 100644
--- a/design-shotgun/SKILL.md
+++ b/design-shotgun/SKILL.md
@@ -377,7 +377,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "design-shotgun" --outcome OUTCOME \
diff --git a/devex-review/SKILL.md b/devex-review/SKILL.md
index 842391b69..e974e649e 100644
--- a/devex-review/SKILL.md
+++ b/devex-review/SKILL.md
@@ -391,7 +391,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "devex-review" --outcome OUTCOME \
diff --git a/diagram/SKILL.md b/diagram/SKILL.md
index bff370829..67b7ac2d4 100644
--- a/diagram/SKILL.md
+++ b/diagram/SKILL.md
@@ -138,7 +138,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "diagram" --outcome OUTCOME \
diff --git a/document-generate/SKILL.md b/document-generate/SKILL.md
index fb4f85c2c..2b318e0a7 100644
--- a/document-generate/SKILL.md
+++ b/document-generate/SKILL.md
@@ -362,7 +362,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "document-generate" --outcome OUTCOME \
diff --git a/document-release/SKILL.md b/document-release/SKILL.md
index bbed8b605..5fcba0f1a 100644
--- a/document-release/SKILL.md
+++ b/document-release/SKILL.md
@@ -360,7 +360,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "document-release" --outcome OUTCOME \
diff --git a/health/SKILL.md b/health/SKILL.md
index 9caae6350..a03661f59 100644
--- a/health/SKILL.md
+++ b/health/SKILL.md
@@ -358,7 +358,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "health" --outcome OUTCOME \
diff --git a/investigate/SKILL.md b/investigate/SKILL.md
index 8678884ae..7a9a05f4f 100644
--- a/investigate/SKILL.md
+++ b/investigate/SKILL.md
@@ -397,7 +397,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "investigate" --outcome OUTCOME \
diff --git a/ios-clean/SKILL.md b/ios-clean/SKILL.md
index 3cf5016b3..834507879 100644
--- a/ios-clean/SKILL.md
+++ b/ios-clean/SKILL.md
@@ -360,7 +360,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "ios-clean" --outcome OUTCOME \
diff --git a/ios-design-review/SKILL.md b/ios-design-review/SKILL.md
index 9a5381626..6bdcd76e5 100644
--- a/ios-design-review/SKILL.md
+++ b/ios-design-review/SKILL.md
@@ -362,7 +362,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "ios-design-review" --outcome OUTCOME \
diff --git a/ios-fix/SKILL.md b/ios-fix/SKILL.md
index e2a59ba05..638a2264d 100644
--- a/ios-fix/SKILL.md
+++ b/ios-fix/SKILL.md
@@ -363,7 +363,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "ios-fix" --outcome OUTCOME \
diff --git a/ios-qa/SKILL.md b/ios-qa/SKILL.md
index e43a89962..23f462a7a 100644
--- a/ios-qa/SKILL.md
+++ b/ios-qa/SKILL.md
@@ -395,7 +395,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "ios-qa" --outcome OUTCOME \
diff --git a/ios-sync/SKILL.md b/ios-sync/SKILL.md
index 66b02d4d2..e0dd137a7 100644
--- a/ios-sync/SKILL.md
+++ b/ios-sync/SKILL.md
@@ -360,7 +360,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "ios-sync" --outcome OUTCOME \
diff --git a/land-and-deploy/SKILL.md b/land-and-deploy/SKILL.md
index 79c3bb124..62d86669b 100644
--- a/land-and-deploy/SKILL.md
+++ b/land-and-deploy/SKILL.md
@@ -384,7 +384,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "land-and-deploy" --outcome OUTCOME \
diff --git a/landing-report/SKILL.md b/landing-report/SKILL.md
index 77795c0d9..99d2170ba 100644
--- a/landing-report/SKILL.md
+++ b/landing-report/SKILL.md
@@ -357,7 +357,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "landing-report" --outcome OUTCOME \
diff --git a/learn/SKILL.md b/learn/SKILL.md
index 4cc270d9a..cf184dd9b 100644
--- a/learn/SKILL.md
+++ b/learn/SKILL.md
@@ -358,7 +358,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "learn" --outcome OUTCOME \
diff --git a/make-pdf/SKILL.md b/make-pdf/SKILL.md
index 2bd3d158b..e61ba1220 100644
--- a/make-pdf/SKILL.md
+++ b/make-pdf/SKILL.md
@@ -176,7 +176,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "make-pdf" --outcome OUTCOME \
diff --git a/office-hours/SKILL.md b/office-hours/SKILL.md
index 80ef8e94e..0de969e06 100644
--- a/office-hours/SKILL.md
+++ b/office-hours/SKILL.md
@@ -421,7 +421,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "office-hours" --outcome OUTCOME \
diff --git a/open-gstack-browser/SKILL.md b/open-gstack-browser/SKILL.md
index 779985f73..7583e9dd3 100644
--- a/open-gstack-browser/SKILL.md
+++ b/open-gstack-browser/SKILL.md
@@ -137,7 +137,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "open-gstack-browser" --outcome OUTCOME \
diff --git a/pair-agent/SKILL.md b/pair-agent/SKILL.md
index 1bde36ff8..7af82fff1 100644
--- a/pair-agent/SKILL.md
+++ b/pair-agent/SKILL.md
@@ -359,7 +359,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "pair-agent" --outcome OUTCOME \
diff --git a/plan-ceo-review/SKILL.md b/plan-ceo-review/SKILL.md
index b35feffaa..61a376067 100644
--- a/plan-ceo-review/SKILL.md
+++ b/plan-ceo-review/SKILL.md
@@ -407,7 +407,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "plan-ceo-review" --outcome OUTCOME \
diff --git a/plan-design-review/SKILL.md b/plan-design-review/SKILL.md
index 6f9922ad1..079b97886 100644
--- a/plan-design-review/SKILL.md
+++ b/plan-design-review/SKILL.md
@@ -413,7 +413,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "plan-design-review" --outcome OUTCOME \
diff --git a/plan-devex-review/SKILL.md b/plan-devex-review/SKILL.md
index f885da7ad..b7a15c449 100644
--- a/plan-devex-review/SKILL.md
+++ b/plan-devex-review/SKILL.md
@@ -385,7 +385,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "plan-devex-review" --outcome OUTCOME \
diff --git a/plan-eng-review/SKILL.md b/plan-eng-review/SKILL.md
index 84ea33c82..00c1cbbe6 100644
--- a/plan-eng-review/SKILL.md
+++ b/plan-eng-review/SKILL.md
@@ -430,7 +430,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "plan-eng-review" --outcome OUTCOME \
diff --git a/plan-tune/SKILL.md b/plan-tune/SKILL.md
index 50f5135a3..1159ef68b 100644
--- a/plan-tune/SKILL.md
+++ b/plan-tune/SKILL.md
@@ -368,7 +368,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "plan-tune" --outcome OUTCOME \
diff --git a/qa-only/SKILL.md b/qa-only/SKILL.md
index 26923f7fb..e939e9d72 100644
--- a/qa-only/SKILL.md
+++ b/qa-only/SKILL.md
@@ -387,7 +387,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "qa-only" --outcome OUTCOME \
diff --git a/qa/SKILL.md b/qa/SKILL.md
index 09327529e..99bcb287a 100644
--- a/qa/SKILL.md
+++ b/qa/SKILL.md
@@ -391,7 +391,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "qa" --outcome OUTCOME \
diff --git a/retro/SKILL.md b/retro/SKILL.md
index 10a6cf518..00d62f6c9 100644
--- a/retro/SKILL.md
+++ b/retro/SKILL.md
@@ -376,7 +376,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "retro" --outcome OUTCOME \
diff --git a/review/SKILL.md b/review/SKILL.md
index 75e1a8ad4..5cbd5d588 100644
--- a/review/SKILL.md
+++ b/review/SKILL.md
@@ -389,7 +389,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "review" --outcome OUTCOME \
diff --git a/scrape/SKILL.md b/scrape/SKILL.md
index ad2701517..91cfed2ee 100644
--- a/scrape/SKILL.md
+++ b/scrape/SKILL.md
@@ -134,7 +134,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "scrape" --outcome OUTCOME \
diff --git a/setup-browser-cookies/SKILL.md b/setup-browser-cookies/SKILL.md
index e2644d8ed..5a1cc7c92 100644
--- a/setup-browser-cookies/SKILL.md
+++ b/setup-browser-cookies/SKILL.md
@@ -133,7 +133,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "setup-browser-cookies" --outcome OUTCOME \
diff --git a/setup-deploy/SKILL.md b/setup-deploy/SKILL.md
index bc9cce297..263161df5 100644
--- a/setup-deploy/SKILL.md
+++ b/setup-deploy/SKILL.md
@@ -359,7 +359,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "setup-deploy" --outcome OUTCOME \
diff --git a/setup-gbrain/SKILL.md b/setup-gbrain/SKILL.md
index 795ba7bc6..938410de2 100644
--- a/setup-gbrain/SKILL.md
+++ b/setup-gbrain/SKILL.md
@@ -358,7 +358,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "setup-gbrain" --outcome OUTCOME \
diff --git a/ship/SKILL.md b/ship/SKILL.md
index 2fc36c6b1..469211a69 100644
--- a/ship/SKILL.md
+++ b/ship/SKILL.md
@@ -389,7 +389,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "ship" --outcome OUTCOME \
diff --git a/skillify/SKILL.md b/skillify/SKILL.md
index cae10b823..335f5c836 100644
--- a/skillify/SKILL.md
+++ b/skillify/SKILL.md
@@ -357,7 +357,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "skillify" --outcome OUTCOME \
diff --git a/spec/SKILL.md b/spec/SKILL.md
index f2d3c2daf..cb5e994cd 100644
--- a/spec/SKILL.md
+++ b/spec/SKILL.md
@@ -387,7 +387,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "spec" --outcome OUTCOME \
diff --git a/sync-gbrain/SKILL.md b/sync-gbrain/SKILL.md
index 6ab27d8cd..3c0a73cff 100644
--- a/sync-gbrain/SKILL.md
+++ b/sync-gbrain/SKILL.md
@@ -359,7 +359,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "sync-gbrain" --outcome OUTCOME \
diff --git a/test-audit/SKILL.md b/test-audit/SKILL.md
index f725326df..2febc8541 100644
--- a/test-audit/SKILL.md
+++ b/test-audit/SKILL.md
@@ -354,7 +354,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "test-audit" --outcome OUTCOME \
diff --git a/test/fixtures/context-budget.json b/test/fixtures/context-budget.json
index 501f550c2..5254cdc48 100644
--- a/test/fixtures/context-budget.json
+++ b/test/fixtures/context-budget.json
@@ -2,66 +2,66 @@
   "_comment": "Context-budget ratchet ceilings (~tokens). Regenerate: bun test/helpers/capture-context-budget.ts. Headroom: alwaysOnTotal x1.05, eagerPerInvocation x1.1. Graded by test/context-budget-ratchet.test.ts via lib/context-bill.ts checkBudget.",
   "alwaysOnTotal": 6814,
   "eagerPerInvocation": {
-    "autoplan": 17209,
-    "benchmark": 7671,
-    "benchmark-models": 3819,
-    "browse": 8137,
+    "autoplan": 17212,
+    "benchmark": 7673,
+    "benchmark-models": 3821,
+    "browse": 8139,
     "browser-skills/hackernews-frontpage": 371,
-    "canary": 13740,
+    "canary": 13742,
     "careful": 962,
-    "codex": 15225,
-    "context-restore": 10489,
-    "context-save": 10282,
+    "codex": 15227,
+    "context-restore": 10492,
+    "context-save": 10284,
     "cso": 4700,
-    "design-consultation": 15627,
-    "design-html": 14322,
-    "design-review": 34519,
-    "design-shotgun": 13874,
+    "design-consultation": 15629,
+    "design-html": 14324,
+    "design-review": 34521,
+    "design-shotgun": 13876,
     "deslop-shared-libs": 3419,
-    "devex-review": 19735,
-    "diagram": 4264,
-    "document-generate": 12115,
-    "document-release": 10479,
+    "devex-review": 19738,
+    "diagram": 4267,
+    "document-generate": 12118,
+    "document-release": 10481,
     "freeze": 1053,
-    "gstack": 4145,
+    "gstack": 4147,
     "gstack-upgrade": 4711,
     "guard": 939,
-    "health": 11796,
-    "investigate": 12434,
-    "ios-clean": 8587,
-    "ios-design-review": 8772,
-    "ios-fix": 8476,
-    "ios-qa": 11264,
-    "ios-sync": 8602,
-    "land-and-deploy": 19111,
-    "landing-report": 9299,
-    "learn": 8993,
-    "make-pdf": 5230,
-    "office-hours": 22614,
-    "open-gstack-browser": 4838,
+    "health": 11798,
+    "investigate": 12436,
+    "ios-clean": 8589,
+    "ios-design-review": 8774,
+    "ios-fix": 8478,
+    "ios-qa": 11266,
+    "ios-sync": 8604,
+    "land-and-deploy": 19114,
+    "landing-report": 9301,
+    "learn": 8996,
+    "make-pdf": 5233,
+    "office-hours": 22616,
+    "open-gstack-browser": 4840,
     "openclaw/skills/gstack-openclaw-ceo-review": 2764,
     "openclaw/skills/gstack-openclaw-investigate": 1429,
     "openclaw/skills/gstack-openclaw-office-hours": 4433,
     "openclaw/skills/gstack-openclaw-retro": 2542,
-    "pair-agent": 11397,
-    "plan-ceo-review": 21042,
-    "plan-design-review": 20517,
-    "plan-devex-review": 17904,
-    "plan-eng-review": 13518,
-    "plan-tune": 14732,
-    "qa": 13568,
-    "qa-only": 11740,
-    "retro": 19031,
-    "review": 19560,
-    "scrape": 6874,
-    "setup-browser-cookies": 3494,
-    "setup-deploy": 11369,
-    "setup-gbrain": 15619,
-    "ship": 20627,
-    "skillify": 11957,
-    "spec": 14807,
-    "sync-gbrain": 14738,
-    "test-audit": 10532,
+    "pair-agent": 11399,
+    "plan-ceo-review": 21044,
+    "plan-design-review": 20519,
+    "plan-devex-review": 17906,
+    "plan-eng-review": 13521,
+    "plan-tune": 14734,
+    "qa": 13570,
+    "qa-only": 11742,
+    "retro": 19033,
+    "review": 19562,
+    "scrape": 6876,
+    "setup-browser-cookies": 3497,
+    "setup-deploy": 11372,
+    "setup-gbrain": 15621,
+    "ship": 20629,
+    "skillify": 11960,
+    "spec": 14809,
+    "sync-gbrain": 14740,
+    "test-audit": 10535,
     "unfreeze": 448
   }
 }
diff --git a/test/fixtures/golden/claude-ship-SKILL.md b/test/fixtures/golden/claude-ship-SKILL.md
index 2fc36c6b1..469211a69 100644
--- a/test/fixtures/golden/claude-ship-SKILL.md
+++ b/test/fixtures/golden/claude-ship-SKILL.md
@@ -389,7 +389,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 ~/.claude/skills/gstack/bin/gstack-skill-end --skill "ship" --outcome OUTCOME \
diff --git a/test/fixtures/golden/codex-ship-SKILL.md b/test/fixtures/golden/codex-ship-SKILL.md
index d55d57a7a..8e4096251 100644
--- a/test/fixtures/golden/codex-ship-SKILL.md
+++ b/test/fixtures/golden/codex-ship-SKILL.md
@@ -396,7 +396,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 $GSTACK_BIN/gstack-skill-end --skill "ship" --outcome OUTCOME \
diff --git a/test/fixtures/golden/factory-ship-SKILL.md b/test/fixtures/golden/factory-ship-SKILL.md
index ddde576c4..16d743f0e 100644
--- a/test/fixtures/golden/factory-ship-SKILL.md
+++ b/test/fixtures/golden/factory-ship-SKILL.md
@@ -377,7 +377,7 @@ preamble's skill-start output echoed. It also drains the artifacts-sync queue
 (the former skill-end sync step — do not run gstack-brain-sync separately).
 
 **PLAN MODE EXCEPTION — ALWAYS RUN:** This writes telemetry to
-`~/.gstack/analytics/`, matching preamble analytics writes.
+`$GSTACK_STATE_ROOT/analytics/`, matching preamble analytics writes.
 
 ```bash
 $GSTACK_BIN/gstack-skill-end --skill "ship" --outcome OUTCOME \