Update to new agents and scripts.

[Malcolmnixon]

Pull Request

Description

This PR updates the agents and scripts.

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Code quality improvement

Related Issues

Closes #

Pre-Submission Checklist

Before submitting this pull request, ensure you have completed the following:

Build and Test

• Code builds successfully: dotnet build --configuration Release
• All unit tests pass: dotnet test --configuration Release
• Self-validation tests pass:
  dotnet run --project src/DemaConsulting.SarifMark --configuration Release --framework net10.0
--no-build -- --validate
• Code produces zero warnings

Code Quality

• Code formatting is correct: dotnet format --verify-no-changes
• New code has appropriate XML documentation comments
• Static analyzer warnings have been addressed

Quality Checks

Please run the following checks before submitting:

• All linters pass: ./lint.sh (Unix/macOS) or cmd /c lint.bat / ./lint.bat (Windows)

Testing

• Added unit tests for new functionality
• Updated existing tests if behavior changed
• All tests follow the AAA (Arrange, Act, Assert) pattern
• Test coverage is maintained or improved

Documentation

• Updated README.md (if applicable)
• Updated ARCHITECTURE.md (if applicable)
• Added code examples for new features (if applicable)
• Updated requirements.yaml (if applicable)

Additional Notes

[Copilot]

Pull request overview

This PR updates SarifMark’s Continuous Compliance tooling and documentation by introducing new PowerShell-based scripts, restructuring OTS requirements into separate files, and aligning CI/workflows and agent/standards docs to the updated process.

Changes:

• Replace legacy lint/build entrypoints with lint.ps1, fix.ps1, and build.ps1, and update CI to use them.
• Split OTS requirements into individual YAML files under docs/reqstream/ots/ and update requirements.yaml includes accordingly.
• Update agent prompts/standards docs and add supporting tooling dependencies/config (cspell/markdownlint, yamlfix, FileAssert).

Reviewed changes

Copilot reviewed 49 out of 49 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
requirements.yaml	Switches OTS includes to per-tool requirement files.
pip-requirements.txt	Adds yamlfix dependency for YAML auto-fix.
package.json	Adds cspell + markdownlint dev dependencies.
lint.sh	Removes legacy bash lint entrypoint.
lint.ps1	Adds PowerShell lint gate used by CI.
lint.bat	Removes legacy batch lint entrypoint.
fix.ps1	Adds PowerShell auto-fix script (format/YAML/MD).
docs/reqstream/ots/weasyprint.yaml	Adds standalone WeasyPrint OTS requirement.
docs/reqstream/ots/versionmark.yaml	Adds standalone VersionMark OTS requirement.
docs/reqstream/ots/sonarmark.yaml	Adds standalone SonarMark OTS requirement.
docs/reqstream/ots/reviewmark.yaml	Adds standalone ReviewMark OTS requirement.
docs/reqstream/ots/reqstream.yaml	Adds standalone ReqStream OTS requirement.
docs/reqstream/ots/pandoc.yaml	Adds standalone Pandoc OTS requirement.
docs/reqstream/ots/ots-software.yaml	Removes previous combined OTS requirements file.
docs/reqstream/ots/mstest.yaml	Adds standalone MSTest OTS requirement.
docs/reqstream/ots/fileassert.yaml	Adds standalone FileAssert OTS requirement.
docs/reqstream/ots/buildmark.yaml	Adds standalone BuildMark OTS requirement.
docs/design/title.txt	Updates design doc title metadata.
docs/build_notes/definition.yaml	Cleans up build-notes Pandoc defaults.
build.sh	Removes legacy bash build entrypoint.
build.ps1	Adds PowerShell build+test entrypoint.
build.bat	Removes legacy batch build entrypoint.
DEVELOPMENT.md	Removes developer quick-start doc (superseded elsewhere).
CONTRIBUTING.md	Updates contributor workflow and lint guidance.
AGENTS.md	Updates agent guidance, reporting requirements, and scripts.
.yamllint.yaml	Ignores .agent-logs/ for YAML linting.
.yamlfix.toml	Adds yamlfix configuration aligned to yamllint.
.versionmark.yaml	Updates tool capture definitions (adds sarifmark/fileassert capture).
.markdownlint-cli2.yaml	Minor config doc update (banner suppression note).
.github/workflows/release.yaml	Adjusts release bodyFile path and publish step formatting.
.github/workflows/build_on_push.yaml	Minor formatting tweak to triggers.
.github/workflows/build.yaml	Updates CI to run pwsh lint, expands doc build pipeline, adds FileAssert assertions.
.github/standards/technical-documentation.md	Clarifies recursive subsystem documentation structure.
.github/standards/software-items.md	Adds placeholder naming conventions and nested subsystems.
.github/standards/reviewmark-usage.md	Updates ReviewMark usage (enforce plan, nested subsystems).
.github/standards/reqstream-usage.md	Updates ReqStream standards text and nested structure.
.github/standards/design-documentation.md	Updates design standards for nested subsystems + companion artifacts note.
.github/standards/csharp-testing.md	Minor wording update.
.github/standards/csharp-language.md	Adds guidance to run pwsh ./fix.ps1.
.github/standards/coding-principles.md	Expands literate programming intent-doc guidance.
.github/agents/repo-consistency.agent.md	Aligns reporting requirements with AGENTS.md.
.github/agents/quality.agent.md	Updates quality agent workflow and report template.
.github/agents/lint-fix.agent.md	Adds a dedicated lint-fix agent workflow.
.github/agents/implementation.agent.md	Refines implementation agent state machine and reporting.
.github/agents/formal-review.agent.md	Renames/clarifies formal review agent behavior and steps.
.github/agents/developer.agent.md	Updates developer agent workflow and reporting guidance.
.fileassert.yaml	Adds FileAssert document validation suite definitions.
.cspell.yaml	Revises cspell word list and ignore paths.
.config/dotnet-tools.json	Adds SarifMark and FileAssert as local dotnet tools.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.