Skip to content

Commit rules in the repository; CI checks every pull request's own commits - #111

Merged
GonzRon merged 2 commits into
masterfrom
chore-commit-hygiene
Oct 5, 2026
Merged

GonzRon merged 2 commits into
masterfrom
chore-commit-hygiene

Conversation

@GonzRon

@GonzRon GonzRon commented Oct 5, 2026

Copy link
Copy Markdown
Owner

The 1.8.0 release's hygiene check (R6) found that 39 of the 79 commits merged since servicetag-v1.7.0 were authored and committed under a tool's identity with attribution trailers, and two merge subjects named tool branches. The owner ruled: accept the history, record it in the release evidence, and fix the cause going forward. This is that fix.

  • CLAUDE.md (50 lines) and a one-line AGENTS.md: the commit identity and subject-only rule, pull-request branch naming and merging, the gates CI cannot run, what never goes in the repository, and pointers to the versioning policy, the release runbook, the planning policy, the localization rules and the roadmap issue. Every session that clones the repository reads it.
  • tools/check-commit-hygiene.sh and a hygiene CI job on pull requests: each of the PR's own commits must be authored and committed by the repository owner (GitHub as committer only on two-parent merges), carry no attribution line and no body, and no merge subject may name a tool branch; R6's content greps (e-mail, home path, foreign device serial) run over the added lines. Proven on three ranges: v1.6.0..v1.7.0 passes (253 commits), v1.7.0.. the pre-release master fails with 156 violations for the right reasons, this PR's own commits pass.
  • One sentence in docs/release-proofs.md R6 saying so.

Owner follow-up on GitHub: make hygiene a required check in branch protection.

@GonzRon
GonzRon merged commit cdfdc87 into master Oct 5, 2026
10 checks passed
@GonzRon
GonzRon deleted the chore-commit-hygiene branch October 7, 2026 01:18
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