From 4ad42b8c20b7cfded317fe062ca4ef38e7bb4f18 Mon Sep 17 00:00:00 2001 From: garrytan Date: Sun, 1 Nov 2026 16:12:31 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20support=20tiers=20=E2=80=94=20full=20fo?= =?UTF-8?q?r=20macOS/Linux=20with=20Claude=20and=20OpenAI,=20minimal=20for?= =?UTF-8?q?=20Windows=20and=20Gemini=20(R50)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> --- AGENTS.md | 3 +++ README.md | 2 ++ changelog.d/gsta244-support-tiers.md | 5 +++++ docs/support-tiers.md | 31 ++++++++++++++++++++++++++++ 4 files changed, 41 insertions(+) create mode 100644 changelog.d/gsta244-support-tiers.md create mode 100644 docs/support-tiers.md diff --git a/AGENTS.md b/AGENTS.md index abe32fea9..febab17af 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -281,6 +281,9 @@ Agents poll `eval:bg:*` logs for the `### gstack-detach EXIT= ###` sentine ## Platform support +Support tiers (full: macOS, Linux; minimal: Windows, Gemini models) are in +[docs/support-tiers.md](docs/support-tiers.md). + - **macOS** + **Linux**: full test suite supported. - **Windows**: the curated Windows-safe subset runs in the `windows-free-tests` CI workflow across six `windows-latest` jobs, packed by Windows-measured diff --git a/README.md b/README.md index 011832a81..47fb9c848 100644 --- a/README.md +++ b/README.md @@ -226,6 +226,8 @@ Other references: [docs/gbrain-sync.md](docs/gbrain-sync.md) (sync-specific guid ## Platform notes +macOS and Linux get full support. Windows and Gemini models get minimal support: install and the core skills work, and nothing more is promised. See [support tiers](docs/support-tiers.md). + **macOS:** everything runs. With the [Aside](https://aside.com) browser (macOS 15+) open and signed in, the browser skills, `/make-pdf` and `/diagram` use it and your real sessions; otherwise they use the bundled browser `./setup` builds. gstack never installs Aside. **Linux:** everything runs on the bundled browser; Aside is macOS-only, so the readiness probe says `NEEDS_ASIDE: Linux` once and the skills use gstack's own Chromium. If Chromium installs but cannot launch because the host blocks unprivileged user namespaces (Ubuntu 24.04+ AppArmor default), set `GSTACK_CHROMIUM_NO_SANDBOX=1`. diff --git a/changelog.d/gsta244-support-tiers.md b/changelog.d/gsta244-support-tiers.md new file mode 100644 index 000000000..433228803 --- /dev/null +++ b/changelog.d/gsta244-support-tiers.md @@ -0,0 +1,5 @@ +**New page: [docs/support-tiers.md](docs/support-tiers.md) says what gstack supports fully and what it supports minimally.** macOS and Linux, with Claude and OpenAI models, get full support: the whole free suite and the paid evals. Windows (Git Bash or MSYS) and Gemini models get minimal support: install and the core skills (`/ship`, `/review`, `/qa-only`, `/investigate`, `/browse` on gstack's own browser) work without errors, checked by the required `windows-smoke` job on Windows and by hand or one cheap smoke run on Gemini. Windows-only and Gemini-only reports that don't break install, startup or a core workflow close as won't fix with a link to the page. + +### Documentation +- `docs/support-tiers.md`: the two tiers, what we stop doing, the Windows CI shape (`windows-smoke` required; the six-shard Windows suite nightly on main, non-blocking) and what doesn't change (eval models, the cross-family review voice). +- README's platform notes and AGENTS.md's platform support section link to it. diff --git a/docs/support-tiers.md b/docs/support-tiers.md new file mode 100644 index 000000000..f8390d32f --- /dev/null +++ b/docs/support-tiers.md @@ -0,0 +1,31 @@ +# Support tiers + +gstack has two support tiers. Full support gets the whole test suite, paid evals and new work. Minimal support means gstack is not totally broken, and nothing more. Garry Tan set this on 2026-11-01: "we don't want it to be totally broken, but we just don't need to invest that much into it." + +## Full support + +- **Operating systems:** macOS and Linux. +- **Models:** Claude and OpenAI models, both as the host agent and as a reviewer. +- **Testing:** the full free suite and the paid evals. + +## Minimal support + +- **Windows** (Git Bash or MSYS): with a default Git for Windows install, `./setup` installs, and the core skills start without errors. The core skills are `/ship`, `/review`, `/qa-only`, `/investigate` and `/browse` on gstack's own browser. One required CI job, `windows-smoke`, checks this on every pull request. +- **Gemini models:** the core workflows run to the end without errors when Gemini is the host agent or a reviewer. We check this by hand or with one cheap smoke run, not with an eval cell. + +That is the whole promise. Other skills, optional parts such as `/cso`'s native helper, non-default shell settings and speed are not covered. + +## What we stop doing + +- No Windows-only or Gemini-only features, parity work, tuning or polish. +- No new Windows or Gemini CI jobs or eval cells. Windows CI tuning stops. +- A Windows-only or Gemini-only report that doesn't break install, startup or a core workflow closes as won't fix ([triage rules](triage.md#closing-an-issue)), with a link to this page. A report that does break one of them gets a small fix. + +## Windows CI + +- `windows-smoke` is a required check on pull requests. +- The six-shard Windows free suite (the `Windows Free Tests` workflow) runs nightly on main only and doesn't block merges. A red nightly run gets a fix only when it shows an install, startup or core-workflow break. + +## What doesn't change + +These tiers don't change which models gstack's own evals test, or which cross-family review voice gstack uses.