Add root-tags orphan detection for requirements traceability - #126
Merged
Conversation
- Bump demaconsulting.reqstream tool to 1.11.0 - Tag all 9 Template-Lib-* system requirements and all 7 Template-Platform-* platform requirements with [system] - Add docs/reqstream/quality.yaml grouping the repository's OTS process tooling (xUnit, ReqStream, BuildMark, VersionMark, SarifMark, SonarMark, ReviewMark, Pandoc, WeasyPrint, FileAssert, SysML2Tools) under [quality] tags so they are not reported as orphans - Add root-tags: [system, quality] to requirements.yaml so 'dotnet reqstream --requirements requirements.yaml --enforce' detects requirements not traceable to product-level functionality - Verified 0 orphans of 45 requirements after changes (no genuine traceability gaps found; all orphans were OTS process tooling) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
🟢 Approval recommended
The changes are consistent, the new references resolve to existing OTS requirement IDs, and the update is low-risk configuration/tagging that supports traceability enforcement.
Pull request overview
This PR updates the repository’s ReqStream requirements-traceability configuration to use root-tag–based orphan detection, ensuring that both user-facing system requirements and OTS/tooling-derived quality requirements participate in orphan detection without producing false positives.
Changes:
- Added
root-tags: [system, quality]and included a new quality-grouping requirements file inrequirements.yaml. - Tagged existing system and platform requirements with
[system]so they act as traceability roots. - Added
docs/reqstream/quality.yamlto group OTS process-tooling requirements under a[quality]root and bumpeddemaconsulting.reqstreamto1.11.0.
File summaries
| File | Description |
|---|---|
| requirements.yaml | Adds root-tags and includes the new quality requirements file for orphan detection. |
| docs/reqstream/template-dot-net-library.yaml | Tags system-level library requirements with [system] to serve as traceability roots. |
| docs/reqstream/template-dot-net-library/platform-requirements.yaml | Tags platform requirements with [system] so platform traceability is rooted. |
| docs/reqstream/quality.yaml | Introduces [quality]-tagged grouping requirements linking OTS/tooling requirements to a non-system root. |
| .config/dotnet-tools.json | Bumps demaconsulting.reqstream tool version to 1.11.0. |
Review details
- Files reviewed: 5/5 changed files
- Comments generated: 0
- Review effort level: Lite
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Applies the root-tags orphan-detection pattern (established across sibling DemaConsulting repos) to TemplateDotNetLibrary's requirements traceability.
oot-tags: [system, quality] to
equirements.yaml.
No genuine traceability gaps were found in this repository — every non-OTS requirement was already correctly linked up to the system root.
Validation
Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com