[Marius Storhaug (MariusStorhaug)]

Module maintainers and agents can audit repositories against one executable Template-PSModule baseline while preserving repository-owned code and content. Standard module sites use the shared MSX presentation profile, native folder-derived navigation, and no cookie-consent prompt.

Removed: PR-template files from the module baseline

Pull requests use canonical MSX PR Format guidance, not repository-local or centrally inherited automatic template files. Audits treat their absence as intentional and report existing files as stale drift for separate removal work. Upgrades must not add, recreate, copy, or generate a PR-template file from an older template snapshot or restore a central fallback.

Authors keep the complete release record in the PR body and follow the canonical release-range-first method for release-bound changes. This bounded correction needs no caller-input, TestData, Pester-dependency, module-asset, or documentation-configuration changes; the other standardization work below is preserved.

Technical details

The user-directed correction is committed at d2786d5e974e2430f756612cd66fe9dde6603756, based on the verified #525 candidate 9c41fb1cce0a846af994100ead738b2e2ed5a84f. Its scoped implementation comparison changes only these three files, with 44 insertions and two deleted baseline rows:

Changed surface	Standards checked	Framework contract	Result
docs/content/reference/repository-standard.md	MSX PR Format, Repository Standard, Markdown	No PR-template requirements or central fallback	Fixed in this PR
Read-only repository audit	Canonical PR authoring and non-mutating audits	No standard/scaffold classification or recreation prompt for PR-template files	Fixed in this PR
v8 upgrade skill	Canonical PR authoring and scoped migration	No local/central PR-template creation or recovery from an older snapshot	Fixed in this PR

Test-first assertions failed nine of 14 checks on the assigned candidate; physical-file absence and the four preservation/scope checks passed. All 14 pass after the correction. Exact content comparisons preserve every unrelated paragraph and every other tracked path, including CONTRIBUTING, legal/ownership/client routes, community-policy defaults, caller/TestData/Pester contracts, Zensical configuration, navigation, consent and assets. No consumer repository or other owner's workspace was edited.

Targeted Markdown lint passes all three files; both plugin manifests parse and their identity/version agrees; all four skill YAML headers and relative skill links validate. Site TOML parses, both JavaScript syntax checks pass, the repository analyzer reports zero regression-script diagnostics, and zensical build --clean --strict completes without issues. The generated authoring section and seven reference tables were checked before task-created build output was removed.

Immutable source correspondence: Template-PSModule default commit ff935a5745db222c5f28e59df45931b617c2c50b has a complete 20-file inventory and no PR-template file; this correction therefore needs no new template PR. The separately owned stale PSModule/Template-PSModule#42 removal remains separate. The canonical owner froze MSXOrg/docs#209 at bc03a5992615f65d1d5346dc48e7506e80b8b6ca. The complete description example, release-first procedure, no-file repository policy and defaults source guidance are the current correspondence; old template-scaffold links are not current evidence. The source's five hosted checks and automated approval 5725019918 were independently verified on that exact source head. This does not approve #525, merge the canonical source, or complete other owners' removals.

Actual #525 readiness hold: GitHub reports this producer head unmergeable against current main 64ffb1d87f86bd5d487891fdb140b78385a00531 (mergeable_state: dirty). Docs and Linter are active workflows but no PR runs/checks exist on this head; only dynamic CodeQL/Actions analysis and the reviewer checks succeeded. Copilot review 5725014128 is COMMENTED on d2786d5e974e2430f756612cd66fe9dde6603756, with zero new inline comments but an explicit keyboard-sorting human-assessment flag. The unchanged vendor source assigns lowercase tabindex, while the initializer assumes focusable headers. That wider Zensical concern is outside the bounded no-file correction. The review's "No open issues" line and successful reviewer check are not clean approval. Current-main composition and full actual-head checks/review remain required. Keep #525 draft; no merge/rebase or auto-merge was performed or is authorized by this revision.

