Add PowerShell contributor workflows for guide content and translations

[MrHinsh]

Summary

• Add guide content inventory and editing commands with documented contributor workflows.
• Add translation readiness, reconciliation, and wrapper translation workflows.
• Update agent skills, module exports, documentation, and workflow guidance.
• Add command-boundary, content-editing, and translation workflow coverage.

Testing

• Added automated PowerShell tests covering command boundaries, content editing, and translation workflows.
• Not run (not requested).

Summary by CodeRabbit

• New Features

  • Added workflows for correcting source-language guide content and creating, validating and updating translations.
  • Added safeguards using content checksums, protected-resource checks and preview-only planning.
  • Added translation readiness and reconciliation guidance, including edition-specific availability and source revision comparisons.
  • Added end-to-end contributor workflow validation, including preview and production builds.

• Documentation

  • Expanded contributor and publishing guidance for content editing, translation workflows and verification.

• Tests

  • Added coverage for content updates, translation lifecycle operations, edition boundaries and protected files.

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-09-19T12:07:41.565823Z	50a3fe2	PR opened

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

[coderabbitai]

Note

Currently processing new changes in this PR. This may take a few minutes, please wait...

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: cc02ca20-43b0-42c1-b719-836282b46b68

📥 Commits

Reviewing files that changed from the base of the PR and between 8d544eb and 50a3fe2.

📒 Files selected for processing (20)

• system/OpenGuidePlatform.Agents.Integration/instructions/guide-site.md
• system/OpenGuidePlatform.Agents.Integration/skills/USAGE.md
• system/OpenGuidePlatform.Agents.Integration/skills/guide.transcreate/SKILL.md
• system/OpenGuidePlatform.Agents.Integration/skills/guide.transreconcile/SKILL.md
• system/OpenGuidePlatform.PowerShell.Core/ContentEditing/Set-GuideContent.ps1
• system/OpenGuidePlatform.PowerShell.Core/GuideInventory/Get-GuideContent.ps1
• system/OpenGuidePlatform.PowerShell.Core/Internal/GuideDocuments.ps1
• system/OpenGuidePlatform.PowerShell.Core/OpenGuidePlatform.PowerShell.Core.psd1
• system/OpenGuidePlatform.PowerShell.Core/OpenGuidePlatform.PowerShell.Core.psm1
• system/OpenGuidePlatform.PowerShell.Core/README.md
• system/OpenGuidePlatform.PowerShell.Core/TranslationReadiness/Edit-GuideTranslation.ps1
• system/OpenGuidePlatform.PowerShell.Core/TranslationReadiness/Get-GuideTranslationWork.ps1
• system/OpenGuidePlatform.PowerShell.Core/TranslationReadiness/README.md
• system/OpenGuidePlatform.PowerShell.Core/TranslationReadiness/Set-GuideWrapperTranslation.ps1
• system/OpenGuidePlatform.PowerShell.PlatformBuild/OpenGuidePlatform.PowerShell.PlatformBuild.psm1
• system/OpenGuidePlatform.PowerShell.PlatformBuild/README.md
• system/OpenGuidePlatform.PowerShell.PlatformBuild/Testing/Test-ContributorWorkflow.ps1
• tests/Core/CommandBoundaries.Tests.ps1
• tests/Core/ContentEditing.Tests.ps1
• tests/Core/TranslationWorkflows.Tests.ps1

 _____________________________________________________________________________________________________
< Write code that writes code. Code generators increase your productivity and help avoid duplication. >
 -----------------------------------------------------------------------------------------------------
  \
   \   \
        \ /\
        ( )
      .( o ).

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Commit to this branch
• Create a new PR

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

Prepare completed. Workflow evidence. This is the candidate assessment, not independent policy or deployment approval.

Prepare: pass

Commit: 50a3fe2 · Platform: 1.1.0-PullRequest53.14 · Target: canary

