Add AI-readiness Tier 1 baseline - #1482
Open
Courtenay Bernier (courtenaybernier) wants to merge 1 commit into
Open
Add AI-readiness Tier 1 baseline#1482Courtenay Bernier (courtenaybernier) wants to merge 1 commit into
Courtenay Bernier (courtenaybernier) wants to merge 1 commit into
Conversation
Add repository guidance, conventions, telemetry instructions, and a one-command verification loop. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 5df16e8f-b879-4c72-b87d-9a9d476fd7fa
Copilot started reviewing on behalf of
Courtenay Bernier (courtenaybernier)
August 4, 2026 20:09
View session
Contributor
There was a problem hiding this comment.
Pull request overview
Adds Tier-1 “AI-readiness” baseline artifacts (repo router + conventions docs + telemetry instructions + a lightweight verification script) to make contribution guidance and validation more discoverable in this repo.
Changes:
- Added
AGENTS.mdas the top-level entry point/router for humans and coding agents. - Added repository conventions documentation and PR/work-item telemetry instruction guidance.
- Added
scripts/verify.ps1to provide a simple local verification loop (syntax/config checks + Pester presence hint).
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 4 comments.
| File | Description |
|---|---|
scripts/verify.ps1 |
Adds a verification script to parse-check PowerShell files and validate .psd1 config files. |
docs/conventions.md |
Documents repository layout/authoring/validation conventions. |
AGENTS.md |
Provides a repo “router”/map and Definition of Done commands. |
.github/instructions/telemetry.instructions.md |
Adds canonical telemetry tagging instructions for PRs and ADO work items. |
Comment on lines
+9
to
+13
| Write-Host '== Syntax check: src PowerShell ==' | ||
| $targets = @( | ||
| Get-ChildItem -Path (Join-Path $root 'src') -Recurse -File -Filter *.ps1 ` | ||
| -ErrorAction SilentlyContinue | ||
| ) |
Comment on lines
+39
to
+43
| Write-Host '== Config check: build PowerShell data files ==' | ||
| $configFiles = @( | ||
| Get-ChildItem -Path (Join-Path $root 'build') -Recurse -File -Filter *.psd1 ` | ||
| -ErrorAction SilentlyContinue | ||
| ) |
Comment on lines
+11
to
+15
| | `src/powershell/` | Module source and dependency initialization. | | ||
| | `src/documentgenerator/` | Report and document-generation assets. | | ||
| | `build/` | Build pipeline, configuration, and helpers. | | ||
| | `code-tests/` | Pester commands, structure gates, and assessment tests. | | ||
| | `.github/skills/` | Repository-specific agent skills. | |
Comment on lines
+7
to
+10
| - `src/powershell/` contains module source. | ||
| - `src/documentgenerator/` contains report-generation assets. | ||
| - `build/` contains the build pipeline and configuration. | ||
| - `code-tests/commands/` contains command tests. |
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
Adds the missing CXE AI-readiness Tier-1 baseline artifacts:
AGENTS.mdrepository routerdocs/conventions.md.github/instructions/telemetry.instructions.mdscripts/verify.ps1one-command verification loopThe existing
.github/copilot-instructions.mdand.github/skills/content are preserved. This is additive documentation and validation scaffolding only; no product behavior changes.Validation
pwsh scripts/verify.ps1assistance: agentic-cli
type: docs
agent-tool: copilot-cli
agent-model: gpt-5.6-sol
work-item: AB#n/a