Additional declared-schema checks expose unchanged composition gaps: the plugin's declared schema rejects its existing /skills property, and the marketplace's declared schema URL returns HTTP 404. Their manifest blobs exactly match the assigned candidate. The local Copilot command is an unavailable installation shim, so installed-plugin validation is also blocked. These were not repaired by widening the no-file revision.

Related references

• References MSXOrg/docs#209
• References PSModule/Template-PSModule#42 for its separately owned stale-file removal

New: Read-only module repository audits

The PSModule plugin gains psmodule-repository-audit, a read-only comparison skill for one repository or a fleet campaign. It records the template commit, classifies template-owned and repository-owned paths, reports drift, and leaves remediation to separate delivery work.

Changed: Migration skills consume the template

The v8 and Zensical migration skills use Template-PSModule rather than embedding another copy of standard files. The v8 upgrade now requires the dedicated Pester 6.1.0 procedure to inventory and validate every test set instead of treating a declared dependency or one green workflow as sufficient.

Changed: Documentation follows folders

Process-PSModule no longer maintains an explicit Zensical navigation array or hides the Dictionary from the generated tree. Zensical derives navigation from folders, places index pages first, and orders remaining pages alphabetically. The site uses the MSX vendored table sorter and keyboard-accessible initializer.

Changed: Community and release defaults follow their owners

Process-PSModule keeps its repository-specific contribution guide under .github/. The standard Code of Conduct, security policy, and support guidance are provided by PSModule/.github; local copies are needed only for repository-specific overrides. .github/release.yml is not part of the baseline because Process-PSModule does not use GitHub's built-in release configuration. The coordinated template update reflects the same contract for new module repositories.

---

Technical details

• Documents that every Process-PSModule change evaluates its impact on Template-PSModule; the audit skill does not maintain or edit either repository.
• Removes the duplicate generated-module .github/zensical.toml from Process-PSModule. The executable module profile lives in Template-PSModule; this repository's hand-authored site keeps docs/zensical.toml.
• Uses MSXOrg/docs as the shared Zensical presentation source while preserving Process-specific identity, content, snippets, consent, and social links.
• Declares that [project.extra.consent] is not part of the generated-module template because that profile enables no cookie-based measurement.
• Excludes vendored minified assets from repository-authored JavaScript linting, matching the MSX documentation workflow.
• Replaces duplicated caller-workflow examples with links to the executable template and documents the controlled @v8 major reference.
• Keeps Process-PSModule's contribution guide under .github and points to organization-owned Code of Conduct and support guidance; the documentation standard records the inherited community-policy exception and excludes release.yml from the baseline.
• Adds the required Claude and Copilot route files and corrects stale documentation links.
• Preserves the historical managed-file anchor after clarifying that automated distribution is not operating today.
• Local validation: plugin manifests parse, both JavaScript files pass node --check, docs/zensical.toml parses, explicit nav is absent, the vendored scripts match the pinned MSX sources after line-ending normalization, the local contribution path exists without root duplicates, the organization-owned policy files exist, and zensical build --clean completes without warnings.
• Template impact evaluation: 🪲 [Fix]: New modules inherit the current repository baseline Template-PSModule#53 aligns the portable generated-module profile and removes redundant local community-policy and release configuration files.

