Repository navigation
docs: add git workflow hygiene section - #111
Merged
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Project
Docs —
proposals/ROADMAP.md. No list entry or payload change.Why it belongs
Adds a concise Git workflow hygiene section capturing four operational lessons from the
contract-monitor wave (PRs #105–#110) that were previously only implicit:
gh pr merge N --squash --delete-branch) — one commit per PR, remote branches self-clean.mainhas no required status checks, so GitHub declines--autoon already-mergeable PRs(
Pull request is in clean status (enablePullRequestAutoMerge)); workflow-created PRs must be merged with a directgh pr merge N --squash --delete-branch.mainrequires verified signatures (required_signatures: true);unsigned direct pushes are rejected (GH006). Never push to
maindirectly.workflowscope is refused for.github/workflows/**.Placed next to the existing "Solo evaluation branch policy" section, matching the file's terse reference style.
Quality evidence
proposals/ROADMAP.md+15 lines, single section + a dated implementation-record line.--autodeclination onrequired_signatures-only
main; GH006 rejection of unsigned direct pushes; workflow-scope token requirement).Checklist
CRITERIA.md/ contribution guidance before proposing.advisory-baseline.jsonorrepo-exceptions.json.uv run pytest/ lint as applicable).