From 00efd3cc0e9ec2f2a1eb0f65b5572f749c5efd9d Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sat, 6 Jun 2026 06:47:10 +0000
Subject: [PATCH] docs: fix AGENTS.md spelling and note spellcheck before PR

Co-authored-by: Mike Farah <mikefarah@users.noreply.github.com>
---
 AGENTS.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/AGENTS.md b/AGENTS.md
index 7b6919d7..9ea7dd42 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -2,6 +2,14 @@
 
 See [agents.md](./agents.md) for contributor workflow (formatting, testing patterns, adding encoders/decoders).
 
+Always run the spellcheck before raising a PR:
+
+```bash
+bash scripts/spelling.sh
+```
+
+This is also included in the full CI pipeline via `make local test`.
+
 ## Cursor Cloud specific instructions
 
 ### Overview
@@ -39,7 +47,7 @@ export PATH="$HOME/go/bin:$PATH"
 
 `make local build` runs the full CI chain (format → spelling → gosec → lint → unit tests → build → acceptance). For a faster loop, build with `go build -o yq .` and run `bash scripts/acceptance.sh`.
 
-### Gotchas
+### Caveats
 
 - **`make` without `local`** tries Docker/Podman (`Dockerfile.dev`). In Cloud Agent VMs without Docker, always prefix with `make local`.
 - **Spelling step** uses `npx cspell` and may download cspell on first run (network required).