Back to Skills

utility-pm-release-conductor

product-on-purpose
Updated 2 days ago
4 views
238
33
238
View on GitHub
Metaaidesign

About

This skill orchestrates a six-gate release process, automatically invoking specialized sub-agents for auditing and changelog tasks on Claude Code. For other development environments, it adapts by inlining those behaviors since native chaining isn't supported. It enforces strict gate-by-gate progression with confirmation pauses and manages SHA tagging according to the release plan.

Quick Install

Claude Code

Recommended
Primary
npx skills add product-on-purpose/pm-skills -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/product-on-purpose/pm-skills
Git CloneAlternative
git clone https://github.com/product-on-purpose/pm-skills.git ~/.claude/skills/utility-pm-release-conductor

Copy and paste this command in Claude Code to install this skill

Documentation

<!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 -->

PM Release Conductor (Dispatch Skill)

Cross-client dispatch wrapper for the pm-release-conductor sub-agent. Detects runtime; dispatches to the native sub-agent on Claude Code; reads subagents/pm-release-conductor.md and inlines chain composition on non-Claude clients via "reference + execute inline" pattern.

EXPERIMENTAL - PENDING GATE C VALIDATION. This dispatch skill ships in v2.16.0 in EXPERIMENTAL state. The "reference + execute inline" pattern for chain composition (inlining auditor + curator behaviors at G0 + G2 + G2.5 instead of native sub-agent chaining) has NOT yet been validated on any non-Claude client. Phase 2 GATE C sub-spike per master plan D30 is PENDING maintainer test. DO NOT use this skill for live (non-dry-run) production releases on non-Claude clients until GATE C records a PASS outcome. Safe usage modes today: (1) Claude Code path (dispatches to native sub-agent; identical behavior); (2) non-Claude client + --dry-run flag (rehearsal walk-through without tag + push operations). If GATE C fails on a specific client, this skill is downgraded per the D-revised fallback path: conductor stays Claude-Code-only; 3 dispatch skills ship instead of all 4.

STATUS: This dispatch skill is CONDITIONAL on Phase 2 GATE C sub-spike outcome per master plan D30. The "reference + execute inline" pattern for chain composition (inlining auditor + curator behaviors at G0 + G2 + G2.5 instead of native chaining) is the most complex dispatch case in v2.16.0. If GATE C reveals reliability issues, this dispatch skill is removed from the v2.16.0 ship slate and conductor stays Claude-Code-only (D-revised path); 3 dispatch skills ship (pm-critic, pm-skill-auditor, pm-changelog-curator) instead of all 4.

When to Use

  • You are running a pm-skills release on a non-Claude client (Codex CLI, Cursor, Windsurf, Copilot, Gemini CLI)
  • You want the same 6-gate discipline that pm-release-conductor enforces on Claude Code, with auditor + curator behaviors inlined at the relevant gates
  • You explicitly want skill-invocation semantics over sub-agent semantics on Claude Code (rare; the native sub-agent is preferred on Claude Code)

When NOT to Use

  • You only need to review a PM artifact -> use utility-pm-critic
  • You only need a governance audit (not a release) -> use utility-pm-skill-auditor
  • You only need a CHANGELOG draft (not a release) -> use utility-pm-changelog-curator
  • You want to perform release operations WITHOUT explicit gate confirmation -> the conductor refuses bypass; manual release outside the conductor is the right path

Instructions

Runtime detection step. Determine which AI client is invoking this skill.

If you are running in Claude Code with the pm-skills plugin installed

Invoke @agent-pm-release-conductor with the user's target version + optional flags from $ARGUMENTS. The native sub-agent walks the 6 gates and natively chains to pm-skill-auditor (G0, G2.5) and pm-changelog-curator (G2) via the Agent tool. Return the conductor's gate-by-gate output to the user.

If you are running in any other AI client

