[Cj-Scott]

Summary

• Make AGENTS.md the single master entry point with an explicit authority map and links to detailed guidance.
• Move the existing Copilot instructions into docs/conventions.md, preserve deployment safeguards and commands, and reduce .github/copilot-instructions.md to a pointer.
• Document static-versus-pilot validation boundaries and include a scoped Responsible AI review. Product scripts, configuration, and canonical telemetry instructions are unchanged.

Readiness evidence

The direct review against the NPF plugin's published Tier 1 criteria found duplicated context (criterion 2). This change removes that duplication while keeping verification and coverage guidance reachable from the root (criteria 5 and 11). This is not a completed 40-criterion plugin scan or published tracker telemetry. Re-scan the merged default branch before preparing the tracker payload.

Validation

• Maintainer quality gate: passed, zero errors and warnings.
• pwsh -NoProfile -File .\scripts\verify.ps1: passed; 11 PowerShell files parsed and PurviewConfig.psd1 validated.
• Changed-document local links and section anchors resolve.
• Original detailed instructions preserved apart from the replaced title and validation introduction.
• Canonical telemetry file unchanged; git diff --check passed.
• No tenant calls or pilot validation; this change only reorganizes documentation.

Branch routing and review

The documented staging branch does not exist on origin. The repository owner explicitly approved targeting main for this adoption PR. Human review and merge approval remain required; no telemetry has been published.

source-skill: smb-best-practice-maintainer (direct adoption using NPF published criteria)
source-org: cxe
model: gpt-6-astra
tokens-consumed: input=unknown, output=unknown, total=unknown

assistance: agentic-cli
type: docs
agent-tool: copilot-cli
agent-model: gpt-6-astra
work-item: AB#n/a

[Copilot]

Copilot review overview

🟡 Changes recommended

Unresolved issues remain in WhatIf connection guidance and branch-routing instructions.

Get a fresh assessment by requesting another Copilot review.

Review effort: Lite
Findings: 2

Open (2)

• WhatIf still performs live authentication and service connections · New
• Workflow requires nonexistent staging branch · New

What changed in this PR

This documentation-only PR consolidates Tier 1 agent guidance under AGENTS.md.

Changes:

• Centralizes detailed conventions in docs/conventions.md.
• Reduces Copilot instructions to a pointer.
• Adds a scoped Responsible AI review.

File	Summary
docs/​Responsible-AI-Review.md	Documents the scoped Responsible AI assessment.
docs/​conventions.md	Centralizes repository, validation, architecture, and workflow guidance.
AGENTS.md	Defines the master guidance entry point and authority map.
.github/​copilot-instructions.md	Redirects users to AGENTS.md.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Copilot review overview

🔵 Needs a closer look

Update the canonical workflow to remove the nonexistent staging branch reference.

Review effort: Lite
Findings: 1

Open (1)

• Workflow requires nonexistent staging branch

Resolved since last review (1)

• WhatIf still performs live authentication and service connections

[Copilot]

Copilot review overview

🔵 Needs a closer look

Resolve the documented guidance inconsistencies before approval.

Review effort: Lite
Findings: None

Resolved since last review (1)

• Workflow requires nonexistent staging branch