Skip to content

Add OSS compliance headers and agentic-readiness scaffolding - #34

Merged
Neil Johnson (theneiljohnson) merged 2 commits into
mainfrom
chore/oss-compliance-and-agentic-readiness
Jul 3, 2026
Merged

Add OSS compliance headers and agentic-readiness scaffolding#34
Neil Johnson (theneiljohnson) merged 2 commits into
mainfrom
chore/oss-compliance-and-agentic-readiness

Conversation

@theneiljohnson

Copy link
Copy Markdown
Collaborator

Description

Improves the repository's OSS compliance posture and adds the Tier-1 "agentic-readiness" scaffolding identified in a compliance audit. No sample behaviour changes — headers, docs, and tooling only.

Compliance

  • Add the standard Microsoft .COPYRIGHT header to all PowerShell samples that were missing it (56 files) and move the header to the top of 2 files where it sat below the imports. All 63 .ps1 files now carry the header.
  • Add CONTRIBUTING.md (also fixes the broken CONTRIBUTING.MD reference in the README), .gitignore, .github/CODEOWNERS (placeholder — real owners still need to be set), and .github/dependabot.yml.

Agentic readiness

  • AGENTS.md, .github/copilot-instructions.md, docs/conventions.md, docs/testing-patterns.md.
  • scripts/verify.ps1 — one-command PSScriptAnalyzer lint + copyright-header check.
  • .github/pull_request_template.md and .github/workflows/ci.yml (runs verify.ps1 on PRs).

Type of change

  • Documentation
  • Repository tooling / CI
  • New sample script
  • Fix to an existing sample

Checklist

  • I ran ./scripts/verify.ps1 and it passes (63/63 headers, 0 PSScriptAnalyzer errors).
  • New .ps1 files include the standard copyright header (scripts/verify.ps1).
  • Scripts import only the specific Microsoft.Graph* submodule(s) they need — N/A, no sample logic changed.
  • No secrets, tenant IDs, or exported tenant data are committed.
  • Tested against a non-production ("test") tenant — N/A, no functional sample change.
  • Small and focused — intentionally a single broad compliance/readiness pass.
  • I followed docs/conventions.md.

Note: main branch protection (require PR + 1 approving review) was enabled alongside this change.

- Add the standard Microsoft copyright header to all PowerShell samples
  (56 files) and move the header to the top of 2 existing files.
- Add contributor/governance files: CONTRIBUTING.md, .gitignore,
  .github/CODEOWNERS, .github/dependabot.yml, .github/pull_request_template.md.
- Add agentic-readiness docs and tooling: AGENTS.md,
  .github/copilot-instructions.md, docs/conventions.md, docs/testing-patterns.md,
  scripts/verify.ps1, and a CI workflow that runs it on PRs.
- Fix the CONTRIBUTING link in README.md.

Verified with scripts/verify.ps1: 63/63 files carry the copyright header and
PSScriptAnalyzer reports no errors.
@theneiljohnson
Neil Johnson (theneiljohnson) merged commit 608f553 into main Jul 3, 2026
1 check passed
@theneiljohnson
Neil Johnson (theneiljohnson) deleted the chore/oss-compliance-and-agentic-readiness branch July 3, 2026 10:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant