Agent updates next by Malcolmnixon · Pull Request #95 · demaconsulting/TemplateDotNetLibrary

Malcolmnixon · 2026-04-29T13:59:36Z

Pull Request

Description

Numerous agent updates and improvements to the repository.

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
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: pwsh ./lint.ps1 (cross-platform)

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 reorganizes documentation build outputs into generated/ folders and updates CI/lint/standards to treat those artifacts as build outputs that should not be edited or linted.

Changes:

Update Pandoc definition.yaml files to consume generated report sections from */generated/ paths.
Update the build-docs GitHub Actions workflow and .fileassert.yaml to write and validate HTML/PDF/report artifacts in the new generated/ locations (with final PDFs in docs/generated/).
Update agent guidance and linter/spellcheck configs to exclude generated/ output folders; simplify .gitignore rules accordingly.

Reviewed changes

Copilot reviewed 16 out of 17 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
docs/requirements_report/definition.yaml	Switch trace matrix input to generated output path.
docs/requirements_doc/definition.yaml	Switch requirements/justifications inputs to generated output paths.
docs/code_review_report/definition.yaml	Switch review report input to generated output path.
docs/code_review_plan/definition.yaml	Switch review plan input to generated output path.
docs/code_quality/definition.yaml	Switch CodeQL/Sonar report inputs to generated output paths.
docs/build_notes/definition.yaml	Switch build notes + tool versions inputs to generated output paths.
AGENTS.md	Add “no generated file access” rule for agents.
.yamllint.yaml	Attempt to ignore generated outputs from yamllint.
.markdownlint-cli2.yaml	Ignore `/generated/` for markdownlint.
.gitignore	Replace specific doc output ignores with a blanket `**/generated/` ignore.
.github/workflows/build.yaml	Write doc artifacts into `generated/` folders and upload from `docs/generated/*`.
.github/standards/technical-documentation.md	Update documentation structure guidance and generated-file rules.
.github/standards/requirements-principles.md	Clarify “unit name vs internal construction” guidance.
.github/standards/design-documentation.md	Add references guidance and ban markdown hyperlinks for cross-refs.
.github/agents/lint-fix.agent.md	Add guidance for handling wide markdown tables under MD013.
.fileassert.yaml	Update expected artifact paths to new generated locations.
.cspell.yaml	Ignore `/generated/` for spellchecking.

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

Malcolmnixon · 2026-04-29T14:57:54Z

@copilot apply changes based on the comments in this thread

…th **/ prefix Agent-Logs-Url: https://github.com/demaconsulting/TemplateDotNetLibrary/sessions/d499b75c-4829-4cd0-b90c-4225affb6ef3 Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 16 out of 17 changed files in this pull request and generated 2 comments.

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

Malcolmnixon · 2026-04-29T15:13:15Z

@copilot apply changes based on the comments in this thread

…rated/ for artifacts Agent-Logs-Url: https://github.com/demaconsulting/TemplateDotNetLibrary/sessions/6085cad4-0084-4249-9a4a-e0dac8b7a61e Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 16 out of 17 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.

Copilot

Pull request overview

Copilot reviewed 18 out of 19 changed files in this pull request and generated 2 comments.

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

Malcolmnixon · 2026-04-29T16:00:51Z

@copilot apply changes based on the comments in this thread

…on.md Agent-Logs-Url: https://github.com/demaconsulting/TemplateDotNetLibrary/sessions/d583dc38-0bbd-4d4c-9cc6-816a7301bd44 Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

Copilot · 2026-04-29T16:03:41Z

@copilot apply changes based on the comments in this thread

Both changes applied in b4617e8:

technical-documentation.md: {section}.md now described as "zero or more" (optional)
design-documentation.md: References section guidance now explicitly points to introduction.md

Copilot

Pull request overview

Copilot reviewed 18 out of 19 changed files in this pull request and generated 2 comments.

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

Malcolmnixon · 2026-04-29T18:55:54Z

@copilot apply changes based on the comments in this thread

Agent-Logs-Url: https://github.com/demaconsulting/TemplateDotNetLibrary/sessions/f201ab29-7bd3-4e21-af10-202c3306371c Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