Codex CLI, Cursor, Windsurf, Copilot, Gemini CLI, or any other client without native pm-skills plugin sub-agent support:

  1. Read the canonical sub-agent definition at subagents/pm-release-conductor.md
  2. Read the canonical runbook at docs/contributing/release-runbook.md (the conductor's referential source for gate definitions)
  3. Execute the system prompt body as your operating instructions
  4. Walk the 6 gates inline. At gates that require chain composition:
    • G0 (Pre-tag readiness): instead of chaining to pm-skill-auditor, read subagents/pm-skill-auditor.md and execute the auditor's 4-step audit flow inline. Capture the layered output (full findings + Status Summary + Status YAML). Treat the Status YAML as your G0 sub-check 5 input.
    • G2 (Version bump + CHANGELOG prep): instead of chaining to pm-changelog-curator, read subagents/pm-changelog-curator.md and execute the curator's 8-step drafting flow inline. Capture the layered output. Treat the Status YAML as your G2 sub-check 3 input.
    • G2.5 (Re-verify): re-execute the inlined auditor at sub-check 5 against the new HEAD.
  5. Pause at each gate boundary for explicit maintainer confirmation
  6. Refuse bypass attempts; respect refusal protocols
  7. Tag only the G2.5-captured SHA at G3 per D22
  8. Return gate-by-gate output throughout the flow

The "reference + execute inline" pattern is what enables cross-client compatibility for chain composition. Phase 2 GATE C sub-spike validates that this pattern is reliable.

Critical Caveats for Non-Claude Inline Execution

Because non-Claude clients cannot natively chain, the auditor and curator behaviors run in the SAME context window as the conductor on non-Claude clients. This has implications:

  1. Context budget. The combined token budget (conductor + inlined auditor + inlined curator + their child reads) may approach context limits on long releases. Plan accordingly.
  2. Tool authorization. The conductor's tool list includes Bash, Read, Edit, Grep, Glob, Agent. The auditor needs Bash + Read + Grep + Glob. The curator needs Bash + Read + Grep. Inline execution on non-Claude clients should have access to ALL of these (i.e., not be running in a Read-only mode).
  3. Refusal cascade. If the inlined auditor refuses (e.g., validators not invocable), the conductor's G0 sub-check 5 fails and the gate pauses. Same for the curator at G2.

Reference Files

GitHub Repository

product-on-purpose/pm-skills
Path: skills/utility-pm-release-conductor
0
agent-skillsai-skillsclaude-codeclaude-desktopdesign-sprintfoundation-sprint

Related Skills

content-collections

Meta

This skill provides a production-tested setup for Content Collections, a TypeScript-first tool that transforms Markdown/MDX files into type-safe data collections with Zod validation. Use it when building blogs, documentation sites, or content-heavy Vite + React applications to ensure type safety and automatic content validation. It covers everything from Vite plugin configuration and MDX compilation to deployment optimization and schema validation.

View skill

polymarket

Meta

This skill enables developers to build applications with the Polymarket prediction markets platform, including API integration for trading and market data. It also provides real-time data streaming via WebSocket to monitor live trades and market activity. Use it for implementing trading strategies or creating tools that process live market updates.

View skill

creating-opencode-plugins

Meta

This skill helps developers create OpenCode plugins that hook into 25+ event types like commands, files, and LSP operations. It provides the plugin structure, event API specifications, and implementation patterns for JavaScript/TypeScript modules. Use it when you need to intercept, monitor, or extend the OpenCode AI assistant's lifecycle with custom event-driven logic.

View skill

sglang

Meta

SGLang is a high-performance LLM serving framework that specializes in fast, structured generation for JSON, regex, and agentic workflows using its RadixAttention prefix caching. It delivers significantly faster inference, especially for tasks with repeated prefixes, making it ideal for complex, structured outputs and multi-turn conversations. Choose SGLang over alternatives like vLLM when you need constrained decoding or are building applications with extensive prefix sharing.

View skill