Skip to content

docs: record the declined modernizer analyzer in both guidance files - #451

Merged
bomly-guy merged 2 commits into
mainfrom
claude/record-declined-modernizer
Sep 12, 2026
Merged

bomly-guy merged 2 commits into
mainfrom
claude/record-declined-modernizer

Conversation

@bomly-guy

Copy link
Copy Markdown
Collaborator

The CLI half of "the two repos should agree on embedlit". The SDK half is bomly-dev/bomly-sdk#82, which reverts 43 hunks.

Why a doc change is the deliverable

The revert makes the two repositories agree today. Nothing keeps them agreeing tomorrow:

  • embedlit is behaviour-identical, so tests do not object.
  • gorelease is indifferent, so the API gate does not object.
  • The reasoning lived in a commit message, which is scrollback.

The next go fix ./... in either repo proposes every hunk again — 119 here, 43 there — and whoever runs it has no way to know the question was already settled.

What it says

The flag (go fix -embedlit=false ./...) and the reason: Coordinates is a named identity concept under ADR-0041 and dev-docs/MODELS.md, and the wrapper at a construction site is what keeps the identity visible where a package is built.

It also records that the disagreement already happened once and what it cost, so the note reads as a decision with a price rather than a preference.

Both CLAUDE.md and AGENTS.md get it, since this repo maintains them as copies.

make verify green. [skip release] — documentation only.

🤖 Generated with Claude Code

The Go 1.27 modernizer pass here rejected the embedlit analyzer; the
SDK's pass applied it. The same question went on record with two
different answers, and undoing it cost 43 hunks in the SDK.

Nothing mechanical objects to embedlit -- it is behaviour-identical and
gorelease is indifferent -- so the only thing that can keep the two
repositories agreeing is a written reason where the next run will look.
Running `go fix ./...` without the flag proposes all 119 hunks here
again, silently.

Both CLAUDE.md and AGENTS.md carry it, since they are maintained as
copies of each other, and bomly-sdk's AGENTS.md carries the matching
note.

[skip release]

Co-Authored-By: Claude Opus 5 <[email protected]>
@coderabbitai

coderabbitai Bot commented Sep 12, 2026 •

Copy link
Copy Markdown
Contributor

Warning

Review limit reached

Next included review available in 49 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Advanced

Run ID: 022c0249-b077-4785-ade0-0807b24bc998

📥 Commits

Reviewing files that changed from the base of the PR and between 307ac5c and 9a75b13.

📒 Files selected for processing (2)
  • AGENTS.md
  • CLAUDE.md

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

github-actions Bot commented Sep 12, 2026 •

Copy link
Copy Markdown
Contributor

Bomly Diff Summary

Compared 307ac5c3beb583bcf0670d49bcd8e4efd85295a3 to 9a75b133e23c9fd45a71a3c1d1360ffa458a5a32.

Overview

Status Manifests Dependencies Findings Duration
✅ Pass +0 / ~0 / -0 0 added / 0 version changed / 0 detail changes / 0 removed 0 introduced / 0 persisted / 0 resolved 1m 22s

Dependency Changes

✅ No dependency changes.

Vulnerabilities

✅ No vulnerability changes.

License Changes

✅ No license changes.

Project Posture

✅ No project posture changes (--matchers +scorecard was not selected).

Policy Findings

✅ No policy differences were identified.

@chatgpt-codex-connector chatgpt-codex-connector 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.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e4d2a5d7ae

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread AGENTS.md Outdated
Codex checked the merged pass and found my note wrong. #448 ran
`go fix -embedlit=false -omitzero=false -stringsbuilder=false ./...` and
I recorded one of the three, so an agent following the note would have
reintroduced the other two -- a note that is worse than none, because it
looks authoritative.

omitzero is the one that matters. It drops omitempty from struct-valued
JSON fields in golden- and schema-backed output types. The bytes do not
move, so no test, linter or API gate objects -- and the tag is the
published schema, so a consumer generating one by reflection starts
reading the field as required. The SDK took that rewrite in its own pass
and spent four review rounds undoing the consequences. The same analyzer
was one command away from doing it here.

Also says what `go fix` does: it applies in place, and `-diff` prints
instead. A reader who assumed it previewed would find out afterwards.

Co-Authored-By: Claude Opus 5 <[email protected]>
@bomly-guy
bomly-guy merged commit abcf4a9 into main Sep 12, 2026
16 checks passed
@bomly-guy
bomly-guy deleted the claude/record-declined-modernizer branch September 12, 2026 07:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant