Skip to content

Update standards#77

Merged
Malcolmnixon merged 4 commits intomainfrom
agent-standards-refinement
Apr 1, 2026
Merged

Update standards#77
Malcolmnixon merged 4 commits intomainfrom
agent-standards-refinement

Conversation

@Malcolmnixon
Copy link
Copy Markdown
Member

Updated standards, clarified quality reports, and adjusted repositoryto align with new standards.

Pull Request

Description

Update agent standards

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

N/A

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
  • 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

N/A

Copilot AI review requested due to automatic review settings April 1, 2026 02:51
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the repository’s Continuous Compliance documentation and requirements organization to align with updated standards, including a new system requirements source and a structured OTS requirements layout.

Changes:

  • Reorganized requirements sources (system + OTS) and updated root requirements.yaml includes accordingly.
  • Added new standards/docs for design documentation plus a new docs/design/system.md system design artifact.
  • Updated agent and ReviewMark/ReqStream standards to reflect revised conventions and reporting templates.

Reviewed changes

Copilot reviewed 10 out of 18 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
requirements.yaml Switches includes to docs/reqstream/system.yaml and new docs/reqstream/ots/*.yaml layout.
docs/reqstream/system.yaml Adds system-level requirements (API + validation) with test linkages.
docs/reqstream/ots/mstest.yaml Adds OTS requirements for MSTest with evidence test names.
docs/reqstream/ots/reqstream.yaml Adds OTS requirements for ReqStream enforcement behavior.
docs/reqstream/ots/buildmark.yaml Adds OTS requirements for BuildMark report generation.
docs/reqstream/ots/versionmark.yaml Adds OTS requirements for VersionMark version capture/reporting.
docs/reqstream/ots/sarifmark.yaml Adds OTS requirements for SarifMark SARIF-to-markdown conversion.
docs/reqstream/ots/sonarmark.yaml Adds OTS requirements for SonarMark SonarCloud reporting.
docs/reqstream/ots/reviewmark.yaml Adds OTS requirements for ReviewMark plan/report generation.
docs/design/system.md Introduces a system-level design document for the template library.
AGENTS.md Updates agent standards list and removes @-style invocation wording.
.reviewmark.yaml Updates review-set paths to use docs/reqstream/system.yaml and includes docs/design/system.md.
.github/standards/technical-documentation.md Updates documented folder conventions for design/requirements/OTS organization.
.github/standards/reviewmark-usage.md Updates ReviewMark usage guidance, examples, and command section.
.github/standards/reqstream-usage.md Updates ReqStream organization guidance (mirroring source structure + OTS folder).
.github/standards/design-documentation.md Adds new design documentation standard defining required structure/content.
.github/agents/quality.agent.md Replaces checklist-style guidance with a structured reporting template.
.github/agents/implementation.agent.md Updates agent invocation wording to remove @ prefixes.

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

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings April 1, 2026 03:01
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

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


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

@Malcolmnixon Malcolmnixon merged commit 5e32111 into main Apr 1, 2026
6 checks passed
@Malcolmnixon Malcolmnixon deleted the agent-standards-refinement branch April 1, 2026 03:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants