Add the Converge step to the audit procedure - #239
Merged
Conversation
Document the convergence model: the audit is read-only, but its drift is resolved by the agent applying fixes via a pull request on the target repo, driving the Copilot review to green, and holding the merge for the maintainer - one focused PR per drift class, with systemic drift fixed in the hub. Supersedes the hub-only-reports framing. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Signed-off-by: Pieter Viljoen <ptr727@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the audit playbook (AUDIT.md) to explicitly codify a post-audit convergence step: resolving detected drift by applying fixes in the target repository via focused PRs, driving Copilot review to green, and holding merge for maintainer approval.
Changes:
- Adds a new section "10. Converge - Apply the Fixes" describing the convergence loop and merge gate expectations.
- Documents the intended operational model: hub audits/reporting plus agent-applied fixes via target-repo PRs, with systemic drift addressed in the hub (spec/rules/checks).
Distinguish the read-only audit-and-report phase (sections 1-9) from the separate Converge phase that applies fixes, and point the Copilot review runbook reference at .github/copilot-instructions.md. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Signed-off-by: Pieter Viljoen <ptr727@users.noreply.github.com>
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.
Directive 2a: codify the convergence pattern as AUDIT.md section 10. The audit is read-only, but drift is resolved by the agent applying fixes via a PR on the target repo, driving the Copilot review to green, and holding the merge for the maintainer - one focused PR per drift class, cross-referencing the finding; systemic/fleet-wide drift is fixed in the hub (spec/rule/machine-check), not hand-patched per repo. Supersedes the earlier hub-only-reports framing.
🤖 Generated with Claude Code