Changed surface	Standards checked	Framework docs checked	Result
.github/plugin/**	MSX fleet orchestration and comparative review	PSModule migration contracts	Fixed in this PR
.github/workflows/Docs.yml	MSX GitHub Actions	Documentation lint contract	Fixed in this PR
.github/*.md	MSX repository and community health	PSModule repository standard	Fixed in this PR
docs/**	MSX documentation, Markdown, and Zensical design	PSModule repository and pipeline docs	Fixed in this PR
Agent route files	MSX agentic development	PSModule onboarding contract	Fixed in this PR

Relevant issues (or links)

• Resolves Add template-backed audits and canonical repository defaults #526

Related work

• Depends on 🪲 [Fix]: New modules inherit the current repository baseline Template-PSModule#53
• Depends on ⚙️ [Maintenance]: New module repositories ship the Claude Code and Copilot agent routes Template-PSModule#50
• Followed by Use native folder-derived Zensical navigation MSXOrg/docs#189
• Followed by Automatic palette mode uses a misleading link icon MSXOrg/docs#190
• Followed by Pin one Zensical version for framework and documentation builds #527
• References Track fleet alignment: remove Zensical navigation.indexes from existing repos #418
• References Reconcile the Repository Defaults required-files tables with what Template-PSModule ships #484
• References State the real status of managed file distribution on the Repository Standard #488

[github-actions]

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITHUB_ACTIONS_ZIZMOR	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
HTML	Pass ✅
JAVASCRIPT_ES	Pass ✅
JAVASCRIPT_PRETTIER	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Pass ✅
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

[Copilot]

Pull request overview

This PR updates Process-PSModule’s plugin and documentation to support auditing module repositories against a single canonical Template-PSModule baseline, and aligns Zensical documentation behavior with folder-derived navigation and shared MSX presentation defaults.

Changes:

• Adds a new read-only plugin skill (psmodule-repository-audit) to compare a repository against a recorded Template-PSModule commit while classifying template-owned vs repository-owned paths.
• Updates migration skills/docs to treat Template-PSModule/.github/zensical.toml as the canonical module-site configuration and to omit explicit nav in favor of Zensical’s folder-derived navigation.
• Vendors Tablesort locally for the docs site and adjusts linting to exclude minified third-party assets.

Reviewed changes

Copilot reviewed 18 out of 19 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
README.md	Updates docs-site configuration guidance to reference Template-owned .github/zensical.toml.
docs/zensical.toml	Removes manual nav/CSS and switches Tablesort dependency to a vendored local asset.
docs/overrides/assets/stylesheets/navigation.css	Removes obsolete navigation-hiding CSS as folder-derived navigation is now intended.
docs/overrides/assets/javascripts/tablesort.min.js	Adds vendored/minified Tablesort library used by the docs site.
docs/overrides/assets/javascripts/tablesort.js	Adds keyboard activation support (Enter/Space) for sortable table headers.
docs/content/reference/repository-standard.md	Documents template ownership/reconciliation and the canonical .github/zensical.toml/no-nav contract.
docs/content/reference/pipeline-stages.md	Updates docs-stage description to reflect resolving canonical .github/zensical.toml and native navigation.
docs/content/guides/structuring-your-module.md	Aligns module structure guidance with template-owned Zensical profile and no-nav behavior.
docs/content/guides/calling-the-workflow.md	Updates workflow guidance to reference canonical template Zensical config resolution.
docs/content/get-started/repository-setup.md	Updates setup guidance to keep the template .github/zensical.toml and rely on folder-derived navigation.
AGENTS.md	Adds explicit “template impact” guidance for Process-PSModule changes.
.github/zensical.toml	Removes the duplicate generated-module Zensical profile from this repo.
.github/workflows/Docs.yml	Excludes minified assets from linting scope for docs workflow runs.
.github/plugin/README.md	Documents the new psmodule-repository-audit skill.
.github/plugin/psmodule/skills/psmodule-zensical-migration/SKILL.md	Reframes Zensical migration around canonical template profile + MSX precedence and folder-derived nav.
.github/plugin/psmodule/skills/psmodule-v8-upgrade/SKILL.md	Updates v8 upgrade procedure to require repository audit + Pester migration subprocedures and template alignment.
.github/plugin/psmodule/skills/psmodule-repository-audit/SKILL.md	Introduces the new audit skill definition and procedure.
.github/plugin/psmodule/plugin.json	Bumps plugin version to 1.1.0 and adds a keyword.
.github/plugin/marketplace.json	Bumps marketplace/plugin version metadata to 1.1.0.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Pull request overview

Copilot reviewed 18 out of 19 changed files in this pull request and generated no new comments.

[Copilot]

Pull request overview

Copilot reviewed 25 out of 26 changed files in this pull request and generated no new comments.

[Copilot]

🔵 Needs a closer look

Human assessment is needed because the keyboard sorting handler is unreachable for normal table headers, leaving Enter/Space sorting unavailable without a mouse.

No open issues 🎉

_{Review effort: Lite}