Selection: v1.1.0-PullRequest53.14; resolved: v1.1.0-PullRequest53.14; OGP ring: preview.

Severity	Scope	Subject	Finding	What to fix
warning	platform	github.com/nkdAgility/OpenGuidePlatform/system/OpenGuidePlatform.Hugo.Guides	MODULE_FRESHNESS_UNAVAILABLE: Could not establish module freshness: Go module query failed (1): go: module github.com/nkdAgility/OpenGuidePlatform/system/OpenGuidePlatform.Hugo.Guides: not a known dependency	Review the module version through the coordinated platform update process; never change the pin during Prepare.

Guide status

No guide fixes identified by these checks.

Artifact and live-site checks run in later stages.

[github-actions]

Preview deployed for commit 50a3fe2: https://blue-field-06cea8c03-53.westeurope.6.azurestaticapps.net/. Live verification follows in Actions.

[Copilot]

Copilot review overview

🔵 Needs a closer look

The contributor acceptance workflow has two unresolved moderate issues.

Review effort: Lite
Findings: None

What changed in this PR

Adds PowerShell workflows for guide content editing, translation readiness/reconciliation, and packaged contributor validation.

Changes:

• Adds content inventory, editing, and translation commands.
• Updates exports, documentation, agent skills, and site guidance.
• Adds Pester coverage and packaged workflow acceptance tests.

File	Reviewed changes
tests/​Core/​TranslationWorkflows.Tests.ps1	Translation workflow coverage
tests/​Core/​ContentEditing.Tests.ps1	Content editing coverage
tests/​Core/​CommandBoundaries.Tests.ps1	Command boundary coverage
system/​OpenGuidePlatform.PowerShell.PlatformBuild/​Testing/​Test-ContributorWorkflow.ps1	Packaged contributor acceptance
system/​OpenGuidePlatform.PowerShell.PlatformBuild/​README.md	Contributor acceptance documentation
system/​OpenGuidePlatform.PowerShell.PlatformBuild/​OpenGuidePlatform.PowerShell.PlatformBuild.psm1	Contributor acceptance integration
system/​OpenGuidePlatform.PowerShell.Core/​TranslationReadiness/​Set-GuideWrapperTranslation.ps1	Shared translation value comparison
system/​OpenGuidePlatform.PowerShell.Core/​TranslationReadiness/​README.md	Translation workflow documentation
system/​OpenGuidePlatform.PowerShell.Core/​TranslationReadiness/​Get-GuideTranslationWork.ps1	Translation readiness inspection
system/​OpenGuidePlatform.PowerShell.Core/​TranslationReadiness/​Edit-GuideTranslation.ps1	Translation creation and validation
system/​OpenGuidePlatform.PowerShell.Core/​README.md	Core workflow documentation
system/​OpenGuidePlatform.PowerShell.Core/​OpenGuidePlatform.PowerShell.Core.psm1	Loads new Core functionality
system/​OpenGuidePlatform.PowerShell.Core/​OpenGuidePlatform.PowerShell.Core.psd1	Exports new commands
system/​OpenGuidePlatform.PowerShell.Core/​Internal/​GuideDocuments.ps1	Document and safe-write helpers
system/​OpenGuidePlatform.PowerShell.Core/​GuideInventory/​Get-GuideContent.ps1	Guide content inventory
system/​OpenGuidePlatform.PowerShell.Core/​ContentEditing/​Set-GuideContent.ps1	Reviewed source content editing
system/​OpenGuidePlatform.Agents.Integration/​skills/​USAGE.md	Shared workflow guidance
system/​OpenGuidePlatform.Agents.Integration/​skills/​guide.transreconcile/​SKILL.md	Translation reconciliation guidance
system/​OpenGuidePlatform.Agents.Integration/​skills/​guide.transcreate/​SKILL.md	Translation creation guidance
system/​OpenGuidePlatform.Agents.Integration/​instructions/​guide-site.md	Guide-site editing instructions

---

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