From 90a332805eac451b05a0e6e1d8d5b36815a03c9e Mon Sep 17 00:00:00 2001
From: Dina Berry <diberry@microsoft.com>
Date: Mon, 9 Mar 2026 07:11:49 -0700
Subject: [PATCH] docs: align Node.js version to >=20 LTS across all docs

package.json engines requires >=20.0.0 but docs referenced v22 in 5
places. Updated all to Node.js 20+ (LTS) with nvm --lts install
commands instead of pinned versions.

Files: docs/README.md, guide.md, troubleshooting.md, vscode.md

Closes #302

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 docs/README.md                                     | 2 +-
 docs/src/content/docs/features/vscode.md           | 2 +-
 docs/src/content/docs/guide.md                     | 4 ++--
 docs/src/content/docs/scenarios/troubleshooting.md | 8 ++++----
 4 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/docs/README.md b/docs/README.md
index 42a2e4d1f..b48dc5eb3 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -4,7 +4,7 @@ The documentation site for Squad, built with [Astro](https://astro.build/), [Tai
 
 ## Prerequisites
 
-- Node.js 22+
+- Node.js 20+ (LTS)
 - Run `npm install` from the `docs/` directory
 
 ## Commands
diff --git a/docs/src/content/docs/features/vscode.md b/docs/src/content/docs/features/vscode.md
index fe3bebb12..b928e854b 100644
--- a/docs/src/content/docs/features/vscode.md
+++ b/docs/src/content/docs/features/vscode.md
@@ -16,7 +16,7 @@ This guide covers what's different, what's the same, and when to use CLI vs VS C
 - **VS Code** — Latest version
 - **GitHub Copilot extension** — `GitHub.copilot` (installed, authenticated)
 - **Workspace trust** — Your workspace must be trusted (VS Code security)
-- **Node.js 22+** — If running CLI to initialize Squad
+- **Node.js 20+ (LTS)** — If running CLI to initialize Squad
 - **Squad installed** — Either in the repo already (from CLI), or initialized fresh via agent selection
 
 ### Initial Setup
diff --git a/docs/src/content/docs/guide.md b/docs/src/content/docs/guide.md
index c13fdb245..bd7842423 100644
--- a/docs/src/content/docs/guide.md
+++ b/docs/src/content/docs/guide.md
@@ -28,7 +28,7 @@ npx github:bradygaster/squad
 ```
 
 **Requirements:**
-- Node.js 22+
+- Node.js 20+ (LTS)
 - GitHub Copilot (CLI, VS Code, Visual Studio, or Coding Agent)
 - A git repository (Squad stores team state in `.ai-team/`)
 - **`gh` CLI** — required for GitHub Issues, PRs, Ralph, and Project Boards ([install](https://cli.github.com/))
@@ -438,7 +438,7 @@ The coordinator uses 6.6% of its window. A 12-week veteran agent uses 4.5% — b
 - **Experimental** — file formats and APIs may change between versions.
 - **Silent success bug** — approximately 7–10% of background agent spawns complete all their file writes but return no text response. This is a platform-level issue. Squad detects it by checking the filesystem for work product and reports what it finds. Work is not lost.
 - **Platform latency** — response times depend on the Copilot platform. Complex multi-agent tasks take 40–60 seconds. Simple questions are answered in 2–3 seconds.
-- **Node 22+** — requires Node.js 22.0.0 or later.
+- **Node 20+** — requires a Node.js LTS release (v20.0.0 or later).
 - **GitHub Copilot required** — Squad works across Copilot hosts (CLI, VS Code, Visual Studio, Coding Agent).
 - **First session is the least capable** — agents improve as they accumulate history. Give it a few sessions before judging.
 
diff --git a/docs/src/content/docs/scenarios/troubleshooting.md b/docs/src/content/docs/scenarios/troubleshooting.md
index 89763683f..921dc617f 100644
--- a/docs/src/content/docs/scenarios/troubleshooting.md
+++ b/docs/src/content/docs/scenarios/troubleshooting.md
@@ -62,7 +62,7 @@ Common issues and fixes for Squad installation and usage.
 
 **Problem:** `npx github:bradygaster/squad` fails with an engine compatibility error, or Squad behaves unexpectedly.
 
-**Cause:** Squad requires Node.js 22.0.0 or later (enforced via `engines` in `package.json`).
+**Cause:** Squad requires Node.js 20.0.0 or later (LTS), enforced via `engines` in `package.json`.
 
 **Fix:**
 
@@ -70,9 +70,9 @@ Common issues and fixes for Squad installation and usage.
 node --version
 ```
 
-If below v22, upgrade Node.js:
-- **nvm (macOS/Linux):** `nvm install 22 && nvm use 22`
-- **nvm-windows:** `nvm install 22 && nvm use 22`
+If below v20, upgrade to the latest LTS:
+- **nvm (macOS/Linux):** `nvm install --lts && nvm use --lts`
+- **nvm-windows:** `nvm install lts && nvm use lts`
 - **Direct download:** [nodejs.org](https://nodejs.org/)
 
 ---