🚀 [Feature]: Settings-driven workflow control

.github/copilot-instructions.md

@@ -2,17 +2,18 @@
 
 ## Terminal Commands
 
-When executing terminal commands (using `run_in_terminal` or similar tools):
-
 - Prefer MCP server calls over command-line tools when possible.
-- **ALWAYS** send commands into `pwsh -Command` to ensure proper execution.
-  - These commands must be enclosed in single quotes.
-  - Escape any single quotes within the command by doubling them (e.g., `It's` becomes `It''s`).
-  - Use double quotes for string with variables or expressions inside the single-quoted command.
+- When running scripts within the [scripts](../.specify/scripts/) folder, just run them directly (shell is default PowerShell).
+- For other commands, send them into `pwsh -Command` to ensure proper execution.
+
+### Quoting in PowerShell
+
+Proper quoting is essential in PowerShell to prevent parsing errors and ensure correct command execution.
+
+- **Direct script execution**: Scripts run directly in PowerShell use standard PowerShell quoting rules. Double quotes expand variables and expressions, while single quotes are literal. No additional shell escaping is needed.
+
+- **Via `pwsh -Command`**: Commands are passed as strings to PowerShell. Enclose the entire command in single quotes to treat it as a literal string. Escape single quotes within the command by doubling them (e.g., `It's` becomes `It''s`). Use double quotes within the command for variable expansion, but ensure the outer single quotes protect the string from shell interpretation.
 
-## Other instructions
+For arguments containing single quotes, prefer double-quoting the argument inside the command string.
 
-| Tech | Instruction file |
-|------|------------------|
-| PowerShell | [pwsh.instructions.md](./instructions/pwsh.instructions.md) |
-| Markdown | [md.instructions.md](./instructions/md.instructions.md) |
+Example: `pwsh -Command 'Write-Host "I''m Groot"'`

.github/workflows/workflow.yml

@@ -168,45 +168,6 @@ jobs:
       Name: ${{ fromJson(needs.Get-Settings.outputs.Settings).Name }}
       WorkingDirectory: ${{ inputs.WorkingDirectory }}
 
-  # Runs on:
-  # - ✅ Open/Updated PR - Builds documentation for review
-  # - ✅ Merged PR       - Builds documentation for publishing
-  # - ❌ Abandoned PR    - Skips building docs for abandoned changes
-  # - ✅ Manual run      - Builds documentation when manually triggered
-  Build-Docs:
-    if: ${{ !(github.event.action == 'closed' && github.event.pull_request.merged != true) && fromJson(needs.Get-Settings.outputs.Settings).Build.Docs.Skip != true }}
-    needs:
-      - Get-Settings
-      - Build-Module
-    uses: ./.github/workflows/Build-Docs.yml
-    with:
-      Name: ${{ fromJson(needs.Get-Settings.outputs.Settings).Name }}
-      Debug: ${{ inputs.Debug }}
-      Prerelease: ${{ inputs.Prerelease }}
-      Verbose: ${{ inputs.Verbose }}
-      Version: ${{ inputs.Version }}
-      WorkingDirectory: ${{ inputs.WorkingDirectory }}
-      ShowSummaryOnSuccess: ${{ fromJson(needs.Get-Settings.outputs.Settings).Build.Docs.ShowSummaryOnSuccess }}
-
-  # Runs on:
-  # - ✅ Open/Updated PR - Builds site for preview
-  # - ✅ Merged PR       - Builds site for publishing
-  # - ❌ Abandoned PR    - Skips building site for abandoned changes
-  # - ✅ Manual run      - Builds site when manually triggered
-  Build-Site:
-    if: ${{ !(github.event.action == 'closed' && github.event.pull_request.merged != true) && fromJson(needs.Get-Settings.outputs.Settings).Build.Site.Skip != true }}
-    needs:
-      - Get-Settings
-      - Build-Docs
-    uses: ./.github/workflows/Build-Site.yml
-    with:
-      Name: ${{ fromJson(needs.Get-Settings.outputs.Settings).Name }}
-      Debug: ${{ inputs.Debug }}
-      Prerelease: ${{ inputs.Prerelease }}
-      Verbose: ${{ inputs.Verbose }}
-      Version: ${{ inputs.Version }}
-      WorkingDirectory: ${{ inputs.WorkingDirectory }}
-
   # Runs on:
   # - ✅ Open/Updated PR - Tests source code changes
   # - ✅ Merged PR       - Tests source code before publishing
@@ -453,38 +414,11 @@ jobs:
       Verbose: ${{ inputs.Verbose }}
       Version: ${{ inputs.Version }}
 
