Sync compliance docs and lint templates with TemplateDotNetLibrary PR #67 by Copilot · Pull Request #33 · demaconsulting/ContinuousCompliance

Copilot · 2026-03-29T22:01:57Z

Propagates the "extensive agent and lint cleanup" from TemplateDotNetLibrary#67 into the ContinuousCompliance documentation and templates.

Lint templates (`templates/lint/`)

lint.sh / lint.bat: quieter installs and spell-check (--silent, --quiet --disable-pip-version-check, cspell --quiet); npm install and pip install failures now propagate into the lint error flag so the script exits non-zero when dependencies fail to install
.cspell.yaml: exclude **/.agent-logs/** from spell checking
.gitignore: ignore .agent-logs/
.markdownlint-cli2.yaml: replaced AGENT_REPORT_*.md ignore with **/.agent-logs/** to match the new agent-log folder convention

`templates/reviews/`

.reviewmark.yaml: removed --definition flag from USAGE comment; updated output paths from docs/reviewplan/review-plan.md / docs/reviewreport/review-report.md to docs/code_review_plan/plan.md / docs/code_review_report/report.md

`templates/reqstream/`

Added docs/reqstream/system-example.yaml — example software system requirements file covering end-to-end/integration-tested behaviors; requirement IDs follow the Project-System-ShortDescription convention (e.g., TemplateTool-System-Version, TemplateTool-System-ExitCode)
Updated requirements.yaml to include the new system-example.yaml

`docs/agentic.md`

Restructured document: reframed from "how to set up agent guidance files" to "why Continuous Compliance helps agentic development" — opens with the vibe-coding problem, explains the context-window scaling problem, then shows how CC provides layer-by-layer machine-readable context agents can load selectively
Layer table: converted to Pandoc grid-table format so lengthy file-list cells wrap naturally within columns, keeping all source lines under the markdownlint line-length limit
Example AGENTS.md: generic compliance-focused structure pointing agents to requirements.yaml, .reviewmark.yaml, lint configs, and .editorconfig — documents every Continuous Compliance project has, regardless of agent tooling
Additional guidance files: generic description of how projects can place detailed guidance files alongside their code for agents to load when relevant
Agent logs: replaced AGENT_REPORT_*.md scratch-file pattern with .agent-logs/<agent><subject><id>.md folder convention

`docs/requirements.md`

Added Software System as a fourth requirement class (alongside Subsystem/Unit/OTS), covering the complete product boundary tested via integration/end-to-end tests
Added recommended file naming convention: {project}-system.yaml, subsystem-{name}.yaml, unit-{name}.yaml, ots-{component}.yaml
Added link to the new system-example.yaml template file

`docs/file-reviews.md`

Updated .reviewmark.yaml example needs-review to use docs/design/**/*.md instead of **/*.md to avoid matching generated review documents and other unrelated Markdown; removed now-unnecessary exclusions for code_review_plan/code_review_report
Updated all document folder paths to align with the technical-documentation standard: docs/code_review_plan/plan.md and docs/code_review_report/report.md (previously docs/reviewplan/review-plan.md and docs/reviewreport/review-report.md)
Updated folder structure table, directory tree, Pandoc definition.yaml examples, CI/CD integration commands, and Generated Documents examples to use the new paths throughout
Added Standard Review-Set Patterns section documenting the four canonical review-set types, formatted as a Pandoc grid-table so the lengthy "Contents" cells wrap within columns

💬 Send tasks to Copilot coding agent from Slack and Teams to turn conversations into code. Copilot posts an update in your thread when it's finished.

Agent-Logs-Url: https://github.com/demaconsulting/ContinuousCompliance/sessions/98818f20-24d9-45e4-a26f-e0cc315111ef Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

docs/agentic.md

docs/file-reviews.md

… folder names Agent-Logs-Url: https://github.com/demaconsulting/ContinuousCompliance/sessions/6434256e-8582-4d3a-8c56-b2839b10cfcc Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

docs/agentic.md

… up files Agent-Logs-Url: https://github.com/demaconsulting/ContinuousCompliance/sessions/11c005cb-1476-4589-ad62-6fe0e3e7ef4c Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

Copilot

Pull request overview

Propagates updates from TemplateDotNetLibrary#67 into this repo’s lint templates and Continuous Compliance documentation, focusing on quieter lint runs, agent log handling, and updated compliance/review documentation conventions.

Changes:

Quieted lint dependency installs and cspell output in templates/lint/ scripts.
Updated lint/spellcheck ignore rules to exclude .agent-logs/.
Refreshed documentation for agentic workflows, requirement classes (adding “Software System”), and ReviewMark/review document path conventions.

Reviewed changes

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

Show a summary per file

File	Description
templates/lint/lint.sh	Makes npm/pip installs quieter; runs cspell with `--quiet`.
templates/lint/lint.bat	Same as `lint.sh` for Windows batch usage.
templates/lint/.gitignore	Adds `.agent-logs/` to ignored paths.
templates/lint/.cspell.yaml	Excludes `/.agent-logs/` from spell checking.
docs/requirements.md	Adds “Software System” requirement class and recommends naming conventions including `{project}-system.yaml`.
docs/file-reviews.md	Updates ReviewMark examples (needs-review patterns, review-set patterns, and new `docs/code_review_*` output paths).
docs/agentic.md	Restructures agent guidance narrative; switches agent report convention to `.agent-logs/`.

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

docs/file-reviews.md

docs/requirements.md

docs/agentic.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Malcolmnixon · 2026-03-29T23:14:18Z

@copilot apply changes based on the comments in this thread

…eeds-review pattern, system example Agent-Logs-Url: https://github.com/demaconsulting/ContinuousCompliance/sessions/c5e511f3-b4e6-470f-b626-144b501314d6 Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

Copilot · 2026-03-29T23:18:11Z

@copilot apply changes based on the comments in this thread

All changes from the review thread applied in commit 061e946: markdownlint now ignores .agent-logs/**; .reviewmark.yaml template uses the updated paths; needs-review example uses docs/design/**/*.md; system-level requirements example added.

