Skip to content

docs(agents): correct the Validation topology in go-template AGENTS.md#183

Draft
devantler wants to merge 2 commits into
mainfrom
claude/agents-validation-topology-181
Draft

docs(agents): correct the Validation topology in go-template AGENTS.md#183
devantler wants to merge 2 commits into
mainfrom
claude/agents-validation-topology-181

Conversation

@devantler

Copy link
Copy Markdown
Contributor

🤖 Generated by the Daily AI Engineer

Why

AGENTS.md described a Go CI gate that does not exist — a "Require workflows to pass before merging for Go" ruleset injecting a validate-go-project workflow from the archived reusable-workflows repo. Agents and contributors follow AGENTS.md as canonical, so a wrong validation topology misleads every future change here.

What

Verified the live topology against a real .go-touching PR's check set and the repo's rulesets, then rewrote the Validation section (and its two dependent references) to describe the gates that actually run — CI - Required Checks, Validate Scaffold, and the org CodeQL/zizmor/Dependency-Review rulesets — and to note the full Go gate runs in generated projects, not this template. Docs-only.

Fixes #181

AGENTS.md claimed a repository ruleset "Require workflows to pass before merging
for Go" injects the archived devantler-tech/reusable-workflows validate-go-project
workflow (go build/test/lint/dead-code/MegaLinter/coverage) on every PR and the
merge queue. Verified live against a real .go-touching PR's check set (#163) and
the repo's rulesets: no such ruleset exists, and no validate-go-project workflow
runs on this template's CI at all. The real gates are CI - Required Checks (a
trivial aggregator), Validate Scaffold, and the org CodeQL / zizmor / Dependency
Review rulesets; the full Go gate runs in generated projects, not the template.
Rewrite the Validation section and the two dependent references (toolchain-floor
note and the Maintenance validate-before-PR line) to match, dropping the stale
reusable-workflows reference.

Fixes #181

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@devantler

Copy link
Copy Markdown
Contributor Author

🤖 Generated by the Daily AI Engineer

@codex review

@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: 702073cb62

ℹ️ 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
Comment thread AGENTS.md Outdated
Comment thread AGENTS.md Outdated
Correct three over-broad claims from the first pass: the template's CI is not
free of Go build/test (the Validate Scaffold job builds and tests a renamed
scaffold copy — there is just no dedicated lint/coverage gate); Validate Scaffold
is pull_request-only, so the merge queue is gated by ci.yaml's CI - Required
Checks, not Validate Scaffold; and generated projects gate Go via org-injected
ruleset workflows (devantler-tech) or a manually-replaced ci.yaml (outside the
org), not via the scaffolded ci.yaml aggregator.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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.

AGENTS.md Validation section describes a ruleset and repo that no longer exist

1 participant