-  # Runs on:
-  # - ❌ Open/Updated PR - Site not published for PRs in progress
-  # - ✅ Merged PR       - Deploys site to GitHub Pages after successful merge
-  # - ❌ Abandoned PR    - Site not published for abandoned changes
-  # - ❌ Manual run      - Only publishes on merged PRs, not manual runs
-  Publish-Site:
-    if: ${{ !(github.event.action == 'closed' && github.event.pull_request.merged != true) && needs.Get-TestResults.result == 'success' && needs.Get-CodeCoverage.result == 'success' && needs.Build-Site.result == 'success' && !cancelled() && github.event_name == 'pull_request' && github.event.pull_request.merged == true }}
-    needs:
-      - Get-Settings
-      - Get-TestResults
-      - Get-CodeCoverage
-      - Build-Site
-    permissions:
-      pages: write    # to deploy to Pages
-      id-token: write # to verify the deployment originates from an appropriate source
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/configure-pages@v5
-
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4
-
   # Runs on:
   # - ✅ Open/Updated PR - Publishes prerelease when all tests/coverage/build succeed
   # - ✅ Merged PR       - Publishes release when all tests/coverage/build succeed
   # - ✅ Abandoned PR    - Publishes cleanup/retraction version
   # - ✅ Manual run      - Publishes when all tests/coverage/build succeed
-  #
   Publish-Module:
     if: |
       needs.Get-Settings.result == 'success' && !cancelled() && github.event_name == 'pull_request' && (
@@ -534,3 +468,68 @@ jobs:
           PatchLabels: ${{ fromJson(needs.Get-Settings.outputs.Settings).Publish.Module.PatchLabels }}
           VersionPrefix: ${{ fromJson(needs.Get-Settings.outputs.Settings).Publish.Module.VersionPrefix }}
           WorkingDirectory: ${{ inputs.WorkingDirectory }}
+
+  # Runs on:
+  # - ✅ Open/Updated PR - Builds documentation for review
+  # - ✅ Merged PR       - Builds documentation for publishing
+  # - ❌ Abandoned PR    - Skips building docs for abandoned changes
+  # - ✅ Manual run      - Builds documentation when manually triggered
+  Build-Docs:
+    if: ${{ !(github.event.action == 'closed' && github.event.pull_request.merged != true) && fromJson(needs.Get-Settings.outputs.Settings).Build.Docs.Skip != true }}
+    needs:
+      - Get-Settings
+      - Build-Module
+    uses: ./.github/workflows/Build-Docs.yml
+    with:
+      Name: ${{ fromJson(needs.Get-Settings.outputs.Settings).Name }}
+      Debug: ${{ inputs.Debug }}
+      Prerelease: ${{ inputs.Prerelease }}
+      Verbose: ${{ inputs.Verbose }}
+      Version: ${{ inputs.Version }}
+      WorkingDirectory: ${{ inputs.WorkingDirectory }}
+      ShowSummaryOnSuccess: ${{ fromJson(needs.Get-Settings.outputs.Settings).Build.Docs.ShowSummaryOnSuccess }}
+
+  # Runs on:
+  # - ✅ Open/Updated PR - Builds site for preview
+  # - ✅ Merged PR       - Builds site for publishing
+  # - ❌ Abandoned PR    - Skips building site for abandoned changes
+  # - ✅ Manual run      - Builds site when manually triggered
+  Build-Site:
+    if: ${{ !(github.event.action == 'closed' && github.event.pull_request.merged != true) && fromJson(needs.Get-Settings.outputs.Settings).Build.Site.Skip != true }}
+    needs:
+      - Get-Settings
+      - Build-Docs
+    uses: ./.github/workflows/Build-Site.yml
+    with:
+      Name: ${{ fromJson(needs.Get-Settings.outputs.Settings).Name }}
+      Debug: ${{ inputs.Debug }}
+      Prerelease: ${{ inputs.Prerelease }}
+      Verbose: ${{ inputs.Verbose }}
+      Version: ${{ inputs.Version }}
+      WorkingDirectory: ${{ inputs.WorkingDirectory }}
+
+  # Runs on:
+  # - ❌ Open/Updated PR - Site not published for PRs in progress
+  # - ✅ Merged PR       - Deploys site to GitHub Pages after successful merge
+  # - ❌ Abandoned PR    - Site not published for abandoned changes
+  # - ❌ Manual run      - Only publishes on merged PRs, not manual runs
+  Publish-Site:
+    if: ${{ !(github.event.action == 'closed' && github.event.pull_request.merged != true) && needs.Get-TestResults.result == 'success' && needs.Get-CodeCoverage.result == 'success' && needs.Build-Site.result == 'success' && !cancelled() && github.event_name == 'pull_request' && github.event.pull_request.merged == true }}
+    needs:
+      - Get-Settings
+      - Get-TestResults
+      - Get-CodeCoverage
+      - Build-Site
+    permissions:
+      pages: write    # to deploy to Pages
+      id-token: write # to verify the deployment originates from an appropriate source
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/configure-pages@v5
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4