From a2c27bbf7f67ec737714b9d1c1e4276066a017cc Mon Sep 17 00:00:00 2001 From: Kristopher Turner Date: Thu, 16 Jul 2026 13:20:03 -0400 Subject: [PATCH] docs(standards): add PMO board overlay AB#4945 --- docs/standards/index.md | 1 + docs/standards/project-management.md | 34 ++++++++++++++++++++++++++++ 2 files changed, 35 insertions(+) create mode 100644 docs/standards/project-management.md diff --git a/docs/standards/index.md b/docs/standards/index.md index f2567b3..d213f6b 100644 --- a/docs/standards/index.md +++ b/docs/standards/index.md @@ -21,6 +21,7 @@ This repository follows the **org-wide AzureLocal standards** maintained on the |----------|-----------|------------------| | Documentation | [Documentation Standards](documentation) | [Full Reference](https://azurelocal.cloud/standards/documentation/documentation-standards) | | Repository Management | [Repository Management Standard](repository-management) | [Full Reference](https://azurelocal.cloud/standards/repository-management/) | +| Project Management | [Project Management](project-management) | [HCS Base Standard](https://platform.hybridsolutions.cloud/standards/project-management/) | | Scripting | [Scripting Standards](scripting) | [Full Reference](https://azurelocal.cloud/standards/scripting/scripting-standards) | | Variables | [Variable Standards](variables) | [Full Reference](https://azurelocal.cloud/standards/variable-management/) | | Naming Conventions | [Naming Conventions](naming) | [Full Reference](https://azurelocal.cloud/standards/documentation/naming-conventions) | diff --git a/docs/standards/project-management.md b/docs/standards/project-management.md new file mode 100644 index 0000000..601ea0a --- /dev/null +++ b/docs/standards/project-management.md @@ -0,0 +1,34 @@ +--- +title: Project Management +description: AzureLocal rules for tracker-authoritative planning and reusable PMO boards. +--- + +# Project Management + +This page is the AzureLocal overlay for the HCS +[project-management standard](https://platform.hybridsolutions.cloud/standards/project-management/). +Only AzureLocal-specific differences are defined here. + +## Authoritative source + +GitHub Issues and the AzureLocal organization Project are the primary intake and work-tracking +surfaces. Issues may synchronize into HCS Azure DevOps under the existing split-source rules, but +operators author and update GitHub-native issue data in GitHub. + +The reusable PMO board is a read-only snapshot of those issues. It MUST NOT store browser edits or +write changes back to GitHub. Every displayed item links to its authoritative issue. + +## Scope selection + +AzureLocal uses the per-repository project model unless `registry.yaml` explicitly assigns a +shared project. A board SHOULD represent one repository. A cross-repository portfolio board MAY +use the organization Project when its configuration names that scope explicitly. + +## Publication + +Generated snapshots stay under ignored `.artifacts/pmo/`. Scheduled automation publishes an +authenticated workflow artifact. Claude or Codex publication remains owner-only or +workspace-restricted unless the repository owner explicitly approves public access. + +See also [Repository Management](repository-management.md) and the HCS +[work-item sync standard](https://platform.hybridsolutions.cloud/standards/work-item-sync/).