{"id":50634614,"url":"https://github.com/cody-hutson/pmo-platform","last_synced_at":"2026-06-30T04:00:37.394Z","repository":{"id":362759790,"uuid":"1260564611","full_name":"cody-hutson/pmo-platform","owner":"cody-hutson","description":"A modular PMO \u0026 release-management platform for Claude Code: skills, governance disciplines, and a 13-stage release pipeline.","archived":false,"fork":false,"pushed_at":"2026-06-28T04:17:55.000Z","size":16749,"stargazers_count":0,"open_issues_count":417,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-28T04:24:27.990Z","etag":null,"topics":["ai-agents","anthropic","claude","claude-code","claude-skills","expertise-layer","pmo","pmo-tools","portfolio-management","productivity","program-management","project-management","release-automation","sdlc"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cody-hutson.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":"roadmaps/README.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":"cody.hutson","thanks_dev":null,"custom":null}},"created_at":"2026-06-05T16:18:16.000Z","updated_at":"2026-06-28T04:17:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/cody-hutson/pmo-platform","commit_stats":null,"previous_names":["cody-hutson/pmo-platform"],"tags_count":58,"template":false,"template_full_name":null,"purl":"pkg:github/cody-hutson/pmo-platform","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cody-hutson%2Fpmo-platform","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cody-hutson%2Fpmo-platform/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cody-hutson%2Fpmo-platform/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cody-hutson%2Fpmo-platform/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cody-hutson","download_url":"https://codeload.github.com/cody-hutson/pmo-platform/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cody-hutson%2Fpmo-platform/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34951598,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-30T02:00:05.919Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","anthropic","claude","claude-code","claude-skills","expertise-layer","pmo","pmo-tools","portfolio-management","productivity","program-management","project-management","release-automation","sdlc"],"created_at":"2026-06-07T01:01:13.777Z","updated_at":"2026-06-30T04:00:37.388Z","avatar_url":"https://github.com/cody-hutson.png","language":"Shell","funding_links":["https://buymeacoffee.com/cody.hutson"],"categories":[],"sub_categories":[],"readme":"# pmo-platform\n\n\u003e A PMO platform with composable modules — operations, release, and core — designed to run with [Claude Code](https://claude.com/claude-code) (the CLI or the Desktop app).\n\n## What is it\n\npmo-platform is a modular-monolith codebase for program-management and release-pipeline work. Three modules cover distinct capability surfaces and serve two consumer audiences:\n\n- **PMO practitioners** (Senior Program Managers, Technical Program Managers, PMO Directors) use the **operations** module for day-to-day program work — daily status updates, RAID Log maintenance, stakeholder communications, project artifact generation, transcript routing, and tracker upkeep.\n- **Platform builders** (engineers, release managers, DevOps) use the **release** module for software-delivery management — bundling backlog items into versioned releases, driving the 13-stage pipeline from intake through close, executing deploys, and authoring release notes.\n\nA shared **core** module hosts the security hooks, decision/discovery/review disciplines, schemas, deploy infrastructure, and the shared skills (`prompt-builder`, `eval-writer`, `pmo-qa-auditor`) consumed by both consumer modules.\n\nEach module is independently consumable. A PMO practitioner can install the platform and use only the operations module; a platform-builder team can drive releases against any tracked repository using only the release module. Composing the two modules is also supported — the release module can ship releases for the operations module (and for itself).\n\n## Quick install\n\n**Requirements:** [Claude Code](https://claude.com/claude-code) — the CLI *or* the Desktop app UI — plus macOS 12+, `git`, and `python3`. Three commands install pmo-platform on a fresh machine:\n\n```bash\ngit clone https://github.com/cody-hutson/pmo-platform.git ~/Claude/pmo-platform\ncd ~/Claude/pmo-platform\n./install.sh\n```\n\n`./install.sh` bootstraps the workspace layout, resolves the operator-identity tokens, installs the core security hooks, lays down composition-surface seed files with marker fences (so future updates preserve any custom additions), and deploys all platform skills to the runtime path Claude Code expects. It is idempotent — running it again on an existing workspace updates rather than overwrites.\n\nFor prerequisites, the full step-by-step procedure, and troubleshooting, see [docs/INSTALL.md](docs/INSTALL.md). For the version-update procedure that preserves operator additions, see [docs/UPDATE.md](docs/UPDATE.md).\n\n## Getting started\n\nAfter install, take the 5-minute taste: the first-task walkthrough at [docs/GETTING_STARTED.md](docs/GETTING_STARTED.md) exercises one real skill end-to-end — invoke it, read the output, change your workspace identity, and re-invoke to watch context flow through.\n\nFor the whole-journey map — the ordered clone→working-install arc and where each host choice (repo, ticketing, KB, AI tool) plugs in — see [docs/ONBOARDING_JOURNEY.md](docs/ONBOARDING_JOURNEY.md).\n\nThen go further with **[docs/FIRST_STEPS.md](docs/FIRST_STEPS.md)**, which takes you from \"I tried one skill\" to running real work:\n\n1. **Explore** — the fastest way to learn the platform: open Claude Code in the repo and play Q\u0026A with it (\"explain the 13-stage pipeline\", \"what's a hub vs a spoke?\"). The repo documents itself.\n2. **Orient** — the one mental model everything runs on: a typed work item → Triage → a versioned Milestone → a *hub* session that spawns a *spoke* per pipeline stage → close.\n3. **Pick your track:**\n   - **PMO practitioner** → configure your first project (`/project-initiator`, `PROJECT.md`, `delivery_approach`) and use the daily [operations](operations/README.md) skills.\n   - **Platform builder** → hook up your GitHub repo (issues, a Milestone, the project board), then drive a release with the [release](release/README.md) module's hub.\n\nFIRST_STEPS.md also covers the conventions worth knowing up front — governed-vs-ad-hoc changes, \"recommend-then-you-decide\" autonomy, evidence labels, and how to read a Decision Briefing.\n\nAfter that, the module READMEs cover each module's full skill roster.\n\n## Configuration\n\nPlatform behavior is configurable from one place. Every field — what it does, its default, and where to set it — is in the [configuration catalog](docs/platform-config-reference.md). Two surfaces hold your choices: `operator.toml` (environment + identity + host adapters — repo, ticketing, KB, AI tool) and `platform-config.toml` (tunable behavior — bundling, release-class default, calibration). Both ship as templates `./install.sh` lays down; values resolve most-specific-wins (global default → portfolio → program → project → individual). Setting a value for your own scope is a local edit; changing a shipped default is a governed change. See the **Platform-Config Resolution Protocol** in [OPERATIONS.md](core/governance/OPERATIONS.md) for precedence + update rules.\n\n## Module overview\n\n| Module | Role | More |\n|---|---|---|\n| [`operations/`](operations/README.md) | PMO operations capability — the skill suite for PMO practitioners | [Module README](operations/README.md) |\n| [`release/`](release/README.md) | Release pipeline / SDLC management — the skill suite for platform builders | [Module README](release/README.md) |\n| [`core/`](core/README.md) | Shared kernel — hooks, schemas, shared skills, disciplines, deploy infrastructure | [Module README](core/README.md) |\n| [`docs/`](docs/) | User-facing documentation — install, getting started, workspace setup, module APIs | [Docs index](docs/) |\n\nFor the consolidated cross-module API reference, see [docs/module-apis.md](docs/module-apis.md).\n\nTop-level layout:\n\n```\npmo-platform/\n├── operations/   # PMO operations module (skills, governance, templates)\n├── release/      # Release pipeline module (skills, pipeline definitions, ADRs)\n├── core/         # Shared kernel (hooks, schemas, disciplines, deploy infra)\n├── docs/         # User-facing docs (INSTALL, GETTING_STARTED, workspace-setup, module-apis)\n├── packages/     # .skill distribution artifacts per module\n├── CHANGELOG.md  # Keep a Changelog 1.1.0 format\n├── LICENSE       # BSL 1.1\n└── README.md     # This file\n```\n\n## Architecture\n\nThe repository is laid out as a **modular monolith**: one repository, three modules, each with a documented `Public API` section in its README. Modules talk only through declared public surfaces; internal references stay inside their owning module. Extraction-readiness is preserved — if any module proves genuinely independent over time, it can be lifted into its own repository without rewriting consumer references.\n\nThe API-contract discipline buys two properties at low cost. First, the contract is explicit: any cross-module reference shows up in the consumer's reference list as a `via-public-api` entry, so drift between modules is visible at deploy time. Second, the kernel stays the kernel: anything `core/` exports is consumed by both operations and release, so changes to the shared surface get reviewed against both consumers.\n\nCross-cutting capability lives in the core module as separately-named **disciplines** (decision, discovery, review) — small reference documents that operationalize how the platform treats tier classification, premise interrogation, and post-artifact verification. They're consumed by skills in both operations and release; their structural separation from any one skill keeps them composable.\n\nFor the architectural deep-dive (workspace layout, token-resolved config templates, where the security hooks live, how the deploy script bootstraps a fresh clone, how each module's skill roster maps to consumer audiences), see [docs/workspace-setup.md](docs/workspace-setup.md).\n\n## License\n\nBusiness Source License 1.1 (BSL 1.1).\n\n- Non-production use is granted: personal use, educational use, and internal business operations (including use by employees, contractors, and agents for your own internal program and project management) are permitted.\n- Production-as-commercial-offering requires a separate commercial license. The platform may not be incorporated into hosted services, managed services, or commercial software products without separate arrangement.\n- The license converts to Apache 2.0 on the Change Date (2030-05-27), four years after first publicly available distribution of the licensed version.\n\nSee [LICENSE](LICENSE) for the full terms and the licensor contact for commercial-licensing inquiries.\n\n## Security\n\nFound a vulnerability? Report it **privately** per the [Security Policy](SECURITY.md) — please don't open a public issue. The repo runs full-history `gitleaks` in CI, and native GitHub secret scanning + push protection are enabled.\n\n## Contributing\n\npmo-platform is a single-operator project under BSL 1.1. **External pull requests are not accepted** and write access is limited to approved collaborators — see [CONTRIBUTING.md](CONTRIBUTING.md). You're welcome to fork for your own non-production use within the license and to read the code to learn the platform.\n\n## Status\n\n**Active development — not yet production-ready for public consumption.** The downloadable surfaces (`install.sh`, the four onboarding documents under `docs/`, the three module READMEs, and the consolidated API reference) are in place and exercised end-to-end. The platform is functionally adequate for personal use and internal-business use per the BSL 1.1 grant above. A broader public-release readiness validation is in flight; the timing of that validation is not committed.\n\n## Acknowledgments\n\nBuilt to run on top of [Anthropic Claude Code](https://claude.com/claude-code) and follows the Anthropic Skills convention for skill packaging. The Business Source License 1.1 framework is provided by MariaDB Corporation Ab. The [`CHANGELOG.md`](CHANGELOG.md) format follows [Keep a Changelog](https://keepachangelog.com/) 1.1.0 with semantic versioning adapted for the platform's release-milestone numbering.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcody-hutson%2Fpmo-platform","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcody-hutson%2Fpmo-platform","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcody-hutson%2Fpmo-platform/lists"}