Copilot · 2026-04-29T18:58:35Z

@copilot apply changes based on the comments in this thread

Done in 3fe871a — both reviewmark-usage.md and reqstream-usage.md now reference the generated/ subfolders for all tool output paths.

Malcolmnixon added 2 commits April 27, 2026 11:49

Minor fixes and improvements to standards and agents.

dc43e26

Simplify handling of generated markdown files.

ea1484d

Copilot AI review requested due to automatic review settings April 29, 2026 13:59

Copilot started reviewing on behalf of Malcolmnixon April 29, 2026 14:00 View session

Copilot AI reviewed Apr 29, 2026

View reviewed changes

Copilot started work on behalf of Malcolmnixon April 29, 2026 14:58 View session

Add shell: bash to mkdir -p steps; update yamllint ignore patterns wi…

6256325

…th **/ prefix Agent-Logs-Url: https://github.com/demaconsulting/TemplateDotNetLibrary/sessions/d499b75c-4829-4cd0-b90c-4225affb6ef3 Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

Copilot finished work on behalf of Malcolmnixon April 29, 2026 15:03

Malcolmnixon requested a review from Copilot April 29, 2026 15:04

Copilot started reviewing on behalf of Malcolmnixon April 29, 2026 15:05 View session

Copilot AI reviewed Apr 29, 2026

View reviewed changes

Comment thread docs/build_notes/definition.yaml Outdated

Comment thread .github/workflows/build.yaml Outdated

Copilot started work on behalf of Malcolmnixon April 29, 2026 15:13 View session

Copilot finished work on behalf of Malcolmnixon April 29, 2026 15:17

Malcolmnixon requested a review from Copilot April 29, 2026 15:17

Copilot AI reviewed Apr 29, 2026

View reviewed changes

Modifications to push for friendlier API documentation.

8009991

Malcolmnixon requested a review from Copilot April 29, 2026 15:46

Copilot started reviewing on behalf of Malcolmnixon April 29, 2026 15:46 View session

Copilot AI reviewed Apr 29, 2026

View reviewed changes

Comment thread .github/standards/technical-documentation.md

Comment thread .github/standards/design-documentation.md Outdated

Copilot started work on behalf of Malcolmnixon April 29, 2026 16:01 View session

Clarify {section}.md is optional and References belongs in introducti…

b4617e8

…on.md Agent-Logs-Url: https://github.com/demaconsulting/TemplateDotNetLibrary/sessions/d583dc38-0bbd-4d4c-9cc6-816a7301bd44 Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

Copilot finished work on behalf of Malcolmnixon April 29, 2026 16:06

Malcolmnixon requested a review from Copilot April 29, 2026 16:39

Copilot started reviewing on behalf of Malcolmnixon April 29, 2026 16:40 View session

Copilot AI reviewed Apr 29, 2026

View reviewed changes

Comment thread .github/workflows/build.yaml

Comment thread .github/workflows/build.yaml

Copilot started work on behalf of Malcolmnixon April 29, 2026 18:56 View session

Update reviewmark-usage.md and reqstream-usage.md with generated/ paths

3fe871a

Agent-Logs-Url: https://github.com/demaconsulting/TemplateDotNetLibrary/sessions/f201ab29-7bd3-4e21-af10-202c3306371c Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

Copilot finished work on behalf of Malcolmnixon April 29, 2026 18:59

Malcolmnixon merged commit 81cfe93 into main Apr 29, 2026
6 checks passed

Malcolmnixon deleted the agent-updates-next branch April 29, 2026 22:00

Uh oh!

Conversation

Malcolmnixon commented Apr 29, 2026

Pull Request

Description

Type of Change

Related Issues

Pre-Submission Checklist

Build and Test

Code Quality

Quality Checks

Testing

Documentation

Additional Notes

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Malcolmnixon commented Apr 29, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Malcolmnixon commented Apr 29, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Malcolmnixon commented Apr 29, 2026

Uh oh!

Copilot AI commented Apr 29, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Malcolmnixon commented Apr 29, 2026

Uh oh!

Copilot AI commented Apr 29, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants