chore: remove cspell, add USA English rule (#152)

Replace the cspell library, config, and CI job with a short always-on
"USA English" rule under conventions. The custom word list had grown
into hundreds of brand names; a single human-readable rule captures the
intent more cheaply.

https://claude.ai/code/session_0199PDuVe8AzYH4Pgt6Guk9z

Co-authored-by: Claude <noreply@anthropic.com>

Author: stijnvanhulle

.github/workflows/pr.yml

@@ -115,33 +115,6 @@ jobs:
           NODE_OPTIONS: '--max_old_space_size=4096'
         run: pnpm run lint
 
-  spellcheck:
-    name: Spell Check
-    timeout-minutes: 15
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-    if: github.actor != 'github-actions[bot]'
-    steps:
-      - name: Check out code
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-        with:
-          fetch-depth: 0
-          persist-credentials: false
-
-      - name: Setup Tools
-        uses: ./.github/setup
-        with:
-          node-version: '22'
-
-      - name: Spell Check
-        uses: streetsidesoftware/cspell-action@9c7145a5e625e30cb68f6932b379e17eb024d974 # v8
-        with:
-          files: |
-            **/*.{ts,md}
-          suggestions: 'true'
-          config: 'cspell.json'
-
   prerelease:
     name: Prerelease
     timeout-minutes: 15

AGENTS.md

@@ -99,6 +99,7 @@ that loads `SKILL.md` folders also picks them up on demand.
 - [markdown](.agents/skills/conventions/rules/markdown.md) - Markdown structure. The `documentation` and `humanizer` skills cover voice and SEO.
 - [security](.agents/skills/conventions/rules/security.md) - Secrets, input validation at trust boundaries, safe shell use.
 - [testing](.agents/skills/conventions/rules/testing.md) - Vitest patterns and what to test.
+- [usa-english](.agents/skills/conventions/rules/usa-english.md) - Write code, comments, and docs in USA English spellings.
 
 <skills>
 

CONTRIBUTING.md

@@ -53,7 +53,6 @@ Publishable code lives in `packages/`, internal helpers that never ship live in
 | [Vitest](https://vitest.dev/) | Testing |
 | [oxlint](https://oxc.rs/docs/guide/usage/linter.html) | Linter |
 | [oxfmt](https://github.com/oxc-project/oxfmt) | Formatter |
-| [CSpell](https://cspell.org/) | Spell checker |
 | [Changesets](https://github.com/changesets/changesets) | Versioning and changelogs |
 | [GitHub Actions](https://github.com/features/actions) | CI/CD |
 
@@ -69,7 +68,6 @@ pnpm typecheck      # Type-check all packages
 pnpm lint           # Lint with oxlint
 pnpm lint:fix       # Lint and auto-fix
 pnpm format         # Format with oxfmt
-pnpm lint:spell     # Spell-check .ts and .md files
 pnpm changeset      # Create a changeset
 pnpm upgrade        # Bump dependencies with taze
 ```
@@ -111,5 +109,3 @@ pnpm changeset
 ```
 
 Pick the packages you changed, choose the bump (patch for fixes, minor for features, major for breaking changes), and write a short summary aimed at users. Commit the generated file under `.changeset/`. Docs-only or internal changes that touch no published package do not need one.
-
-Spell-check false positives: fix typos in code, or add technical terms and proper nouns to the `words` array in `cspell.json`.

cspell.json

@@ -24,7 +24,6 @@
     "graph": "npx nx graph ",
     "lint": "oxlint -c oxlint.config.ts ./packages",
     "lint:fix": "oxlint -c oxlint.config.ts --fix ./packages",
-    "lint:spell": "cspell \"**/*.{ts,md}\" --config ./cspell.json --no-progress",
     "release": "changeset publish",
     "start": "turbo run start --filter=./packages/* --filter=./internals/*",
     "test": "vitest run --config ./configs/vitest.config.ts",
@@ -41,7 +40,6 @@
     "@vitest/coverage-v8": "catalog:",
     "@vitest/ui": "catalog:",
     "bun-types": "^1.3.14",
-    "cspell": "^10.0.0",
     "oxfmt": "catalog:",
     "oxlint": "catalog:",
     "size-limit": "catalog:",