Visitar URL original
Point the Copilot Runbook's Coverage and Merge Rules to Their Canonical Homes by ptr727 · Pull Request #4169 · ptr727/ProjectTemplate · GitHub
Skip to content

Point the Copilot Runbook's Coverage and Merge Rules to Their Canonical Homes - #4169

Merged
ptr727 merged 4 commits into
developfrom
burndown/copilot-runbook-tracker
Nov 13, 2026
Merged

ptr727 merged 4 commits into
developfrom
burndown/copilot-runbook-tracker

Conversation

@ptr727

@ptr727 ptr727 commented Nov 13, 2026 •

Copy link
Copy Markdown
Owner

Disposes of both findings the per-unit tracker for .github/copilot-instructions.md "GitHub Copilot Review Runbook" lists.

Closes on promotion: #4099

Tracked Findings

  • Point to the canonical file-table coverage rules instead of restating them. Fixed. The runbook's completion paragraph restated, sentence for sentence, the file-table coverage rules that GOVERNANCE.md "PR Review Etiquette" holds. That breaks the file's own rule, "Do not duplicate rules from AGENTS.md, GOVERNANCE.md, CODESTYLE.md, or WORKFLOW.md here." Class sweep: the local review pass found that the rest of that paragraph also restated "PR Review Etiquette" and the pr-review-conduct Merge Gate (head and full-diff coverage, the merge-blocking cases, the local-pass reading, the default review policy, re-running the loop, and not trusting mergeStateStatus: CLEAN). So the paragraph now points to those two homes, which between them state every rule it held. It keeps its two sentences naming partial coverage, a refusal, and an uncovered head as merge blockers. test_the_runbook_names_partial_coverage_as_a_state_that_blocks_a_merge in tests/test_pr_review.py pins those on purpose, and they state the Merge Gate's blockers rather than a GOVERNANCE.md rule. A sentence-level comparison of the runbook section against GOVERNANCE.md found 7 verbatim sentences before this change and none after it. The review-effort paragraph after it is left alone, since GOVERNANCE.md does not state its rules.
  • A file table should not omit a renamed file with no changed line. Declined, since it asks to reverse a tested design rather than correct a misdescription. Hold Local Coverage Against File Tables and Count Green Dependabot Bumps on a Promotion #4047 added RENAMED to the set a file table may leave out on purpose, and tests/test_pr_review.py pins it: test_a_lineless_rename_is_left_out expects coverage=table for a round whose table leaves out a RENAMED file with 0 additions and 0 deletions, and test_a_rename_with_a_changed_line_is_not_left_out expects coverage=none once the rename changes a line. The text describes that behavior accurately. After the first fix, the sentence lives in GOVERNANCE.md "PR Review Etiquette" and the pr-review-conduct Merge Gate, both of which match the tested behavior, so no text changes for it.

🤖 Generated with Claude Code

ptr727 and others added 2 commits November 13, 2026 11:23
The runbook restated the file-table coverage rules that GOVERNANCE.md
"PR Review Etiquette" already holds, against this file's own rule not to
duplicate GOVERNANCE.md. Keep the completion and merge-blocking text and
point to the canonical rule for when a statement or table shows coverage.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The rest of the runbook's completion paragraph restated GOVERNANCE.md
"PR Review Etiquette" and the pr-review-conduct Merge Gate as well. Point
to both rather than keep a second copy that drifts.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI lite review requested due to automatic review settings November 13, 2026 19:27
@ptr727

ptr727 commented Nov 13, 2026

Copy link
Copy Markdown
Owner Author

A recorded local strict-review pass covers head c19a2dd369ff1a9c099d8c0aa18ee0056a3e2876, the content this pull request carries at that commit against develop, and it recorded 0 findings.

@coderabbitai

coderabbitai Bot commented Nov 13, 2026 •

Copy link
Copy Markdown

Warning

Review limit reached

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

Next included review available in 52 minutes.

Check out review usage here.

View limit details

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

Learn how review limits work.

Review configuration:

Run configuration

Commits

Reviewing files that changed from the base of the PR and between 8dbea41 and 7aaf2f4.

Files selected for processing: 1

  • .github/copilot-instructions.md
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

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

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

No active review issues remain, and the changes centralize duplicated guidance by referencing the canonical governance and merge-gate sources while preserving Copilot-specific instructions.

No open issues 🎉

What changed in this PR

This PR removes duplicated review coverage and merge-gate rules from the Copilot runbook by directing readers to their canonical sources.

Changes:

  • Points review coverage guidance to GOVERNANCE.md.
  • Points merge-blocking conditions to the pr-review-conduct Skill's Merge Gate.
  • Preserves Copilot-specific review-effort guidance.
File Description
.github/​copilot-instructions.md Replaces duplicated review coverage and merge rules with references to their canonical governance and skill sources.

Review effort: Lite

