build-ci-local.ps1 Workflow
When to use
Use this skill when working on:
scripts/build-ci-local.ps1- Build pipeline steps, flags, or output
- How the script uses modules in
scripts/modules/Buildandscripts/modules/Core
How it’s structured (repo-specific)
- Imports modules from
scripts/modules:Core/Logging.psm1Core/Prerequisites.psm1Build/DotNetBuild.psm1Build/PluginBuild.psm1
Safe changes
- Prefer adding reusable behavior in the appropriate module (
Build/*orCore/*) and calling it from the script. - Keep flags backward compatible when possible.
Step-by-step procedure
- Confirm which scenario is being modified (full CI, plugin-only, formatting, test docs).
- Find the corresponding pipeline step in
scripts/build-ci-local.ps1. - Prefer implementing reusable behavior in:
scripts/modules/Build/*for build operationsscripts/modules/Core/*for shared utilities/prereqs
- Ensure the script continues to import modules from
$ModulesDir(no hard-coded absolute paths). - Validate by running an appropriate command:
- Quick sanity:
pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/build-ci-local.ps1 -SkipTests -SkipFormat - Full pipeline:
pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/build-ci-local.ps1
Examples (input → expected output)
Example: Add a new optional build step
Input: “Add a flag to run an extra verification step.”
Expected output:
- A new
param()switch with help text - Step wired into the pipeline with clear output
- Reusable logic lives in a module if it’s non-trivial
- Script still works with existing flags and defaults
How to run (examples)
- Full build:
pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/build-ci-local.ps1 - Quick:
pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/build-ci-local.ps1 -SkipTests -SkipFormat - Plugin-only:
pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/build-ci-local.ps1 -PluginOnly -DeployPlugin
References
- Script docs: scripts/README.md
- Module catalog: scripts/modules/README.md
Converted and distributed by TomeVault — claim your Tome and manage your conversions.