Skip to content

docs(governance): owner-action checklist (Tier 2)#41

Merged
jimCresswell merged 1 commit into
mainfrom
docs/repository-governance-checklist
Jun 18, 2026
Merged

docs(governance): owner-action checklist (Tier 2)#41
jimCresswell merged 1 commit into
mainfrom
docs/repository-governance-checklist

Conversation

@jimCresswell

Copy link
Copy Markdown
Contributor

What & why

Tier 2 (governance write-up). The audit_supply_chain self-check already landed; this is the remaining deliverable — the owner-action checklist for protections that can only be set in GitHub settings (I cannot change repo/org settings from code).

New canonical docs/repository-governance.md documents:

  • Already enforced by the main ruleset (verified live via the API): PR required, CodeQL code_quality required, no branch deletion, no force-push.
  • Owner actions outstanding, each closing a gap the in-repo gates structurally cannot:
    1. Add Quality gates + Secret scanning (gitleaks) to required status checks (biggest gap — there is no required_status_checks rule today, so main can go red and still merge).
    2. Give the release PR a PAT/App token so ci.yml runs on it.
    3. Enable the GitHub Code Quality org preview.
    4. Add a v* tag ruleset (none exists today).

Linked from the README so an adopter works through it once per repo.

Verification

  • Current ruleset state checked against the live GitHub API, not assumed.
  • Full local gate green.

🤖 Generated with Claude Code

The in-repo gates and audits (including audit_supply_chain) enforce most
of the quality bar, but four protections can only be set in GitHub
settings: required status checks (Quality gates + Secret scanning), a
release-PR token, the Code Quality org preview, and v* tag protection.

Consolidates these into a canonical docs/repository-governance.md, with
the current ruleset state verified against the live API (PR + CodeQL
code_quality + no-deletion + non-fast-forward are enforced; there is no
required_status_checks rule and no tag ruleset). Linked from the README
so an adopter can audit governance against reality.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@sonarqubecloud

Copy link
Copy Markdown

@github-code-quality

Copy link
Copy Markdown

Code Coverage Overview

Languages: Python

Python / code-coverage/pytest

The overall coverage remains at 89%, unchanged from the branch.


Code Coverage is in Public Preview. Learn more and provide us with your feedback.

@jimCresswell jimCresswell merged commit 59786bd into main Jun 18, 2026
7 checks passed
@jimCresswell jimCresswell deleted the docs/repository-governance-checklist branch June 18, 2026 11:47
jimCresswell added a commit that referenced this pull request Jun 18, 2026
…ns (#42)

The "highest proportionate bar" program is finished and v0.3.0 is cut.
Refresh the continuity entry point and the gate-expansion thread record
to reflect F6 (#37), Tier 3 (#38/#39/#40), Tier 2 (#41), Dependabot
(#29/#30) and the release, and to list the owner-only settings and the
documented F6 residuals as the only remaining work.

Napkin captures the load-bearing lesson: a safety guardrail must prefer
over-blocking to under-blocking — the reverted heredoc-strip would have
let a bash-fed quoted heredoc force-push slip, because a quoted delimiter
blocks expansion, not execution.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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