ptr727 and others added 2 commits November 13, 2026 11:45
test_the_runbook_names_partial_coverage_as_a_state_that_blocks_a_merge
pins these two sentences on purpose, since a verify step reading the
commit alone once let partial rounds merge. They state the Merge Gate's
blockers rather than a GOVERNANCE.md rule, so they stay.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The kept blocker sentences read as rules with no exceptions once the
paragraph that qualified them went. Point to the Merge Gate for those
exceptions too, such as an excluded-files refusal and the promotion cases.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ptr727

ptr727 commented Nov 13, 2026

Copy link
Copy Markdown
Owner Author

A recorded local strict-review pass covers head 7aaf2f4c865d520490b3b9374034cfa120a96b1f, the content this pull request carries at that commit against develop, and it recorded 0 findings.

@codecov

codecov Bot commented Nov 13, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 76.69%. Comparing base (b38e084) to head (7aaf2f4).
⚠️ Report is 198 commits behind head on develop.

Additional details and impacted files
@@             Coverage Diff             @@
##           develop    #4169      +/-   ##
===========================================
- Coverage    81.60%   76.69%   -4.92%     
===========================================
  Files           26       41      +15     
  Lines         9070    14300    +5230     
===========================================
+ Hits          7402    10967    +3565     
- Misses        1668     3333    +1665     
Flag Coverage Δ
python-3.13 76.69% <ø> (-4.92%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@ptr727

ptr727 commented Nov 13, 2026

Copy link
Copy Markdown
Owner Author

@coderabbitai review

@ptr727

ptr727 commented Nov 13, 2026

Copy link
Copy Markdown
Owner Author

/review

@coderabbitai

coderabbitai Bot commented Nov 13, 2026 •

Copy link
Copy Markdown
Action not completed

Review rate limited.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@ptr727
ptr727 merged commit 8cf9423 into develop Nov 13, 2026
13 checks passed
@ptr727
ptr727 deleted the burndown/copilot-runbook-tracker branch November 13, 2026 20:04
ptr727 added a commit that referenced this pull request Nov 13, 2026
… Rules (#4189)

## Summary

Promotes the backlog-burndown rounds and changes from other hub sessions
from `develop` to `main`.

- Hooks and the prose gate: #4132, #4134, #4136, #4145, #4152, #4184.
The Husky hook reads its path list once and diffs a merge against
`MERGE_HEAD`. Interrupts re-raise their signal, a Markdown code span
reads as quoted data, and the gate picks a commit's diff base and
recognizes a conflicted promotion's branch cut from `main`.
- Procedures and carried rules: #4133, #4139, #4141, #4149, #4166,
#4177, #4179, #4183, #4185. Resync, audit and check-this-repo procedure
gaps, code style and shell interrupt rules, review-loop gaps across four
skills, the context and delegation section of `AGENTS.md`, question
rules in governance, the promotion line in pull request bodies,
closing-keyword behavior on promotion, and the history-rewrite premise.
- Review and cleanup tooling: #4138, #4148, #4154, #4156, #4157, #4163,
#4164, #4168, #4174, #4180. Cleanliness reads, parked handoffs, the
backlog report's JSON output, exact inline script pins, trusted inputs,
env-file includes, the bounded review wait, side-reviewer matching, and
a Copilot billing-failure notice read as a refusal.
- Workflow and runbook contract: #4153, #4155, #4169, #4171, #4178,
#4182. The runtime-secrets check, a registry entry and spec references,
the Copilot runbook pointers, credential-free checkout steps, and the
deploy-key and runner wording.
- From other hub sessions: #4159 (a repository's own .NET line under a
fleet default), #4161 (the 1Password CLI as an optional host tool),
#4162 (Codex's Windows installer and one managed opencode copy). These
carry no promotion line.

#4182 carries no promotion line by design, and #4175 holds the split-out
part of #4057's scope. Both #1448 and #4175 stay open.

Fixes #1071
Fixes #1154
Fixes #1391
Fixes #1471
Fixes #1594
Fixes #1620
Fixes #1627
Fixes #1650
Fixes #1801
Fixes #2853
Fixes #3620
Fixes #3668
Fixes #3697
Fixes #3766
Fixes #3787
Fixes #3837
Fixes #3840
Fixes #3842
Fixes #3844
Fixes #3865
Fixes #3882
Fixes #3890
Fixes #3894
Fixes #3912
Fixes #3916
Fixes #3954
Fixes #4014
Fixes #4015
Fixes #4016
Fixes #4043
Fixes #4050
Fixes #4057
Fixes #4058
Fixes #4062
Fixes #4084
Fixes #4097
Fixes #4098
Fixes #4099
Fixes #4104
Fixes #4108
Fixes #4114
Fixes #4115
Fixes #4117
Fixes #4118
Fixes #4119
Fixes #4121
Fixes #4122
Fixes #4123
Fixes #4131
Fixes #4135
Fixes #4140
Fixes #4142
Fixes #4143
Fixes #4144
Fixes #4151

🤖 Generated with [Claude Code](https://claude.com/claude-code)
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.

2 participants