ci: add spellcheck workflow and contributor guidance

Author: CTOUT

.github/pull_request_template.md

@@ -51,3 +51,4 @@
 - [ ] `README.md` Repository Structure section updated if files were added or removed
 - [ ] `CHANGELOG.md` updated
 - [ ] `TODO.md` updated if a tracked item is completed or a new one added
+- [ ] `npm run spellcheck` passes

.github/workflows/spellcheck.yml

@@ -0,0 +1,54 @@
+name: Spellcheck
+
+on:
+  pull_request:
+    paths:
+      - "README.md"
+      - "CONTRIBUTING.md"
+      - "SECURITY.md"
+      - "CHANGELOG.md"
+      - "TODO.md"
+      - "docs/**"
+      - "cspell.json"
+      - "package.json"
+      - "package-lock.json"
+      - ".github/pull_request_template.md"
+      - ".github/workflows/spellcheck.yml"
+  push:
+    branches:
+      - main
+    paths:
+      - "README.md"
+      - "CONTRIBUTING.md"
+      - "SECURITY.md"
+      - "CHANGELOG.md"
+      - "TODO.md"
+      - "docs/**"
+      - "cspell.json"
+      - "package.json"
+      - "package-lock.json"
+      - ".github/pull_request_template.md"
+      - ".github/workflows/spellcheck.yml"
+
+permissions:
+  contents: read
+
+jobs:
+  spellcheck:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Setup Node.js
+        uses: actions/setup-node@60edb5dd545a775178f52524783378180af0d1f8 # v4.0.2
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run spellcheck
+        run: npm run spellcheck

CONTRIBUTING.md

@@ -8,6 +8,13 @@ A [pull request template](.github/pull_request_template.md) is pre-filled when y
 
 ## Pre-commit Checklist
 
+For documentation and repo-housekeeping changes, install the local tooling once and run:
+
+```powershell
+npm install
+npm run spellcheck
+```
+
 ### Agent changes (`reframe.agent.md`)
 
 - [ ] Instructions are clear, unambiguous, and internally consistent
@@ -40,6 +47,7 @@ A [pull request template](.github/pull_request_template.md) is pre-filled when y
 - [ ] `README.md` Repository Structure section reflects any new/removed files
 - [ ] `CHANGELOG.md` updated
 - [ ] `TODO.md` updated if a tracked item is completed or a new one is added
+- [ ] `npm run spellcheck` passes
 
 ---
 

README.md

@@ -43,7 +43,6 @@ Installs the agent to your VS Code user prompts folder so `@ReFrame` is availabl
 irm https://raw.githubusercontent.com/CTOUT/ReFrame/main/install.ps1 | iex
 ```
 
-> **Note:** User-level installs do not include the `knowledge/` files. Game-specific profiles (Tier 1) and per-engine JSON defaults (Tier 2) are unavailable — the agent falls back to its embedded engine defaults and web lookups. For full knowledge base coverage, use the repo-level install above.
 > **Note:** User-level installs do not include the `knowledge/` files. Game-specific profiles (Tier 1) and per-engine JSON defaults (Tier 2) are unavailable — the agent falls back to generic best-practice rules (Tier 3) and web lookups when needed. For full knowledge base coverage, use the repo-level install above.
 
 ### Manual install
@@ -143,7 +142,8 @@ ReFrame/
 │   │   ├── registry-analysis/      ← on-demand registry review
 │   │   └── system-scan/            ← hardware detection skill
 │   ├── workflows/
-│   │   └── release.yml             ← GitHub Actions release workflow
+│   │   ├── release.yml             ← GitHub Actions release workflow
+│   │   └── spellcheck.yml          ← Documentation spellcheck CI
 │   └── CODEOWNERS
 ├── .vscode/
 │   └── extensions.json
@@ -161,9 +161,12 @@ ReFrame/
 ├── CHANGELOG.md
 ├── CITATION.cff
 ├── CONTRIBUTING.md
+├── cspell.json
 ├── install.ps1
 ├── LICENSE
 ├── llms.txt                        ← AI crawler guidance
+├── package-lock.json
+├── package.json
 ├── README.md
 ├── SECURITY.md
 └── TODO.md
@@ -207,6 +210,13 @@ No. The agent works entirely offline using your local knowledge base and system
 
 See [CONTRIBUTING.md](CONTRIBUTING.md).
 
+For documentation and repo-housekeeping changes, run the spellcheck before opening a PR:
+
+```powershell
+npm install
+npm run spellcheck
+```
+
 ## Security
 
 See [SECURITY.md](SECURITY.md) for reporting vulnerabilities and installer verification guidance.