You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Add weekly agentic workflow to update GHAS-on-GHES feature matrix
Create a GitHub Agentic Workflow that runs weekly to detect new GHES
versions and Advanced Security feature changes, then opens PRs to
update GHAS-on-GHES-feature-matrix.md.
- Add .github/workflows/update-ghas-matrix.md agentic workflow
- Compile to .github/workflows/update-ghas-matrix.lock.yml
- Create .gitattributes for lock file handling
- Update copilot instructions with automated workflow guidance,
minor version checking, and end-of-life handling
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copy file name to clipboardExpand all lines: .github/instructions/GHASonGHESMatrix.instructions.md
+8-2Lines changed: 8 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,9 +7,12 @@ You are an expert technical writer and product specialist for GitHub Advanced Se
7
7
When asked to update this Advanced Security feature matrix for a new GHES version, follow this strict procedure:
8
8
9
9
## 1. Research Phase
10
-
-**Identify the Version:** Determine the specific GHES version number requested (e.g., 3.16).
11
-
-**Consult Release Inventory:** Read the official start/end/docs/releasenote information for all versions at `End of life dates at: https://docs.github.com/en/enterprise-server/admin/all-releases#releases-of-github-enterprise-server`.
10
+
-**Identify the Version(s):** Determine the specific GHES version number(s) to check.
11
+
- If a version is specified by a user, use that version.
12
+
- If running as an automated workflow (no user-specified version), compare the versions currently documented in the matrix against the all-releases page to detect any new major versions or recent patch releases.
13
+
-**Consult Release Inventory:** Read the official start/end/docs/releasenote information for all versions at `https://docs.github.com/en/enterprise-server/admin/all-releases#releases-of-github-enterprise-server`.
12
14
-**Consult Release Notes:** Read the official release notes at `https://docs.github.com/en/enterprise-server@<VERSION>/admin/release-notes`.
15
+
-**Check Minor/Patch Versions:** For each currently documented major version that is still supported, check the release notes page for recent patch releases (e.g., 3.19.3 → 3.19.4) that may include significant Advanced Security feature changes such as features moving from Preview to GA, new capabilities being backported, or important security fixes.
13
16
-**Specifics**
14
17
- CodeQL version included in the runner toolcache is located in this document: https://docs.github.com/en/enterprise-server@<VERSION>/admin/managing-code-security/managing-github-advanced-security-for-your-enterprise/configuring-code-scanning-for-your-appliance#provisioning-the-actions-for-code-scanning
15
18
- Secret Scanning pattern counts are easily discovered for the GHES VERSION by running this script on the public docs for secret scanning pattern list: https://github.com/felickz/scripts/blob/main/pwsh/Count-SecretScanningPatterns.ps1
@@ -35,8 +38,11 @@ When asked to update this Advanced Security feature matrix for a new GHES versio
35
38
-**New Column:** Always add a new column for the new version in *every* table, even if there are no specific changes for that table.
36
39
-**Carry Forward:** Pull forward the feature status from the previous version. Update the status icon only if it has changed (e.g., ☑️ to ✅).
37
40
-**New Rows:** Insert new rows for new features found during research. Give the feature a few word summary, always prefer to deep link it to the docs for the new feature.
41
+
-**End-of-Life Versions:** When a version has passed its deprecation date, consider whether it should be archived. The document uses an archive pattern — see the "End of life Archive" section at the top of the matrix. Do not remove columns without moving them to the archive first.
38
42
39
43
## 4. Pull Request & Output Instructions
40
44
When generating the Pull Request description or summary of changes:
41
45
-**List Omissions:** Explicitly list any advanced security / security features you saw in the release notes but decided *not* to include in the matrix. This helps the reviewer confirm if they should be added.
42
46
-**Rendered Link:** Include a link to the rendered view of the Markdown file so the reviewer can easily visualize the table columns.
47
+
-**Version Context:** When updating for a new major version, include the release date, deprecation date, and CodeQL toolcache version in the PR description.
48
+
-**Duplicate Check:** Before creating a PR, check if there is already an open PR updating the matrix for the same version(s). If so, skip creating a duplicate.
0 commit comments