Skip to content

Add Makefile verify gate and post-merge Definition of Done for agents#13

Merged
disk0Dancer merged 3 commits into
mainfrom
chore/agent-dod-makefile
Jul 15, 2026
Merged

Add Makefile verify gate and post-merge Definition of Done for agents#13
disk0Dancer merged 3 commits into
mainfrom
chore/agent-dod-makefile

Conversation

@disk0Dancer

Copy link
Copy Markdown
Owner

Follow-up to #12 (which fixes the red CI on main caused by a non-hermetic test).

  • make verify mirrors the CI pipeline (fmt-check, vet, build, lint, go test -race) — single pre-push entry point for humans and coding agents.
  • AGENTS.md now requires: hermetic tests (explicit env for external tools like git), and post-merge verification — a task is not done until CI on main is green after merge (gh run list --branch main --workflow CI --limit 1).

This is the process half of the incident fix: PR #10 merged green-at-PR-time but broke main, and nobody circled back for two months.

🤖 Generated with Claude Code

- make verify mirrors the CI pipeline (fmt-check, vet, build, lint, race tests)
  and is the mandatory pre-push step in AGENTS.md.
- AGENTS.md: a task is not done until post-merge CI on main is green; tests
  must be hermetic (explicit env for external tools like git).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 15, 2026 15:07
@dosubot dosubot Bot added the size:M This PR changes 30-99 lines, ignoring generated files. label Jul 15, 2026

Copilot AI 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.

Pull request overview

Adds a local make verify gate intended to mirror CI checks, and updates AGENTS.md to formalize hermetic testing expectations plus a post-merge “Definition of Done” (main CI must be green after merge).

Changes:

  • Introduces a new Makefile with build/test/fmt/lint/vet targets and a verify meta-target.
  • Updates AGENTS.md to require running make verify before push and to require post-merge CI verification on main.
  • Documents hermetic test requirements (explicit environment for external tools like git).

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File Description
Makefile Adds standard Go developer/CI gate targets plus a verify entry point.
AGENTS.md Updates contribution workflow + DoD to require local verification, hermetic tests, and post-merge main CI checks.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread Makefile
@@ -0,0 +1,29 @@
GOFLAGS ?=
Comment thread Makefile
Comment on lines +28 to +29
# Full pre-push gate: mirrors the CI pipeline. Run before every push.
verify: fmt-check vet build lint test
Comment thread AGENTS.md
Comment on lines +21 to +22
- Run `make verify` (fmt-check + vet + build + lint + `go test -race`).
This mirrors the CI pipeline and is mandatory before every push.
Grigorii Churakov and others added 2 commits July 15, 2026 17:48
Mirrors AGENTS.md for Claude Code agents working in this repo: a task is
done only when post-merge CI on main is green; tests must pass on a bare
Linux runner (clean-HOME repro command included).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@disk0Dancer disk0Dancer merged commit 11a9e1e into main Jul 15, 2026
4 checks passed
@disk0Dancer disk0Dancer deleted the chore/agent-dod-makefile branch July 15, 2026 15:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:M This PR changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants