fix: remove run.ps1 references from agentic scaffold guidance

Author: stiwicourage

CHANGELOG.md

@@ -20,6 +20,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 - The getting-started guide now splits the Agentic quickstart explanation into shorter paragraphs so the scaffold flow stays readable on the site.
 - The core workflows guide now splits the scaffold and Agentic starter explanation into shorter paragraphs so the page stays readable on the site.
 - The command cheat sheet now stacks the three "Set up a project" cards vertically so the section reads top-to-bottom without a missing grid slot.
+- The Agentic Copilot starter shipped by `nova init` no longer tells generated projects to use a `run.ps1` quality wrapper that the template does not include.
+    - The scaffold now points generated documentation and agent guidance to the repository quality loop wording plus the existing analyzer and `Test-NovaBuild` entrypoints instead.
 
 ### Security
 

RELEASE_NOTE.md

@@ -14,6 +14,8 @@ This file summarizes the release notes for NovaModuleTools. **UNRELEASED** chang
 
 ### Fixed
 
+- The Agentic Copilot starter shipped by `nova init` no longer tells generated projects to use a `run.ps1` quality wrapper that the template does not include.
+
 ### Security
 
 ## [3.0.0] - 2026-05-17
@@ -188,4 +190,3 @@ This release was yanked because it removed the implicit `Pester` dependency befo
 ## [0.0.4] - 2024-06-25
 ### Added
 - First PowerShell Gallery release of NovaModuleTools with the initial module workflow support.
-

scripts/build/Sync-AgenticCopilotScaffold.psd1

@@ -254,6 +254,18 @@
             Old = 'applyTo: "tests/**/*.ps1,scripts/build/**/*.ps1,"'
             New = 'applyTo: "tests/**/*.ps1,scripts/build/**/*.ps1"'
         }
+        @{
+            Old = 'applyTo: "src/**/*.ps1,tests/**/*.ps1,scripts/**/*.ps1,run.ps1,reload.ps1"'
+            New = 'applyTo: "src/**/*.ps1,tests/**/*.ps1,scripts/**/*.ps1,reload.ps1"'
+        }
+        @{
+            Old = 'applyTo: "src/**/*.ps1,scripts/**/*.ps1,run.ps1,reload.ps1"'
+            New = 'applyTo: "src/**/*.ps1,scripts/**/*.ps1,reload.ps1"'
+        }
+        @{
+            Old = '- Use these rules when writing or reviewing `src/**/*.ps1`, `scripts/**/*.ps1`, `run.ps1`, and `reload.ps1`.'
+            New = '- Use these rules when writing or reviewing `src/**/*.ps1`, `scripts/**/*.ps1`, and `reload.ps1`.'
+        }
         @{
             Old = 'quality tooling tooling'
             New = 'quality tooling'
@@ -268,7 +280,55 @@
         }
         @{
             Old = '- Run `./run.ps1`'
-            New = '- Run full regression tests'
+            New = '- Run the repository quality loop when one exists'
+        }
+        @{
+            Old = '- local quality loop: `pwsh -NoLogo -NoProfile -File ./run.ps1`'
+            New = '- local quality loop: use the repository quality wrapper when one exists; otherwise run ScriptAnalyzer, build, and `Test-NovaBuild` in the documented project order'
+        }
+        @{
+            Old = 'If `run.ps1` or `./scripts/build/Invoke-ScriptAnalyzerCI.ps1` reports findings, fix them before review, handoff, or commit. Do not treat a failing local quality loop as an acceptable stopping point.'
+            New = 'If the repository quality loop or `./scripts/build/Invoke-ScriptAnalyzerCI.ps1` reports findings, fix them before review, handoff, or commit. Do not treat a failing validation run as an acceptable stopping point.'
+        }
+        @{
+            Old = '    - full local loop: `./run.ps1`'
+            New = '    - full local loop: the repository quality wrapper, when present'
+        }
+        @{
+            Old = '- Prefer one focused analyzer run on the changed files while iterating, then rerun `./scripts/build/Invoke-ScriptAnalyzerCI.ps1`, then `./run.ps1` before handoff.'
+            New = '- Prefer one focused analyzer run on the changed files while iterating, then rerun `./scripts/build/Invoke-ScriptAnalyzerCI.ps1`, then the repository quality loop before handoff when the project defines one.'
+        }
+        @{
+            Old = 'Prefer `./scripts/build/Invoke-ScriptAnalyzerCI.ps1` and `./run.ps1`'
+            New = 'Prefer `./scripts/build/Invoke-ScriptAnalyzerCI.ps1` and the repository quality loop, when present'
+        }
+        @{
+            Old = 'Prefer `./scripts/build/Invoke-ScriptAnalyzerCI.ps1` and the repository quality loop, when present for normal analyzer loops; use direct `Invoke-ScriptAnalyzer` only for focused local checks that reuse the repository-approved settings.'
+            New = 'Prefer `./scripts/build/Invoke-ScriptAnalyzerCI.ps1` and the repository quality loop, when present, for normal analyzer loops; use direct `Invoke-ScriptAnalyzer` only for focused local checks that reuse the repository-approved settings.'
+        }
+        @{
+            Old = 'If `run.ps1` or `Invoke-ScriptAnalyzerCI.ps1` reports ScriptAnalyzer findings'
+            New = 'If the repository quality loop or `Invoke-ScriptAnalyzerCI.ps1` reports ScriptAnalyzer findings'
+        }
+        @{
+            Old = 'reported by `run.ps1` or `Invoke-ScriptAnalyzerCI.ps1`'
+            New = 'reported by the repository quality loop or `Invoke-ScriptAnalyzerCI.ps1`'
+        }
+        @{
+            Old = 'from `run.ps1` or `Invoke-ScriptAnalyzerCI.ps1`'
+            New = 'from the repository quality loop or `Invoke-ScriptAnalyzerCI.ps1`'
+        }
+        @{
+            Old = '`run.ps1`-style local checks ordered as ScriptAnalyzer first, then `Invoke-NovaBuild`, then `Test-NovaBuild`.'
+            New = 'local quality checks ordered as ScriptAnalyzer first, then `Invoke-NovaBuild`, then `Test-NovaBuild` when the project defines a combined wrapper.'
+        }
+        @{
+            Old = 'Resolve any ScriptAnalyzer findings that `./run.ps1` reports before handoff.'
+            New = 'Resolve any ScriptAnalyzer findings reported by the repository quality loop before handoff.'
+        }
+        @{
+            Old = '4. After meaningful steps, run `./run.ps1` (analyzer → build → `Test-NovaBuild`).'
+            New = '4. After meaningful steps, run the repository quality loop when present (typically analyzer → build → `Test-NovaBuild`).'
         }
         @{
             Old = 'or GitHub release automation.'
@@ -316,11 +376,11 @@
         }
         @{
             Old = '- `pwsh -NoLogo -NoProfile -File ./run.ps1` before completion'
-            New = ''
+            New = '- the repository quality loop before completion'
         }
         @{
             Old = '- `pwsh -NoLogo -NoProfile -File ./run.ps1`'
-            New = ''
+            New = '- the repository quality loop, when present'
         }
         @{
             Old = '- `./scripts/build/ci/Invoke-{{ProjectName}}CI.ps1 -OutputDirectory ./artifacts`'
@@ -360,7 +420,7 @@
         }
         @{
             Old = '- a `code_health_review`, reviewer, or `./run.ps1` run flags maintainability problems'
-            New = '- a reviewer or `./run.ps1` run flags maintainability problems'
+            New = '- a reviewer or the repository quality loop flags maintainability problems'
         }
         @{
             Old = '- measuring or driving a single file''s score across steps — use `guiding-refactoring-with-code-health` for that'

src/resources/agentic-copilot/.github/agents/powershell-developer.agent.md

@@ -42,7 +42,7 @@ Implement PowerShell command and helper changes in the {{ProjectName}} style.
 - Keep raw infrastructure calls behind approved adapters.
 - Preserve existing command names, warning semantics, and output shape.
 - Keep new or heavily changed source functions aligned with `.github/instructions/code-quality-matrix.instructions.md`: short, single-purpose, low-duplication, and split by clear responsibility unless the scope explicitly justifies otherwise.
-- Prefer `./scripts/build/Invoke-ScriptAnalyzerCI.ps1` and `./run.ps1` for normal analyzer loops; use direct `Invoke-ScriptAnalyzer` only for focused local checks that reuse the repository-approved settings.
+- Prefer `./scripts/build/Invoke-ScriptAnalyzerCI.ps1` and the repository quality loop, when present, for normal analyzer loops; use direct `Invoke-ScriptAnalyzer` only for focused local checks that reuse the repository-approved settings.
 - Validate Nova-managed project tests through `Test-NovaBuild`; do not call `Invoke-Pester` directly.
 - When help files change, keep `docs/{{ProjectName}}/en-US/*.md` valid for `Import-MarkdownCommandHelp`: build and import the dist module first (`Import-Module ./dist/{{ProjectName}}/{{ProjectName}}.psd1 -Force`), then use `New-MarkdownCommandHelp` for new files, `Update-MarkdownCommandHelp` after command-surface changes, and `Test-MarkdownCommandHelp` before handoff. Generating help without the module imported causes `external help file` to default to the command name instead of the module name, producing per-command XML files that the manifest cannot find. A new public `src/public/*.ps1` file is not done until its matching help file exists.
 
@@ -53,7 +53,7 @@ Implement PowerShell command and helper changes in the {{ProjectName}} style.
 - Public/private file ownership still follows the one externally called function per file rule, with private helpers kept as sibling top-level functions instead of nested function declarations.
 - Every new public entry point has its matching help file.
 - Project test validation ran through `Test-NovaBuild`.
-- Any ScriptAnalyzer findings reported by `run.ps1` or `Invoke-ScriptAnalyzerCI.ps1` are resolved.
+- Any ScriptAnalyzer findings reported by the repository quality loop or `Invoke-ScriptAnalyzerCI.ps1` are resolved.
 - Every changed or generated text file has been checked and ends with exactly one trailing newline and no extra blank lines at the bottom.
 - Docs/changelog review is complete.
 - The relevant validation commands have been run.

src/resources/agentic-copilot/.github/agents/reviewer.agent.md

@@ -29,7 +29,7 @@ Review changes for correctness, maintainability, test coverage, workflow safety,
 - Flag broad catch-all test files when focused source-mirrored tests would make ownership clearer.
 - Flag Nova-managed validation that bypasses `Test-NovaBuild` with direct `Invoke-Pester`.
 - Flag any PSScriptAnalyzer rule excludes or suppressions; the code should be fixed instead.
-- Flag unresolved ScriptAnalyzer findings from `run.ps1` or `Invoke-ScriptAnalyzerCI.ps1`; they should be fixed instead of deferred.
+- Flag unresolved ScriptAnalyzer findings from the repository quality loop or `Invoke-ScriptAnalyzerCI.ps1`; they should be fixed instead of deferred.
 - Flag every changed or generated text file if they do not exactly have one trailing newline with no extra blank lines at the bottom.
 
 ## Inputs to inspect

src/resources/agentic-copilot/.github/instructions/code-quality-matrix.instructions.md

@@ -1,5 +1,5 @@
 ---
-applyTo: "src/**/*.ps1,scripts/**/*.ps1,run.ps1,reload.ps1"
+applyTo: "src/**/*.ps1,scripts/**/*.ps1,reload.ps1"
 ---
 
 # Code quality matrix
@@ -14,7 +14,7 @@ This file tells Agentic Copilot how to shape source code from the start. Test-sp
 
 ## How to apply this guidance
 
-- Use these rules when writing or reviewing `src/**/*.ps1`, `scripts/**/*.ps1`, `run.ps1`, and `reload.ps1`.
+- Use these rules when writing or reviewing `src/**/*.ps1`, `scripts/**/*.ps1`, and `reload.ps1`.
 - Prefer these patterns in new or heavily changed code instead of leaving cleanup for later.
 - Treat the thresholds as default goals, not as opinions. Use them to decide whether a function or file should be split.
 - If a change must violate one of these rules, keep the exception narrow and explain the trade-off clearly in the handoff.

src/resources/agentic-copilot/.github/instructions/powershell-coding-standards.instructions.md

@@ -1,5 +1,5 @@
 ---
-applyTo: "src/**/*.ps1,tests/**/*.ps1,scripts/**/*.ps1,run.ps1,reload.ps1"
+applyTo: "src/**/*.ps1,tests/**/*.ps1,scripts/**/*.ps1,reload.ps1"
 ---
 
 # {{ProjectName}} PowerShell coding standards
@@ -39,7 +39,7 @@ Use this file when changing `src/public/`, `src/private/`, or PowerShell build/r
 - When public command help changes, follow `.github/instructions/platyps-help.instructions.md` and use `New-MarkdownCommandHelp`, `Update-MarkdownCommandHelp`, and `Test-MarkdownCommandHelp` instead of hand-authoring the help structure.
 - Do not add PSScriptAnalyzer `ExcludeRule`, `ExcludeRules`, suppression attributes, or generated settings that hide analyzer findings. Fix the rule violation instead.
 - Keep local quality wrappers ordered as ScriptAnalyzer first, then `Invoke-NovaBuild`, then `Test-NovaBuild`.
-- If `run.ps1` or `Invoke-ScriptAnalyzerCI.ps1` reports ScriptAnalyzer findings, fix them before treating the change as complete.
+- If the repository quality loop or `Invoke-ScriptAnalyzerCI.ps1` reports ScriptAnalyzer findings, fix them before treating the change as complete.
 
 ## Formatting rules
 
@@ -93,6 +93,6 @@ Use this file when changing `src/public/`, `src/private/`, or PowerShell build/r
 
 - Update or add Pester coverage for behavior changes.
 - Recheck `tests/*Architecture*.Tests.ps1` when changing layering or helper placement.
-- Run full regression tests before considering a code change complete.
-- Resolve any ScriptAnalyzer findings that `./run.ps1` reports before handoff.
+- Run the repository quality loop when one exists before considering a code change complete.
+- Resolve any ScriptAnalyzer findings reported by the repository quality loop before handoff.
 - Before handoff, review the changed/generated text files and normalize any file endings that violate the single-trailing-newline rule.

src/resources/agentic-copilot/.github/instructions/psscriptanalyzer.instructions.md

@@ -1,5 +1,5 @@
 ---
-applyTo: "src/**/*.ps1,tests/**/*.ps1,scripts/**/*.ps1,run.ps1,reload.ps1"
+applyTo: "src/**/*.ps1,tests/**/*.ps1,scripts/**/*.ps1,reload.ps1"
 ---
 
 # PSScriptAnalyzer workflow rules
@@ -17,7 +17,7 @@ Use this file when changing PowerShell code, tests, build helpers, or analyzer w
 
 1. Use the repository wrappers as the authoritative entrypoints:
     - analyzer only: `./scripts/build/Invoke-ScriptAnalyzerCI.ps1`
-    - full local loop: `./run.ps1`
+    - full local loop: the repository quality wrapper, when present
 2. Use raw `Invoke-ScriptAnalyzer` only for focused local investigation or when you are deliberately changing analyzer tooling.
 3. When you call `Invoke-ScriptAnalyzer` directly, point it at real `.ps1`, `.psm1`, or `.psd1` paths, use `-Recurse` when analyzing a directory, and reuse the repository-approved analyzer settings through `-Settings` instead of inventing a new rule selection.
 4. Treat `Error`, `Warning`, and `ParseError` diagnostics as findings to fix before handoff. Parser errors are analyzer diagnostics too and are not something to suppress away.
@@ -27,7 +27,7 @@ Use this file when changing PowerShell code, tests, build helpers, or analyzer w
 
 ## Authoring guidance
 
-- Prefer one focused analyzer run on the changed files while iterating, then rerun `./scripts/build/Invoke-ScriptAnalyzerCI.ps1`, then `./run.ps1` before handoff.
+- Prefer one focused analyzer run on the changed files while iterating, then rerun `./scripts/build/Invoke-ScriptAnalyzerCI.ps1`, then the repository quality loop before handoff when the project defines one.
 - Keep analyzer wrappers focused on source files and helper scripts, not generated output such as `dist/` or `artifacts/`.
 - If the repository has a `PSScriptAnalyzerSettings.psd1` file or a wrapper-owned settings hashtable, treat that configuration as authoritative for direct `Invoke-ScriptAnalyzer` runs.
 - Built-in presets such as `PSGallery` or `CodeFormatting` exist, but do not switch to them unless the repository explicitly adopts them.

src/resources/agentic-copilot/.github/instructions/release-policy.instructions.md

@@ -47,5 +47,5 @@ Use this file when changing versioning, changelog handling, package metadata, pu
 ## Verification
 
 - Validate the touched release or versioning path with targeted tests.
-- Run full regression tests after code changes.
+- Run the repository quality loop when one exists after code changes.
 - Re-read `.github/pull_request_template.md` before preparing release-related summaries.

src/resources/agentic-copilot/.github/instructions/repository-conventions.instructions.md

@@ -27,12 +27,12 @@ Canonical rule source for cross-cutting {{ProjectName}} conventions that apply t
 
 Use the smallest validation set that proves the change, then run the repository quality loop before finishing code work:
 
-- local quality loop: `pwsh -NoLogo -NoProfile -File ./run.ps1`
+- local quality loop: use the repository quality wrapper when one exists; otherwise run ScriptAnalyzer, build, and `Test-NovaBuild` in the documented project order
 - test validation: `Test-NovaBuild`
 - analyzer only: `./scripts/build/Invoke-ScriptAnalyzerCI.ps1`
 - CI-parity coverage flow: use the repository-specific CI helper when one exists
 
-If `run.ps1` or `./scripts/build/Invoke-ScriptAnalyzerCI.ps1` reports findings, fix them before review, handoff, or commit. Do not treat a failing local quality loop as an acceptable stopping point.
+If the repository quality loop or `./scripts/build/Invoke-ScriptAnalyzerCI.ps1` reports findings, fix them before review, handoff, or commit. Do not treat a failing validation run as an acceptable stopping point.
 
 When project-specific quality tooling is available: