Skip to content

Commit d2786d5

Browse files
Keep PR authoring guidance free of template files
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 9c41fb1 commit d2786d5

3 files changed

Lines changed: 44 additions & 2 deletions

File tree

‎.github/plugin/psmodule/skills/psmodule-repository-audit/SKILL.md‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -99,6 +99,20 @@ Configuration is not automatically consumer-owned. For example,
9999
schema and unaffected defaults still come from the template. Compare fields,
100100
not only whole-file hashes, when the standard permits overrides.
101101

102+
## Pull request authoring
103+
104+
Follow the [canonical MSX PR Format](https://msx.no/docs/Ways-of-Working/PR-Format/)
105+
for authoring guidance, not a repository or organization PR-template file.
106+
107+
Do not classify PR-template files as template-owned standards or creation
108+
scaffolds. Their absence is intentional, not missing baseline drift. Report
109+
existing files as stale drift for a separate removal task. Do not recommend
110+
adding, recreating, copying, or generating them, and do not rely on a central
111+
fallback.
112+
113+
If the recorded template contains a PR-template file, report the upstream
114+
policy gap and block consumer alignment rather than propagating it.
115+
102116
## Zensical contract
103117

104118
For module repositories, `.github/zensical.toml` comes from the matching path

‎.github/plugin/psmodule/skills/psmodule-v8-upgrade/SKILL.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,19 @@ consumer repositories while developing or validating this skill.
3333
Use the repository's applicable MSX workflow and PR format guidance. Do not
3434
silently broaden the scope when the consumer has unrelated failures.
3535

36+
## Pull request authoring
37+
38+
Follow the [canonical MSX PR Format](https://msx.no/docs/Ways-of-Working/PR-Format/)
39+
rather than a PR-template file. For release-bound changes, use its
40+
release-range-first method and keep the complete authored release record in
41+
the pull request body.
42+
43+
Do not add, recreate, copy, or generate repository-local or centrally provided
44+
PR-template files during an upgrade. Their absence is intentional, not missing
45+
template drift. Do not restore them from an older template snapshot or rely on
46+
a central fallback. Use the audit's stale-drift report for a separate removal
47+
task.
48+
3649
## Consumer layout variance
3750

3851
Do not assume that a consumer already resembles Process-PSModule. Inventory

‎docs/content/reference/repository-standard.md‎

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -112,7 +112,6 @@ Module repositories use the PSModule framework layout:
112112
| `.github/linters/` | Linter configuration used by the framework's linting stage, including `.markdown-lint.yml` and `.powershell-psscriptanalyzer.psd1`. |
113113
| `.github/dependabot.yml` | Configures ecosystem-appropriate dependency-update pull requests. For PowerShell module repositories the `github-actions` ecosystem is expected; add any other ecosystems the module actually develops in. |
114114
| `.github/CODEOWNERS` | Ownership routing for reviews and protected areas. |
115-
| `.github/pull_request_template.md` | Scaffolds pull requests in the MSX PR Format (PR Manager) style — an icon + change-type + user-facing-outcome title, user-facing description sections, an optional technical-details block, and a related-issues block. |
116115
| `.gitattributes` | Normalizes line endings and declares text/binary handling so the module can be developed and built consistently on Linux, macOS, and Windows. |
117116
| `.gitignore` | Ignores files that must never be committed, tailored to the PowerShell-module ecosystem: operating-system files, editor and developer-tooling files, PowerShell and Pester test-harness artifacts, and all local build outputs and files created during build and test. |
118117
| `src/` | Module source compiled into the shipped artifact. |
@@ -170,7 +169,6 @@ Required baseline files for module repositories:
170169
| `.github/copilot-instructions.md` | Route to `AGENTS.md` for Copilot surfaces that need their own filename. |
171170
| `.github/dependabot.yml` | Configures ecosystem-appropriate dependency-update pull requests. For PowerShell module repositories the `github-actions` ecosystem is expected; add any other ecosystems the module actually develops in. |
172171
| `.github/CODEOWNERS` | Review routing for source, docs, and GitHub workflow files. |
173-
| `.github/pull_request_template.md` | Scaffolds pull requests in the MSX PR Format (PR Manager) style — an icon + change-type + user-facing-outcome title, user-facing description sections, an optional technical-details block, and a related-issues block. |
174172
| `.github/PSModule.yml` | Module workflow defaults and overrides. |
175173
| `.gitattributes` | Normalizes line endings and declares text/binary handling so the module can be developed and built consistently on Linux, macOS, and Windows. |
176174
| `.gitignore` | Ignores files that must never be committed, tailored to the PowerShell-module ecosystem: operating-system files, editor and developer-tooling files, PowerShell and Pester test-harness artifacts, and all local build outputs and files created during build and test. |
@@ -190,6 +188,23 @@ the PSModule layout. `README.md`, `LICENSE`, and `AGENTS.md` remain at the
190188
repository root because they are repository entry points rather than community
191189
health files.
192190

191+
## Pull request authoring
192+
193+
Use the [canonical MSX PR Format](https://msx.no/docs/Ways-of-Working/PR-Format/)
194+
to author pull requests. For release-bound changes, follow its release-range-first
195+
method and keep the complete authored release record in the pull request body.
196+
197+
PR-template files are not part of the repository or generated-module baseline.
198+
Do not create, copy, generate, or distribute them in any PSModule repository,
199+
`Template-PSModule`, or organization `.github` repositories. Do not rely on a
200+
central PR-template fallback.
201+
202+
This includes root, `docs/`, or `.github/` files such as
203+
`pull_request_template.md` and entries under `PULL_REQUEST_TEMPLATE/`. Their
204+
absence is intentional, not missing baseline drift. Report existing files as
205+
stale drift for a separate removal task; do not restore them from an older
206+
template snapshot.
207+
193208
## Agent onboarding files
194209

195210
Every repository must be usable by an agent that has never seen it before, without special configuration. Each repository carries its own agent entry points that point to the authoritative documentation instead of restating it:

0 commit comments

Comments
 (0)