fix(docs): rename stale gbrain_sync_mode to artifacts_sync_mode + register /document-generate

Five stale gstack-config references in docs/ pointed to the deprecated
gbrain_sync_mode key (renamed to artifacts_sync_mode in v1.27.0.0):
- docs/gbrain-sync.md: lines 62, 110, 111, 173
- docs/gbrain-sync-errors.md: lines 26, 203

Users following the docs would set a key that gstack-brain-sync no
longer reads, silently breaking artifacts sync.

Originated from @realcarsonterry PR #1461 (verbatim).

Also register /document-generate in AGENTS.md (Operational + memory
table) and docs/skills.md (skill index). The skill shipped in v1.35.0.0
but the doc-inventory cross-check in test/skill-validation.test.ts was
failing because neither file mentioned it.

Allowlist the new test/docs-config-keys.test.ts file in
test/no-stale-gstack-brain-refs.test.ts — it intentionally lists the
deprecated keys in its DEPRECATED_KEYS denylist (defending the rename).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

AGENTS.md

@@ -47,6 +47,7 @@ Invoke them by name (e.g., `/office-hours`).
 | `/canary` | Post-deploy monitoring loop using the browse daemon. |
 | `/landing-report` | Read-only dashboard for the workspace-aware ship queue. |
 | `/document-release` | Update all docs to match what you just shipped. |
+| `/document-generate` | Write missing docs from scratch in four Diataxis quadrants. |
 | `/setup-deploy` | One-time deploy config detection (Fly.io, Render, Vercel, etc.). |
 | `/gstack-upgrade` | Update gstack to the latest version. |
 

docs/gbrain-sync-errors.md

@@ -23,7 +23,7 @@ This pulls the repo into `~/.gstack/` and re-registers merge drivers.
 
 If you don't want to restore here, dismiss the hint with:
 ```bash
-gstack-config set gbrain_sync_mode_prompted true
+gstack-config set artifacts_sync_mode_prompted true
 ```
 
 ---
@@ -200,7 +200,7 @@ canonical config files from the brain repo.
 
 1. `gstack-brain-sync --status` — is mode `off`?
 2. `~/.gstack/.git` exists?
-3. `gstack-config get gbrain_sync_mode` — should be `full` or `artifacts-only`.
+3. `gstack-config get artifacts_sync_mode` — should be `full` or `artifacts-only`.
 4. The file you expect to sync — is it in the allowlist?
    `cat ~/.gstack/.brain-allowlist`
 5. Privacy class filter — if mode is `artifacts-only`, behavioral files

docs/gbrain-sync.md

@@ -59,7 +59,7 @@ privacy mode:
 - **Only artifacts**: plans, designs, retros, learnings — skip
   behavioral data (timelines, developer profile).
 - **Decline**: keep everything local. You can turn sync on later with
-  `gstack-config set gbrain_sync_mode full`.
+  `gstack-config set artifacts_sync_mode full`.
 
 Your answer is persisted. You won't be asked again.
 
@@ -107,8 +107,8 @@ output. Scan it for problems.
 
 Change anytime with:
 ```bash
-gstack-config set gbrain_sync_mode full
-gstack-config set gbrain_sync_mode off
+gstack-config set artifacts_sync_mode full
+gstack-config set artifacts_sync_mode off
 ```
 
 ## Secret protection
@@ -170,7 +170,7 @@ gstack-brain-uninstall
 This:
 
 - Removes `~/.gstack/.git/` and all `.brain-*` config files.
-- Clears `gbrain_sync_mode` in `gstack-config`.
+- Clears `artifacts_sync_mode` in `gstack-config`.
 - Does NOT touch your learnings, plans, retros, or developer profile.
 
 Add `--delete-remote` to also delete the private GitHub repo (GitHub only,

docs/skills.md

@@ -24,6 +24,7 @@ Detailed guides for every gstack skill — philosophy, workflow, and examples.
 | [`/benchmark`](#benchmark) | **Performance Engineer** | Baseline page load times, Core Web Vitals, and resource sizes. Compare before/after on every PR. Track trends over time. |
 | [`/cso`](#cso) | **Chief Security Officer** | OWASP Top 10 + STRIDE threat modeling security audit. Scans for injection, auth, crypto, and access control issues. |
 | [`/document-release`](#document-release) | **Technical Writer** | Update all project docs to match what you just shipped. Catches stale READMEs automatically. |
+| [`/document-generate`](#document-generate) | **Documentation Architect** | Bootstrap docs from scratch. Reads the codebase, partitions the public surface, writes the four Diataxis quadrants: tutorial, how-to, reference, explanation. |
 | [`/retro`](#retro) | **Eng Manager** | Team-aware weekly retro. Per-person breakdowns, shipping streaks, test health trends, growth opportunities. |
 | [`/browse`](#browse) | **QA Engineer** | Give the agent eyes. Real Chromium browser, real clicks, real screenshots. ~100ms per command. |
 | [`/setup-browser-cookies`](#setup-browser-cookies) | **Session Manager** | Import cookies from your real browser (Chrome, Arc, Brave, Edge) into the headless session. Test authenticated pages. |

test/no-stale-gstack-brain-refs.test.ts

@@ -55,6 +55,9 @@ const ALLOWLIST = [
   'test/gstack-upgrade.test.ts',
   // This test itself references the patterns to grep for.
   'test/no-stale-gstack-brain-refs.test.ts',
+  // The v1.36.0.0 doc-config drift guard intentionally defends the rename
+  // by listing the deprecated keys in its DEPRECATED_KEYS denylist.
+  'test/docs-config-keys.test.ts',
   // memory.md documents the rename context.
   'setup-gbrain/memory.md',
   // The new init script's header comment intentionally cites the rename.