Copilot

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 7 comments.

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

templates/lint/lint.bat

docs/file-reviews.md

docs/agentic.md

docs/file-reviews.md

templates/lint/lint.sh

templates/lint/lint.bat

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Malcolmnixon · 2026-03-29T23:32:09Z

@copilot apply changes based on the comments in this thread

…to lint scripts Agent-Logs-Url: https://github.com/demaconsulting/ContinuousCompliance/sessions/f6b32da2-e179-4dde-a0e5-b6bf6748986a Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

Copilot · 2026-03-29T23:37:36Z

@copilot apply changes based on the comments in this thread

All changes from the review thread applied in commit c7c66a5: both long tables converted to grid-table format, and npm install / pip install in lint.sh and lint.bat now propagate errors into the lint error flag.

Copilot

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 3 comments.

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

templates/lint/lint.bat

templates/reqstream/docs/reqstream/system-example.yaml

Malcolmnixon · 2026-03-30T00:06:18Z

@copilot apply changes based on the comments in this thread

Agent-Logs-Url: https://github.com/demaconsulting/ContinuousCompliance/sessions/82ecfc8d-8f6c-4af6-a814-b81f9e30055e Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

Copilot · 2026-03-30T00:32:46Z

@copilot apply changes based on the comments in this thread

Updated system-example.yaml in commit 3faf281 — requirement IDs now follow the Project-System-ShortDescription convention: TemplateTool-System-Version and TemplateTool-System-ExitCode.

Initial plan

d32a098

Copilot AI assigned Copilot and Malcolmnixon Mar 29, 2026

Copilot started work on behalf of Malcolmnixon March 29, 2026 22:02 View session

Copilot AI changed the title ~~[WIP] Update continuous compliance documentation and templates~~ Sync compliance docs and lint templates with TemplateDotNetLibrary PR #67 Mar 29, 2026

