diff --git a/AGENTS.md b/AGENTS.md index c1e5595fc..868ea55c9 100644 --- a/AGENTS.md +++ b/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. | diff --git a/docs/gbrain-sync-errors.md b/docs/gbrain-sync-errors.md index 52120a8b2..7ab50cdfe 100644 --- a/docs/gbrain-sync-errors.md +++ b/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 diff --git a/docs/gbrain-sync.md b/docs/gbrain-sync.md index e5f1d7007..62a12b56a 100644 --- a/docs/gbrain-sync.md +++ b/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, diff --git a/docs/skills.md b/docs/skills.md index b20bf665d..626af0f80 100644 --- a/docs/skills.md +++ b/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. | diff --git a/test/no-stale-gstack-brain-refs.test.ts b/test/no-stale-gstack-brain-refs.test.ts index 509299183..5aa007d67 100644 --- a/test/no-stale-gstack-brain-refs.test.ts +++ b/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.