Skip to content

docs(#206): update stale Go 1.21 references to 1.22#207

Open
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/206-fix-go-version-docs
Open

docs(#206): update stale Go 1.21 references to 1.22#207
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/206-fix-go-version-docs

Conversation

@fullsend-ai-coder

Copy link
Copy Markdown

go.mod was bumped from 1.21 to 1.22.0 but documentation files were not updated. Fixed all five stale references across CLAUDE.md, AGENTS.md, skills/ci-cd-quirks/SKILL.md, and skills/debugging-cli-locally/SKILL.md to match the current go.mod directive. Also updated the debugging skill's advice since local vs CI Go version mismatch is no longer the primary concern — the Dockerfile UBI9 go-toolset version is.


Closes #206

Post-script verification

  • Branch is not main/master (agent/206-fix-go-version-docs)
  • Secret scan passed (gitleaks — 15c51b97cda425dbff6d8556004017266bb63666..HEAD)
  • Pre-commit hooks passed (authoritative run on runner)
  • Tests ran inside sandbox

go.mod was bumped from 1.21 to 1.22.0 but documentation files
were not updated. Fixed all five stale references across
CLAUDE.md, AGENTS.md, skills/ci-cd-quirks/SKILL.md, and
skills/debugging-cli-locally/SKILL.md to match the current
go.mod directive. Also updated the debugging skill's advice
since local vs CI Go version mismatch is no longer the
primary concern — the Dockerfile UBI9 go-toolset version is.

Closes #206
@fullsend-ai-review

fullsend-ai-review Bot commented Jun 26, 2026

Copy link
Copy Markdown

🤖 Finished Review · ✅ Success · Started 6:31 PM UTC · Completed 6:39 PM UTC
Commit: ec21706 · View workflow run →

@fullsend-ai-review

Copy link
Copy Markdown

Review

Findings

Medium

  • [protected-path] AGENTS.md, CLAUDE.md, skills/ci-cd-quirks/SKILL.md, skills/debugging-cli-locally/SKILL.md — All four files modified in this PR are under protected paths (AGENTS.md, CLAUDE.md, skills/). The PR links to issue Fix stale Go version references in CLAUDE.md, AGENTS.md, and skill files #206 and the description explains the rationale (updating stale Go version references to match go.mod 1.22.0). Human approval is always required for protected-path changes, regardless of context.

Low

  • [technical accuracy in documentation] skills/debugging-cli-locally/SKILL.md:107 — After the PR, the Cause column reads "Go version mismatch (local 1.22, go.mod 1.22)" but both versions are identical, so the word "mismatch" is self-contradictory. The actual mismatch is between local/CI Go 1.22 and the Dockerfile UBI9 go-toolset which may ship an older version. The cause text and remediation ("Check Dockerfile UBI9 go-toolset version") are internally inconsistent with the stated cause.

  • [documentation consistency] skills/ci-cd-quirks/SKILL.md:22 — The consequence text says "Stick to Go 1.22 language features unless go.mod is bumped" which is self-consistent with go.mod being 1.22. However, the same sentence warns that UBI9 may ship an older Go, which means Go 1.22 features could still fail in the container — contradicting the advice to freely use 1.22 features.


Labels: PR exclusively updates documentation files to fix stale Go version references.

@fullsend-ai-review fullsend-ai-review Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

See the review comment for full details.

| `GITHUB_TOKEN must be set` | Env var not exported | `export GITHUB_TOKEN="$YOUR_TOKEN"` |
| `golangci-lint` ignores config | Config is `.golang-ci.yml` not `.golangci.yml` | Use `make lint` or `-c .golang-ci.yml` |
| Tests pass locally, fail in CI | Go version mismatch (local 1.22, go.mod 1.21) | Avoid 1.22-only features |
| Tests pass locally, fail in CI | Go version mismatch (local 1.22, go.mod 1.22) | Check Dockerfile UBI9 go-toolset version |

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[low] technical accuracy in documentation

After the PR, the Cause column reads 'Go version mismatch (local 1.22, go.mod 1.22)' but both versions are identical, so 'mismatch' is self-contradictory. The actual mismatch is between local/CI Go 1.22 and the Dockerfile UBI9 go-toolset which may ship an older version.

Suggested fix: Change the Cause column to something like 'Go version mismatch (local/CI 1.22, UBI9 container may differ)' to accurately describe where the mismatch occurs.

| Dockerfile | Varies | UBI9 `go-toolset` (version depends on tag) |

**Consequence**: Code may compile locally with Go 1.22 features but fail in the container if the UBI9 image ships an older Go. Stick to Go 1.21 language features unless `go.mod` is bumped.
**Consequence**: Code may compile locally with Go 1.22 features but fail in the container if the UBI9 image ships an older Go. Stick to Go 1.22 language features unless `go.mod` is bumped.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[low] documentation consistency

The consequence text says 'Stick to Go 1.22 language features unless go.mod is bumped' which is self-consistent, but the same sentence warns UBI9 may ship an older Go — meaning Go 1.22 features could still fail in the container, contradicting the advice.

Suggested fix: Clarify that while go.mod permits 1.22 features, developers should verify the UBI9 go-toolset version supports them before relying on 1.22-specific syntax.

@fullsend-ai-review fullsend-ai-review Bot added requires-manual-review Review requires human judgment documentation Improvements or additions to documentation labels Jun 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation requires-manual-review Review requires human judgment < 1 min

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Fix stale Go version references in CLAUDE.md, AGENTS.md, and skill files

0 participants