Copilot AI requested a review from Malcolmnixon March 29, 2026 22:09

Copilot finished work on behalf of Malcolmnixon March 29, 2026 22:09

Malcolmnixon requested changes Mar 29, 2026

View reviewed changes

Copilot started work on behalf of Malcolmnixon March 29, 2026 22:16 View session

Copilot finished work on behalf of Malcolmnixon March 29, 2026 22:23

Copilot AI requested a review from Malcolmnixon March 29, 2026 22:24

Malcolmnixon requested changes Mar 29, 2026

View reviewed changes

docs/agentic.md Outdated Show resolved Hide resolved

Copilot started work on behalf of Malcolmnixon March 29, 2026 22:32 View session

Copilot finished work on behalf of Malcolmnixon March 29, 2026 22:36

Copilot AI requested a review from Malcolmnixon March 29, 2026 22:36

Malcolmnixon approved these changes Mar 29, 2026

View reviewed changes

Malcolmnixon marked this pull request as ready for review March 29, 2026 22:55

Copilot AI review requested due to automatic review settings March 29, 2026 22:55

Copilot started reviewing on behalf of Malcolmnixon March 29, 2026 22:55 View session

Copilot AI reviewed Mar 29, 2026

View reviewed changes

docs/file-reviews.md Outdated Show resolved Hide resolved

docs/file-reviews.md Outdated Show resolved Hide resolved

docs/file-reviews.md Show resolved Hide resolved

docs/requirements.md Show resolved Hide resolved

docs/agentic.md Show resolved Hide resolved

Update docs/file-reviews.md

22d3174

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot started work on behalf of Malcolmnixon March 29, 2026 23:14 View session

Copilot finished work on behalf of Malcolmnixon March 29, 2026 23:19

Copilot AI requested a review from Malcolmnixon March 29, 2026 23:19

Malcolmnixon requested a review from Copilot March 29, 2026 23:20

Copilot started reviewing on behalf of Malcolmnixon March 29, 2026 23:20 View session

Copilot AI reviewed Mar 29, 2026

View reviewed changes

Update docs/file-reviews.md

0c054f5

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot started work on behalf of Malcolmnixon March 29, 2026 23:32 View session

Copilot finished work on behalf of Malcolmnixon March 29, 2026 23:38

Malcolmnixon requested a review from Copilot March 29, 2026 23:49

Copilot started reviewing on behalf of Malcolmnixon March 29, 2026 23:49 View session

Copilot AI reviewed Mar 29, 2026

View reviewed changes

templates/lint/lint.bat Show resolved Hide resolved

templates/reqstream/docs/reqstream/system-example.yaml Outdated Show resolved Hide resolved

templates/reqstream/docs/reqstream/system-example.yaml Outdated Show resolved Hide resolved

Copilot started work on behalf of Malcolmnixon March 30, 2026 00:06 View session

Copilot finished work on behalf of Malcolmnixon March 30, 2026 00:35

Malcolmnixon approved these changes Mar 30, 2026

View reviewed changes

Malcolmnixon merged commit c80a4f1 into main Mar 30, 2026

Malcolmnixon deleted the copilot/update-compliance-documentation-templates branch March 30, 2026 00:36

Conversation

Copilot AI commented Mar 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Lint templates (templates/lint/)

templates/reviews/

templates/reqstream/

docs/agentic.md

docs/requirements.md

docs/file-reviews.md

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

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!

Malcolmnixon commented Mar 29, 2026

Uh oh!

Copilot AI commented Mar 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!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Malcolmnixon commented Mar 29, 2026

Uh oh!

Copilot AI commented Mar 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!

Uh oh!

Malcolmnixon commented Mar 30, 2026

Uh oh!

Copilot AI commented Mar 30, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented Mar 29, 2026 •

edited

Loading

Lint templates (`templates/lint/`)

`templates/reviews/`

`templates/reqstream/`

`docs/agentic.md`

`docs/requirements.md`

`docs/file-reviews.md`