Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

[2.31.0] - 2026-07-05

Zero-drift releases: generation becomes the only write path. v2.30.0 fixed every live instance of count drift; this release removes the hand-write path that produced it. A new generator, scripts/gen-derived-surfaces.mjs, now owns the README catalog tables and badges, both quickstarts, the sub-agent compatibility matrix, the three plugin manifest description headlines, and the release-notes mirrors, each inside a pmskills:* marker pair with a --check tripwire that fails CI on a hand edit. Alongside it, release-please goes live in shadow (its Release PR is observed and diffed against this manual cut, never merged this cycle), the two awk RSTART/RLENGTH hazard validators that hung v2.27.1 CI are ported to single-source Node, trigger-fixture coverage climbs from 31 to 43 of 68 skills, an output-eval CI lane and a published evals page ship, and SECURITY.md gains a provenance page. No new skills; catalog stays 68 skills (30 phase + 11 foundation + 12 utility + 15 tool), 6 sub-agents unchanged. Additive MINOR.

Full details in root CHANGELOG.md and docs/releases/Release_v2.31.0.md.

[2.30.0] - 2026-07-04

Trust repair + hygiene. A 2026-07-04 audit found this project’s least-engineered surfaces carried its most damaging defects: the first sentence a new user reads contradicted its own sub-counts, the curated release zip omitted the agents/ and hooks/ directories the dispatch skills need at runtime, and utility-pm-skill-builder carried a hand-maintained inventory blind to 22% of the catalog. This release fixes every instance of that drift, closes the CI gate holes that let it pass (a new enforcing check-count-phrases gate plus an advisory check-heading-canon gate), and extends the same hygiene pass to headings, descriptions, dual-shell validators, the trigger-eval roster, and tool-family versioning (the 15 tool skills move 0.1.0 to 1.0.0). No new skills; catalog stays 68 skills / 6 sub-agents. Additive MINOR. Full details in root CHANGELOG.md and docs/releases/Release_v2.30.0.md.

[2.29.1] - 2026-06-24

Maintenance patch: skill docs pages no longer drop sections. The documentation-site generator built each skill page from a fixed allow-list of H2 section names and silently discarded the rest, so any skill whose method lived under bespoke headings shipped a hollow page (about 27 of 68, most visibly foundation-build-risk-review). The generator now renders every SKILL.md section verbatim, an output-based check-skill-page-sections gate fails CI if any section is dropped, and the flat skill cross-references the restored sections surfaced now resolve. No skill behavior change; catalog stays 68 skills / 6 sub-agents. PATCH. Full details in root CHANGELOG.md and docs/releases/Release_v2.29.1.md.

[2.29.0] - 2026-06-23

New foundation skill: the pre-build risk gate, plus a key-free router engine. foundation-build-risk-review runs a fast pre-commitment risk review on a product idea, feature request, or scope change: it names the single assumption most likely to make the work fail and returns a verdict (build small, validate first, pivot first, or don’t build yet) with a no-code validation step, then routes to the next skill. Two modes (pre-build, feature-change); launched-product diagnosis routes to iterate-pivot-decision. Alongside it, the pm-skill-router sub-agent makes the new-skill collision gate and the trigger router-eval runnable on the subscription with no API key (check-new-skill-collision.mjs --emit-tasks plus a Haiku-pinned router). The documentation showcase now auto-derives its skill set from the sample files (self-healing). Catalog grows 67 to 68 skills (foundation 10 to 11), sub-agents 5 to 6. Additive MINOR. Full details in root CHANGELOG.md and docs/releases/Release_v2.29.0.md.

[2.28.0] - 2026-06-20

New foundation skill: stakeholder briefings (1-to-N audience fan-out). foundation-stakeholder-briefings takes any source artifact (spec, discovery, research, GTM, experiment, retro, or raw notes) and produces one canonical master document plus a set of audience-tailored briefings, one per stakeholder lens (executive, board, engineering, UX, PMM, sales, CS, legal, data, or a custom audience). Master-first projection: each briefing cites the master claim IDs it draws on and carries exactly one ask, and the advisory scripts/check-briefings-trace.mjs validator enforces that structural contract (references resolve; one ask per block). Ships nine first-class lenses (with “not this lens when” boundaries and an overlap matrix), a source-aware audience proposal, trigger fixtures, and 18 library samples. Catalog grows 66 to 67 skills (foundation 9 to 10); 5 sub-agents unchanged. Additive MINOR. Full details in root CHANGELOG.md and docs/releases/Release_v2.28.0.md.

[2.27.1] - 2026-06-16

Maintenance patch: classification sub-count drift gate. check-count-consistency now derives the four per-classification / per-phase skill sub-counts (phase, foundation, utility, tool) from frontmatter and validates them on every doc surface, so a stale “10 utility skills” or “Foundation Skills (9)” fails CI like a stale total - closing the gap that let the classification split drift on a published page until a v2.27.0 hand audit caught it. The change is additive (the total-count check is unchanged) and historical mentions are handled with word-form numbers or count-exempt ranges. Three stale sub-counts the gate surfaced are fixed. No skill behavior change; catalog stays 66 skills / 5 sub-agents. PATCH. Full details in root CHANGELOG.md and docs/releases/Release_v2.27.1.md.

[2.27.0] - 2026-06-15

The provable-quality release. Makes skill quality verifiable and regression-protected without adding any skills. Trigger-accuracy evals (M-31): every measured skill carries labeled evals/trigger-fixtures.json; a controlled router eval scores per-skill recall/precision against a committed baseline; CI gates fail on routing drift or a new-skill collision. Derived surfaces (M-32): skill-manifest.json and the AGENTS.md catalog are generated from frontmatter behind enforcing staleness gates, retiring the hand-sync drift class (and the disabled sync-agents-md.yml). Output-quality evals (M-33): the harness, six family rubrics, the unit-tested aggregation + absolute-failure-first verdict module, a three-arm informed control, and the asset-presence gate ship (per-skill results stay internal evidence). The creator/validator family (utility-pm-skill-builder / utility-pm-skill-validate 1.1.0) now bakes the eval contract into skill creation, and the reciprocal-boundary-pointer gate is enforcing. Catalog stays 66 skills / 5 sub-agents. Additive MINOR. Full details in root CHANGELOG.md and docs/releases/Release_v2.27.0.md.

[2.26.0] - 2026-06-10

The authoring and quality release. The /chain command runs any ad-hoc ordered skill sequence through the existing pm-workflow-orchestrator engine (Mode B; checkpointed by default; no new engine, no new skill), and the new utility-pm-workflow-builder skill turns a proven chain or a fresh idea into a staged draft workflow packet for human review. The quality-convergence effort completed: all 26 original-generation skills gained “When NOT to Use” boundary pointers and enumerated output contracts with zero instruction rewrites and zero template changes. The orchestrator’s native Skill-tool delegation path was live smoke-tested on the installed plugin before tagging (recorded PASS; the procedure is now the Agentic Smoke-Test Runbook). Catalog grows 65 to 66 skills (utility 11 to 12); command files 10 to 11. MINOR. Full details in root CHANGELOG.md and docs/releases/Release_v2.26.0.md.

[2.25.2] - 2026-06-10

Maintenance patch: resolves the remaining 2026-06-06 Codex audit items and hardens the release gate. Unifies the bash/PowerShell/CI validator inventory behind a single manifest (scripts/validation-manifest.yaml) with an enforcing CI parity referee (scripts/check-validator-parity.mjs) that compares each OS leg’s args and enforcement and caught a live drift it then reconciled; extends the root-document link checker to source files; promotes the em-dash-scar guard to enforcing (now multi-backtick aware); and corrects the CLAUDE.md “internal notes are gitignored” claim. A Codex adversarial review of the release ran first and its findings were resolved before tagging. No skill behavior change. Catalog stays 65 skills / 5 sub-agents. PATCH. Full details in root CHANGELOG.md and docs/releases/Release_v2.25.2.md.

[2.25.1] - 2026-06-06

Maintenance patch: banks accumulated untagged work since v2.25.0. Reorganizes the documentation site to the Product on Purpose family layout (Pattern S) with full family-standard conformance, adds a generated CI-gated resource index (docs/RESOURCES.md) and a docs/ front door, repairs root-document links left by the relocation and adds an enforcing CI guard for them, sweeps residual em-dash-sweep . scars to - across user-facing and internal prose with new advisory and enforcing guards to keep them out, bumps three site dependencies (@astrojs/starlight, dompurify, astro-mermaid), and fixes the PowerShell pre-tag validator bundle to match the bash and CI inventory. No skill behavior change and no published-URL change (route parity verified). Catalog stays 65 skills / 5 sub-agents. PATCH. Full details in root CHANGELOG.md and docs/releases/Release_v2.25.1.md.

[2.25.0] - 2026-06-03

Activation and trust layer: the plugin’s first hooks, plus an advisory output-quality CI tier. Adds opt-in house-rule guardrails (a PreToolUse hook that blocks em-dash and en-dash characters when guardrails: true is set in .claude/pm-skills.local.md; placeholder and metric checks warn) and a confident-only phase router (a SessionStart hook that suggests the right Triple Diamond skills only when a repo signal is strong, and stays silent otherwise). Adds M-30, an advisory output-quality CI tier: three deterministic invariant validators over the recorded samples (no placeholders, exact-quote sourcing, no fabricated metrics). The hooks are dependency-free and fail open; hooks are a Claude Code primitive. No new skills (catalog stays 65; sub-agents stay 5). Additive MINOR. Full details in root CHANGELOG.md and docs/releases/Release_v2.25.0.md.

[2.24.0] - 2026-06-01

Plan orchestrator: the pm-workflow-orchestrator sub-agent + utility-pm-workflow-orchestrator dispatch skill, plus a --run handoff from foundation-prioritized-action-plan. Ships the orchestrator promised on the public roadmap (originally pencilled for v2.17): a governed runner that takes a saved foundation-prioritized-action-plan or a user-named chain and runs an ordered sequence of pm-skills against it, pausing for human go/no-go by default and refusing to advance past a failed or empty step (CHECKPOINTED default, GUARDED AUTO via --auto). The engine sub-agent delegates via the Skill tool only, adding no chain-permission entry. The plan skill iterates to v1.1.0 with an optional --run handoff for its runnable Section 7 prompts. Catalog grows 64 to 65 (utility 10 to 11; foundation unchanged at 9); sub-agents 4 to 5. EXPERIMENTAL on all non-Claude clients, and the native Skill-from-sub-agent path is EXPERIMENTAL until a live smoke test. Additive MINOR. Full details in root CHANGELOG.md and docs/releases/Release_v2.24.0.md.

[2.23.0] - 2026-05-31

New foundation skill: foundation-prioritized-action-plan. Turns any PM input (notes, transcripts, drafts, executive asks, raw situations) into one evidence-grounded, prioritized action plan: the critical next effort plus follow-ons, each with why, what, how, confidence, and source. Theory of Constraints ranks by the single binding constraint; Cynefin caps plan confidence (probes for Complex, stabilization for Chaotic). A source ledger is built before analysis and every load-bearing claim cites an exact input quote, so the skill refuses High-confidence plans for Complex or Chaotic situations. Catalog grows 63 to 64 (foundation 8 to 9). Additive MINOR. Full details in root CHANGELOG.md and docs/releases/Release_v2.23.0.md.

[2.22.0] - 2026-05-30

Wrapper deletion (one menu entry per skill) + native Codex support. The 63 hand-maintained short command wrappers are removed, so each capability appears once in the / menu as the skill; only the 10 /workflow-* orchestrator commands remain (commands 73 to 10). A native .codex-plugin/plugin.json is added so Codex discovers the skills. All 63 skill names and behavior are unchanged; master-plan D6 (the sub-agent companion-command contract) is retired. MINOR. Full details in root CHANGELOG.md and docs/releases/Release_v2.22.0.md.

[2.21.0] - 2026-05-26

Marketplace Launch (additive). pm-skills is now published through the new product-on-purpose marketplace, a single home for multiple Product on Purpose plugins. Distribution change only: catalog (63), commands (73), sub-agents (4), and behavior are unchanged; the existing self-hosted path keeps working, so no user has to act. MINOR (backward-compatible). Full details in root CHANGELOG.md and docs/releases/Release_v2.21.0.md.

[2.20.0] - 2026-05-25

Sprint Workflow Commands + Validation/Doc Hardening. The three workshop methodologies become single slash commands (/workflow-foundation-sprint, /workflow-design-sprint, /workflow-foundation-to-design; slash commands 70 to 73), and check-count-consistency is tightened to catch stale counts in table, parenthetical, and singular-noun phrasings. No new skills (catalog stays 63). Full details in root CHANGELOG.md and docs/releases/Release_v2.20.0.md.

[2.19.0] - 2026-05-23

Pre-Promotion Hardening. No new skills (catalog stays 63); the release closes the blind spots the v2.18.0 arc exposed: a new check-skill-cross-references validator, .mdx count scanning, same-page anchor link validation, validate-script-docs flipped to enforcing, and .gitattributes line-ending pinning. 23 pre-existing broken links/anchors fixed. Full details in root CHANGELOG.md and docs/releases/Release_v2.19.0.md.

[2.18.0] - 2026-05-21

Highest-Consensus PM Skill Gaps: 4 New Content Skills. discover-market-sizing, define-prioritization-framework, discover-journey-map, and measure-survey-analysis ship as a slate (catalog 59 to 63; phase skills 26 to 30). Each ships with a TEMPLATE, EXAMPLE, companion command, and 3 thread-aligned samples, and each leads with epistemic discipline (refuses to fabricate data). Full details in root CHANGELOG.md and docs/releases/Release_v2.18.0.md.

[2.17.0] - 2026-05-20

Native Claude Code Sub-Agent Registration + Frontmatter Spec Alignment. The 4 sub-agents now register natively (definitions moved to the canonical agents/ directory, auto-discovered via @-mention); the coordination directory was renamed AGENTS/ to _agent-context/ to free the name. Skill frontmatter migrated to the metadata-nested structure per the agentskills.io specification, and the CI validators were made bash-3.2 portable. Catalog unchanged at 59. Full details in root CHANGELOG.md and docs/releases/Release_v2.17.0.md.

[2.16.2] - 2026-05-19

Post-v2.16.1 Audit Hygiene Fast-Patch. Refreshed the _agent-context/claude/CONTEXT.md Status block and wired check-context-currency into the pre-tag bundle so future CONTEXT.md drift is caught at pre-tag time. Same 59-skill catalog; no skill content changes. Full details in root CHANGELOG.md and docs/releases/Release_v2.16.2.md.

[2.16.1] - 2026-05-18

Plugin Manifest Schema Patch. Removed an invalid agents field from .claude-plugin/plugin.json that caused /plugin update pm-skills to fail validation. Same 59-skill catalog; dispatch skills unchanged; day-to-day usage identical to v2.16.0. Full details in root CHANGELOG.md and docs/releases/Release_v2.16.1.md.

[2.16.0] - 2026-05-17

Active Orchestration + Doc-Stack Modernization. Four Claude Code plugin sub-agents (pm-critic, pm-skill-auditor, pm-changelog-curator, pm-release-conductor) codify the adversarial-review loop and the 6-gate release runbook (with the G2.5 commit gate that prevents broken tags); cross-client access via dispatch skills brings the catalog to 59. The doc-stack upgrades to Astro 6.3.x + Starlight 0.39.x + Node 22.12+, closing 2 Dependabot alerts. Full details in root CHANGELOG.md and docs/releases/Release_v2.16.0.md.

[2.15.2] - 2026-05-17

v2.15.x Cycle Closeout + v2.16.0 Plan Reconciliation. Same-cycle closeout patch successor to v2.15.1. No source-code, validator behavior, or catalog changes. Pure planning-doc hygiene: v2.15.x audit doc status flipped from DRAFT to REMEDIATION SHIPPED with finding-by-finding closure table; v2.15.0 master plan “What’s next” updated with v2.15.1 + v2.15.2 DONE rows; v2.16.0 plan slate reconciled against v2.15.1 shipped reality (repo-hygiene CONTEXT.md prereq marked DONE; ci-plan validator scope reduced from “5 new” to “2 new + 1 extension” with carry-in reconciliation section); AGENTS/claude/CONTEXT.md refreshed to v2.15.2 SHIPPED state; issue #132 [M-20] comment with v2.15.1 partial-close evidence. Full details in root CHANGELOG.md and docs/releases/Release_v2.15.2.md.

[2.15.1] - 2026-05-16

v2.15.0 Post-Tag Audit Remediation + Preventive CI. Same-day patch successor to v2.15.0. The 55-skill catalog is unchanged; day-to-day usage is identical. What changes is documentation accuracy on the docs site (homepage refreshed at 55 skills with Tool card; skills landing page Tool row added; workflow index regenerated with all 12 workflows; AGENTS.md command table extended with 23 missing rows including 5 pre-existing legacy drift items; sample-library README refreshed at 171 samples; Sprint Planning gets (agile) naming-discipline qualifier), a real workflow-generator bug fix (hardcoded workflow_info dict that silently dropped new workflows from the index; hardened to fail loudly), and 4 new preventive CI validators (landing-page count assertion, workflow-generator coverage, AGENTS.md command-sync, pre-tag validator bundle orchestration). Full details in root CHANGELOG.md and docs/releases/Release_v2.15.1.md. Audit document at docs/internal/release-plans/v2.15.x/audit_v2.15.x_post-tag-self-review.md.

[2.15.0] - 2026-05-16

Sprint Skills Launch. 15 new skills under the new classification: tool taxonomy implementing Knapp/Zeratsky/Kowitz canonical sprint methodologies: 7 Foundation Sprint family + 7 Design Sprint family + 1 tool-note-and-vote standalone. Skill catalog 40 to 55. Two family contracts (FS v0.3.0; DS v0.2.0; both with Naming Discipline section) and enforcing CI validators (with —strict release-mode). End-to-end FS-to-DS workflow with a narrative-only handoff conversation (replaces dropped bridge skill). 45 library samples across 3 narrative threads (Brainshelf, Storevine, Workbench). Two operational user guides + two concept docs + a sprint-family doc set (FAQ + cheat sheet + case studies + recovery playbook per family) + a workshop-sprint vs agile-sprint disambiguation reference + a sprint methodology glossary + a workshop method comparison matrix. Full details in root CHANGELOG.md and docs/releases/Release_v2.15.0.md.

[2.14.2] - 2026-05-10

Codex Final Review Closure (Cumulative Docs Hygiene Patch). Same-day successor to v2.14.1. The 40-skill catalog is unchanged from v2.14.1; day-to-day usage is identical. What changes is documentation accuracy, validator scope, workflow safety posture, and cross-repo metadata. Addresses every actionable finding from the Codex final review of the v2.14.x release cycle (0 P0, 1 P1, 11 P2, 1 P3). Full details in root CHANGELOG.md.

Highlights:

validate-docs-frontmatter scope expanded to .mdx (Codex P2). Bash + pwsh now include docs/index.mdx and any future MDX surfaces. Mirrors V6’s check-internal-link-validity pattern.
check-no-body-h1 doc clarified with “What this rule does NOT catch (by design)” section. Prevents future over-engineering into a no-H1-anywhere rule.
validate-mcp-sync guide refreshed for observe-mode default + maintenance-flag awareness (matches v2.14.1 V9 + B changes).
sync-agents-md.yml workflow_dispatch hardened with two-layer defense: apply: true input gate (default false) plus permissions: contents: read token gate. Reviving requires a code-reviewable PR.
pm-skills-mcp/README.md cross-repo update (Codex P1). 5 “25 skills” residues to “40 skills” (catalog frozen at v2.9.2 build); v2.9.3 latest pointer; changelog table extended with v2.8.x + v2.9.x rows.
CONTRIBUTING.md workaround count corrected “Five” to “Six” (Codex P3).
Release plan top status + Release_v2.14.0 deferrals table reframed: 6 of 9 deferrals closed in v2.14.1 + v2.14.2; 3 remain v2.15+.
Version surfaces refreshed: shields.io badge 2.14.1 to 2.14.2; Latest stable + Published tag; docs/index.mdx Recent Releases; docs/releases/index.md; .claude/pm-skills-for-claude.md; plugin.json + marketplace.json.

[2.14.1] - 2026-05-10

Polish + V15 regression fix. Patch release. The 40-skill catalog is unchanged from v2.14.0. Title duplication fixed across all Starlight pages; generator output reframed for users; Mermaid 3-layer beautification; two CI validators promoted to truly enforcing; new check-no-body-h1 validator added; MCP maintenance posture codified. Full details in root CHANGELOG.md.

Highlights:

Mermaid style guide (FU8): canonical reference at docs/reference/mermaid-style-guide.md + self-contained HTML preview at public/mermaid-style-guide.html. 5 diagram-type examples + Triple Diamond palette + dark mode notes + machine-readable YAML spec for agents.
7 README stubs added across all docs/ subdirectories (FU7). GitHub directory landing pages distinct from Astro-built index.md.
Two validators promoted to truly enforcing in CI: check-internal-link-validity (FU6) and validate-docs-frontmatter (V5). Both now run with --strict / -Strict flag. Cleanup involved adding descriptions to 20 docs and fixing 7 broken doubled-docs-prefix links via generator path-rewrite.
MCP maintenance posture documented (V9): pm-skills-mcp/pm-skills-source.json updated to v2.14.0 metadata + maintenance: true flag (cross-repo); pm-skills validate-mcp-sync.yml default flipped from block to observe so drift no longer fails CI. The drift is the maintenance posture, not a bug.
Mermaid 3-layer beautification (M1+M2+M3): astro.config.mjs themeVariables (indigo lineColor + system-ui font); src/styles/custom.css polish (edge stroke-width + node corner-radius + cluster fill-opacity); Triple Diamond classDef palette applied to home page diagrams.
Generator output reframed for users (V10): removed visible :::caution[Generated file] aside from 63 generator-output pages; users no longer see contributor-noise on rendered pages. Pattern 5C frontmatter marker preserved.
45 library sample files swept of 182 en-dashes (V11). Pre-existing latency exposed when V10 regenerated downstream docs.
9 GitHub Actions workflow files bumped to @v5 for checkout, setup-node, upload-pages-artifact, deploy-pages (FU4). Ahead of Node 20 forced cutoff 2026-06-02.
sync-agents-md.yml auto-trigger disabled (V7). Had been failing since 2026-04-23 due to flat skills/ structure mismatch; AGENTS.md is hand-authored canonical content.
README + plan + CONTEXT.md drift swept (FU1 + V12-V14): stale v2.13.1 references in shields.io badge, “Latest stable”, Published tag, docs/index.mdx, .claude/pm-skills-for-claude.md all bumped to v2.14.0; AGENTS/claude/CONTEXT.md status block refreshed; both v2.14.0 plans annotated with post-tag follow-up summary; both CHANGELOGs got this Unreleased section.
Body H1 stripped across 62 hand-authored docs + 6 generator emission sites (V15). Starlight auto-renders frontmatter title: as the page heading; body also starting with # Heading matching the title produced duplication on every Starlight-rendered page (regression from MkDocs Material migration). User-reported on /showcase/workbench/ + skill pages + phase indexes. Fix: 3 generators no longer emit body H1; workflow generator strips source H1 at copy boundary (_workflows/*.md source files stay standalone-readable on GitHub).
MCP maintenance flag awareness in validate-mcp-sync.js (post-V15 deferral closure B). Validator reads pm-skills-mcp/pm-skills-source.json maintenance: true flag and treats drift as expected when set. Makes source.json authoritative for maintenance posture; V9 workflow-default flip becomes redundant safety.
New check-no-body-h1 validator (post-V15 deferral closure C). 3rd truly-enforcing CI validator added (after FU6 + V5 promotions). Refuses any docs/**/*.{md,mdx} file (subject to EXCLUDE_PATHS) where first non-blank line after closing --- is a # H1 (when file has frontmatter title). Forward enforcement against V15 regression. Validator inventory: 24 total (was 23 at v2.14.0 tag); truly enforcing: 14 (was 11 at tag, +2 from FU6+V5, +1 from this validator).
CONTRIBUTING.md workaround #6 (post-V15 deferral closure A). Documents the Starlight title-vs-body-H1 convention for future contributors.

[2.14.0] - 2026-05-10

Doc Stack Migration: MkDocs Material to Astro Starlight. Doc-stack migration release. The 40-skill catalog is unchanged from v2.13.x; day-to-day usage of /prd, /hypothesis, /user-stories, and the rest of the catalog is identical. What changed is the documentation site itself: MkDocs Material is retired; Astro Starlight ships in its place. The user-visible site continues to serve the same content under a modern static-site stack. 4 phases / 13 workstreams executed.

Added

Astro Starlight stack pinned in package.json: astro ~5.13.0, @astrojs/starlight ~0.34.0, astro-mermaid ~2.0.1, sharp ^0.34.5.
astro.config.mjs authoring (sidebar IA, redirects, mermaid, custom CSS); src/content.config.ts glob loader (in-place docs/ mount + library/skill-output-samples/ remap to /samples/).
.github/workflows/deploy-pages.yml GitHub Actions Pages deploy (composable steps preserve post-build .md link sweep).
scripts/verify-edit-links.mjs post-build edit-link verifier (238/238 unique targets resolve).
scripts/post-build-strip-md-links.mjs post-build .md link sweep (Codex P0 fix from Phase 2; strips 440 links across 59 files).
docs/reference/index.md and docs/samples/index.md overview pages (W13 B2.5 routing fixes).
public/favicon.svg (Triple Diamond mark).
src/styles/custom.css minimal port from Material extra.css.
docs/internal/dependency-policy.md “Known accepted CVEs (static-site exemption)” section per DM-4.
docs/internal/release-plans/v2.14.0/plan_v2.14_starlight-migration.md master migration plan; spike report.
docs/releases/Release_v2.14.0.md release notes.

Changed

Build pipeline: mkdocs build --strict (Python pip) to npm run build (Node 22.x).
Deploy pipeline: mkdocs gh-deploy to GitHub Actions Pages source (auto-deploys on push to main).
Generator output reframe (W5.5): pymdownx admonitions to Starlight asides; MDX details for collapsibles. 38 doc pages regenerated.
Home page rewrite (W11 C3): docs/index.md to docs/index.mdx; 31 pymdownx shortcodes converted to Starlight <CardGrid> + <Card icon=...>.
4 source validators decoupled from mkdocs.yml (W12 C2); hardcoded EXCLUDE_PATHS arrays mirror src/content.config.ts glob excludes.
Validator inventory net -1 (24 to 23): check-nav-completeness retired (Starlight autogenerate solves orphan class structurally).

Removed

mkdocs.yml, requirements-docs.txt, .github/workflows/deploy-docs.yml, .github/workflows/validate-docs.yml, scripts/check-nav-completeness.{sh,ps1,md}, docs/stylesheets/extra.css.

Fixed

/reference/ 404 (B2.5 F1): README.md kept as GitHub-directory landing pointer; new index.md is the Astro source-of-truth at /reference/.
/samples/ 404 (B2.5 F2): authored docs/samples/index.md; Samples sidebar switched to hybrid items.
Redirect destinations landing at “Site not found · GitHub Pages” (B2.5 F3): prepended /pm-skills/ to all 12 destinations.
Favicon 404 + Material/Octicon shortcode leakage on home + showcase pages (W11 C3).

Compatibility

All 40 skills, 47 slash commands, 9 workflows, 115 mounted samples, and source-side editing flows are unchanged from v2.13.x.
Codex compatibility unaffected (reads from skills/ and AGENTS.md directly).
Sync-helper, npx skills add, and /plugin marketplace add install paths unaffected.
pm-skills-mcp companion server unaffected.
Inbound-link compatibility for Material-era URLs: all 12 redirect entries preserved with /pm-skills/ base path.

Security

Astro 5.13.x static-site CVE exemption documented in docs/internal/dependency-policy.md. 5 advisories on the pinned version are accepted as not-applicable to pm-skills’ SSG runtime profile (no SSR, no server islands, no Cloudflare adapter).

Full release narrative: see Release_v2.14.0.

[2.13.1] - 2026-05-06

Plugin Install Path Correction. Patch release. The 40-skill catalog is unchanged from v2.13.0; day-to-day usage of /prd, /hypothesis, /user-stories, etc. is identical. What changes is the plugin install path: /plugin marketplace add product-on-purpose/pm-skills now succeeds, where it had failed silently since v2.7.0 due to two unrelated bugs in marketplace.json (wrong location and missing schema fields).

Fixed

marketplace.json relocated from repo root to .claude-plugin/marketplace.json, the canonical path Claude Code’s plugin system reads from. Move performed via git mv so file history is preserved. The repo-root location is no longer present.
README count-exempt markers extended to cover the “Previous Release Details” section. Pre-release CI surfaced 3 pre-existing stale per-version counts in historical release blocks (v2.9.0 “31 skills”, v2.8.0 “29 skills”, v2.7.0 “27 skills”) that fell outside the v2.13.0 count-exempt range. These are correct as historical statements about what shipped at each version; the wrap restores check-count-consistency to PASS without rewriting historical text.
marketplace.json schema corrected to satisfy Claude Code’s marketplace registry:
- Added top-level owner object with name and url (required field; was absent).
- Converted plugin entry’s author from a bare string to an object with name and url (string form is rejected by the schema).
- Both changes are non-behavioral; the same plugin metadata is now expressed in the schema-conformant shape.

Added

scripts/validate-plugin-install.{sh,ps1,md} (enforcing). New CI validator that asserts the plugin install path will work end-to-end. Verifies both manifests exist at canonical paths (.claude-plugin/plugin.json and .claude-plugin/marketplace.json), validates required fields against Claude Code’s marketplace schema (name, owner.name, plugins, per-plugin name + version + source + author as object), and enforces cross-manifest version + name consistency. Catches the exact bug class that shipped silently from v2.7.0 through v2.13.0.
docs/releases/Release_v2.13.1.md authored as the release notes artifact.
docs/internal/release-plans/v2.13.1/plan_v2.13.1.md authored as the release plan.

Changed

scripts/validate-version-consistency.{sh,ps1} updated to read marketplace.json from .claude-plugin/marketplace.json instead of the repo root. Continues to enforce that plugin.json and marketplace.json declare the same version.
README.md “Install as Claude Code Plugin” section rewritten. Primary path is now the /plugin marketplace add + /plugin install flow that the marketplace registration enables. Manifest-direct install (the prior text) retained as a fallback for older Claude clients.
.claude/pm-skills-for-claude.md updated to acknowledge plugin install as a parallel path alongside the sync-helper. No primary recommendation between the two paths in this release; recommendation positioning deferred to v2.14.0 or later.
Validator inventory grows from 22 to 23 (1 new enforcing). Enforcing tier grows from 10 to 11.

Compatibility

No content changes. All 40 skills, 47 slash commands, 9 workflows, 126 library samples, and 22 CI scripts are unchanged from v2.13.0.
Codex compatibility unaffected. Codex (and any non-Claude-Code agent) reads from skills/ and AGENTS.md directly; marketplace.json is Claude-Code-specific. The file move and schema additions have zero impact on Codex usage.
Sync-helper install path unaffected. Users who install via scripts/sync-claude.sh see no change.
pm-skills-mcp companion server unaffected. v2.9.x maintenance line continues independently.

[2.13.0] - 2026-05-05

Foundation Hardening + Doc Stack Decision. Maintenance and quality release. The 40-skill catalog is unchanged from v2.12.0, so day-to-day usage of /prd, /hypothesis, /user-stories, and the rest of the catalog is identical. What changed is everything around the catalog: cleaner Diataxis-aligned documentation (duplicate files removed, counts reconciled, generated pages clearly labeled, pm-skill-* filename prefix convention), 7 new CI gates that catch doc drift on PRs automatically (validator inventory 15 to 22; enforcing tier 5 to 10), and an out-of-cycle pm-skills-mcp v2.9.3 security-patch follow-up to the v2.9.2 maintenance-mode announcement that cleared all 8 open Dependabot moderate advisories.

Added

7 new CI validators (Bucket C) each with .sh + .ps1 + .md triplet completeness:
- check-nav-completeness (enforcing): every docs/**/*.md is in nav OR exclude_docs OR auto-include patterns
- check-generated-content-untouched (enforcing): snapshots, regenerates, diffs, restores; fails on hand-edits to generated pages. Pairs with Pattern 5C generated-content marker from Bucket A.4.
- validate-references-cross-doc (enforcing): every cross-link in docs/reference/ resolves
- validate-skill-family-registration (enforcing): registry-driven family validation (meeting-skills-family plus future families); F-36
- validate-docs-frontmatter (advisory): every rendered doc has title plus description
- check-internal-link-validity (advisory): zero broken internal links across the doc tree
- check-version-references (advisory): version-reference drift detector
Pattern 5C generated-content marker on all 63 generated pages: generated: true and source: scripts/... frontmatter fields plus a visible !!! warning "Generated file" admonition pointing editors to the source. All 3 generators (generate-skill-pages.py, generate-workflow-pages.py, generate-showcase.py) emit the marker.
F-34 library/skill-output-samples/THREAD_PROFILES.md: machine-readable per-thread metadata contract for tooling consumers (utility-pm-skill-builder primary; future regen tools).
Zensical compatibility spike report at docs/internal/release-plans/v2.13.0/plan_v2.13_zensical-spike-report_2026-05-05.md. Decision artifact for v2.14.0+ stack-decision discussions; outcome NO-GO.

Changed

Doc structure refactor (Bucket A): docs/frameworks/ retired (canonical Triple Diamond reference moved to docs/concepts/triple-diamond-delivery-process.md); 4 concept files reorganized to docs/reference/ and docs/guides/ per Diataxis 4-quadrant taxonomy; 4 legacy duplicate files deleted; creating-skills.md renamed to creating-pm-skills.md per the locked pm-skill-* prefix convention.
Count and link cleanup (Bucket B): skill counts reconciled across 7 public surfaces (concepts, reference, guides, getting-started, mkdocs config, homepage hero) at 40; utility-pm-skill-builder catalog table updated; docs/guides/mcp-setup.md deleted and redirected to mcp-integration.md; AGENTS/codex/CONTEXT.md shrunk 74 to 32 lines as a vestigial-redirect; README “What’s New” workaround replaced with explicit HTML-comment markers; docs/guides/index.md expanded from 7 to 12 listed guides.
5 PowerShell parity bugfixes (Bucket C): check-stale-bundle-refs.ps1, check-workflow-coverage.ps1, check-generated-freshness.ps1, lint-skills-frontmatter.ps1. PS1 versions now match bash output.
check-count-consistency tightened and promoted to enforcing for current-state files. Original line-level v[0-9]+\. exemption replaced with explicit HTML-comment markers plus a subset-descriptor exclusion list.

Infrastructure

Phase 0 Adversarial Review Loop applied across per-strand (PR.1) and release-state (PR.2) layers. PR.1 closed via 4 Codex tasks. PR.2 closed via 5 Codex review rounds + 3 resolution passes (8 numbered rounds total).
Stale-aggregate-counter pattern codified as durable feedback memory after PR.2 round 2 caught it at meta level.
Validator inventory grows from 15 to 22 (7 new). Enforcing tier grows from 5 to 10 (4 new enforcing + count-consistency promoted).

Out-of-cycle (pm-skills-mcp companion server)

pm-skills-mcp v2.9.2 (2026-05-05): formal maintenance-mode announcement (effective 2026-05-04). Re-embeds the full current 40-skill catalog at v2.9.2 build time. Total tools: 59 (40 skill + 11 workflow + 8 utility). Active development paused; security patches and critical bug fixes will continue.
pm-skills-mcp v2.9.3 (2026-05-05): security-patch follow-up two hours after v2.9.2. Cleared all 8 open Dependabot moderate advisories. Post-ship Dependabot open-alert count: 0. The 2-hour announcement-to-patch turnaround validates the v2.9.2 maintenance-mode commitment in operational practice.

See the root CHANGELOG.md for the complete v2.13.0 entry with full Bucket / Fixed / Deferred sections.

[2.12.0] - 2026-05-01

OKR Skills Launch. First release with the OKR Skills set: foundation-okr-writer and measure-okr-grader covering the full quarterly OKR write-and-score cycle. Adds 2 new skills (40 total) and 6 new thread-aligned library samples (126 total). Both skills shipped together so cross-skill hand-offs and the canonical 5-value OKR type enum (committed | aspirational | learning | operational_health | compliance_or_safety) are coherent at first appearance. Internal utility-pm-skill-builder packet-format simplification bundled silently. Phase 0 Adversarial Review Loop applied across both skills with 3 review rounds converged before tag.

Added

foundation-okr-writer with command /okr-writer. Drafts, reviews, rewrites, and coaches outcome-based OKR sets. Five entry modes (Guided default, One-Shot via --oneshot, Sustained Coach, Audit Only, Rewrite). Empowered-team diagnostic with conditional Disclosure section in the artifact when feature-team signals are present. 16-item anti-pattern catalog. Constraint Rules block (MUST / MUST NOT). Quality Audit Rubric. Refuses to fabricate baselines or targets, refuses compensation coupling, reframes feature-delivery KRs into outcome KRs.
measure-okr-grader with command /okr-grader. Scores completed OKR sets at cycle close per the canonical type enum: aspirational numeric, committed pass/fail, compliance_or_safety binary, operational_health pass/fail/drift-within-tolerance, learning validated/invalidated. Indicator class guardrail is independent of OKR type and adds a never-averaged-into-primary-score rule. Special states: not-yet-observable (cycle-window extensions past close) and not-yet-fully-observable (committed or compliance_or_safety with partial coverage; never softened to pass-on-in-scope). Refuses retroactive target changes, retroactive scope shrinkage on committed or compliance_or_safety KRs, and use of OKR scores for individual performance ratings. Hands off learnings to iterate-lessons-log, team-process work to iterate-retrospective, assumption tests to define-hypothesis, measurement gaps to measure-dashboard-requirements or measure-instrumentation-spec, and next-cycle drafting to foundation-okr-writer.
6 thread-aligned library samples at library/skill-output-samples/. 3 per skill across the storevine, brainshelf, and workbench threads. The storevine Campaigns thread now spans measure-experiment-results, foundation-okr-writer, and measure-okr-grader for a complete write-and-score arc on a single product context. Brainshelf samples demonstrate retention-thesis invalidation via a 1.6x at-scale multiplier vs the 3.4x in beta. Workbench samples demonstrate mixed-empowerment scoring: committed KR fail not softened to aspirational, compliance_or_safety KR marked not-yet-fully-observable on partial audit coverage, and committed KR with guardrail indicator class held within threshold band.
docs/skills/foundation/foundation-okr-writer.md and docs/skills/measure/measure-okr-grader.md mirror pages auto-generated by scripts/generate-skill-pages.py. Both skills appear in mkdocs.yml nav under their phase / classification section.

Changed

utility-pm-skill-builder packet format simplified. The Step 5 Skill Implementation Packet definition was reduced from 13 to 12 items per the prior session’s quiet refactor; nothing downstream depends on the removed item, and the packet format change does not affect any shipped skill or sample. Bundled silently with the OKR launch per design.
foundation-okr-writer/SKILL.md cross-reference cleanups now that the grader exists. Line 45 redirects scoring users directly to /okr-grader. Line 184 drops the “planned for a later release” framing.
README.md skill counts and version badge bumped: 38 → 40 skills (26 phase + 8 foundation + 6 utility), version 2.11.1 → 2.12.0.
.claude-plugin/plugin.json and marketplace.json version bumps to 2.12.0 with descriptions updated to reflect the 40-skill total and the new OKR Skills set.
library/skill-output-samples/README_SAMPLES.md updated for the 6 new OKR samples: total samples 120 → 126, total skills 38 → 40, Browse by Skill table extended, all three thread tables extended with OKR rows, footer version refreshed.

Infrastructure / process

Phase 0 Adversarial Review Loop applied across both new skills. The grader’s 3-round review converged on stable findings: round 1 caught 1 HIGH (workbench compliance KR retroactive scope shrinkage in sample) and 2 MEDIUM (/define-hypothesis nonexistent slash command, OKR-type-vs-indicator-class taxonomy drift); round 2 caught 2 MEDIUM (taxonomy drift propagation to TEMPLATE.md and sample KR3 framings); round 3 returned 0 findings. The writer’s earlier review caught 1 generator-script bug (HTML attribution comment rendering as page H1) and 1 nonexistent-command directive, both resolved before the writer commit.
Em-dash sweep extension across the auto-generated docs/skills/ mirror to keep the mirror in sync with the standing no-em-dash rule applied to source SKILL.md files.
docs/internal/audit-ci/ reorganized into docs/internal/audit/_archived/ to consolidate audit history under a single tree.
docs/internal/release-plans/v2.12.0/skills-manifest.yaml authored to match the v2.11.0 manifest format. Lists the two new skills with previous_version: null, change_type: added, version 1.0.0.
docs/releases/Release_v2.12.0.md authored with the standard release notes structure (TL;DR, mermaid summary, Added / Changed / Infrastructure sections, validation, links).

[2.11.1] - 2026-04-22

skills.sh CLI compatibility patch. Unblocks npx skills add product-on-purpose/pm-skills so the full 38-skill library is discoverable and installable through the open skills CLI and the skills.sh directory. No behavioral changes to any skill.

Fixed

6 foundation skills silently dropped by the skills CLI’s strict YAML parser because each SKILL.md opened with an HTML attribution comment before the --- frontmatter delimiter. Leading comment removed from foundation-lean-canvas, foundation-meeting-agenda, foundation-meeting-brief, foundation-meeting-recap, foundation-meeting-synthesize, foundation-stakeholder-update. Attribution is preserved via the identical comment that already lives immediately after the frontmatter block in each file.
foundation-meeting-synthesize description contained an inline ": " (colon-space) that strict YAML parsers interpret as a nested key-value separator, truncating the description. Reworded to split the sentence. Version bumped 1.0.0 → 1.0.1.
25 stale tracked files under .claude/skills/ (pre-v1 personal-setup relics) removed via git rm. The path was already gitignored; these files predated the rule. Affected directories: init-project/, init-project-jpkb/, wrap-session/.

Added

skills CLI install path in README as the recommended first option, with one-line npx skills add product-on-purpose/pm-skills and a new row in the Installation Options table. New skills.sh shield badge in the header badge row.
New lint rules in scripts/lint-skills-frontmatter.sh/.ps1/.md:
- First line of every SKILL.md must be the --- YAML delimiter (no preamble, comments, or attribution headers above it).
- Unquoted description field must not contain inline ": " patterns. If a colon is required, wrap the full description value in double quotes.
Distribution plan at docs/internal/distribution/2026-04-22_skills-sh.md documenting the six-phase submission approach (Phase 0 through 3 complete as of this release; Phase 4 optional; Phase 5 is a post-release soft-launch workstream).

Changed

Em-dash sweep completion: 376 tracked files swept, 5,805 em-dash characters replaced with . per the 2026-04-13 standing style rule. Zero behavioral change. Brings total em-dashes in tracked files to 0 (previous partial sweep had reduced a subset; this completes it across the full repo).
Stale count reconciliation: 8 current-state skill-count references across 5 files updated from 27 skills or 31 skills to 38 skills (docs/agent-skill-anatomy.md had 4 instances; one each in docs/skills/utility/utility-pm-skill-builder.md, scripts/README_SCRIPTS.md, skills/utility-pm-skill-builder/SKILL.md, and skills/utility-pm-skill-builder/references/EXAMPLE.md). Historical per-release count snapshots in README “What’s New” sections intentionally left untouched as accurate records of past release states.
README.md version badge bumped from 2.11.0 to 2.11.1.

Infrastructure / process

Dry-run against live skills CLI (npx skills add <local path> -l) added as a de facto pre-release validation. Phase 3 of the distribution plan documents the exact commands. Recommended for any future release that touches SKILL.md frontmatter.

[2.11.0] - 2026-04-18

Foundation-phase expansion release. Ships 6 new foundation skills (lean canvas + 5-skill meeting lifecycle family), a canonical skill-family contract pattern enforced by CI, 15 thread-aligned library samples, and end-user documentation. First pm-skills release with a cross-cutting skill-family contract. Two rounds of Codex adversarial review before tag.

Added

6 new foundation skills:

F-26: foundation-lean-canvas (/lean-canvas) - one-page business thesis across 9 interlocking blocks with optional HTML visual rendering (content + visual modes; Ash Maurya nine-block layout; 3 thread samples)
F-18: foundation-meeting-agenda (/meeting-agenda) - attendee-facing agenda with time-boxed topics, type tags, owners, prep; 10 meeting-type variants; anti-meeting check with synchronous-value requirement
F-25: foundation-meeting-brief (/meeting-brief) - user’s private strategic prep with stakeholder reads, ranked outcomes, anticipated Q&A; visibility: private default
F-27: foundation-meeting-recap (/meeting-recap) - topic-segmented post-meeting summary with decisions bold-flagged and actions inline; auto-discovers sibling agenda; ownership reconciliation threshold at 30% unassigned
F-17: foundation-meeting-synthesize (/meeting-synthesize) - cross-meeting archaeology surfacing patterns, trajectories, contradictions; format hints (board-prep, onboarding, retro-input, exec-brief)
F-28: foundation-stakeholder-update (/stakeholder-update) - async outward comms with 5 channel × 5 audience variants; explicit Shareable update boundary

Meeting Skills Family Contract v1.1.0 at docs/reference/skill-families/meeting-skills-contract.md - canonical, CI-enforced, shipped after two rounds of adversarial review with errata-within-version.

New directory pattern docs/reference/skill-families/ with landing-page index for future cross-cutting skill-family contracts.

Enforcing CI validator scripts/validate-meeting-skills-family.sh + .ps1 + .md, wired into .github/workflows/validation.yml. Checks contract-reference, zero-friction-execution section, shareable-summary/shareable-update section, sources-and-references structure, artifact_type enum values, and filename convention conformance across EXAMPLE.md + library samples.

15 new library samples (3 per meeting skill × storevine/brainshelf/workbench threads) conforming to SAMPLE_CREATION.md with 8-key top-level frontmatter + Scenario/Prompt/Output structure + fictional-marker discipline. Total library grew 94 → 120 (legacy/orbit samples accurately accounted for).

End-user guide docs/guides/using-meeting-skills.md with 3 mermaid diagrams (family skills graph, go-mode decision flow, chain sequence).

Release-plan companion docs:

plan_v2.11.0.md - release plan with decisions table and deliverables
plan_v2.11_codex-review.md - Round 1 + Round 2 findings tracker (26 findings total)
plan_v2.11_ci-coverage-analysis.md - CI gaps and follow-up scripts
plan_v2.11_pre-release-checklist.md - pre-release quality checklist (Phase 0 Adversarial Review Loop added from v2.11.0 learnings)
plan_v2.11_review-journal.md - comprehensive narrative of all reviews, findings, resolutions, pattern analysis

v2.12.0 backlog - 7 efforts created for sample-automation loop (F-31 to F-35) + meeting-skills ecosystem continuation (F-29, F-30). Stub at docs/internal/release-plans/v2.12.0/plan_v2.12.0.md.

Changed

Skill count 32 → 38 (+6: F-26 + 5 meeting skills)
Foundation classification 1 → 7 (adds lean-canvas + 5 meeting skills to persona)
Slash commands 39 → 45 (+6)
Current-state count references updated across README.md, CLAUDE.md, plugin.json, marketplace.json, docs/getting-started.md, docs/reference/commands.md, docs/skills/index.md, docs/reference/ecosystem.md, docs/reference/project-structure.md, docs/guides/mcp-setup.md, QUICKSTART.md, docs/index.md, docs/concepts/agent-skill-anatomy.md
library/skill-output-samples/README_SAMPLES.md - count 94 → 120 with 6-category breakdown (canonical, legacy/orbit, persona, lean-canvas, utility-single-thread, meeting-family)
AGENTS.md - 5 new foundation-meeting-* entries with family-contract note
mkdocs.yml - Foundation nav expanded to 7 skills + new Reference → Skill Families section + Guides section
.github/workflows/validation.yml - 2 new enforcing steps for validate-meeting-skills-family (bash + powershell)
docs/internal/efforts/F-17-meeting-synthesis.md and F-18-meeting-prep.md - archived to _NOTES/archived-efforts/ and rewritten with expanded family-aware scope

Infrastructure / process

Two rounds of Codex adversarial review (codex:codex-rescue subagent) documented in review journal; 26 findings total, 24 resolved same-session
Pre-release checklist now starts with Phase 0 Adversarial Review Loop - re-run Codex after each resolution pass until findings stabilize below IMPORTANT severity
First post-v1.0.0 contract version bump with errata-within-version documented in change log

Not shipped in v2.11.0 (deferred)

R1-I8 IMPORTANT: utility-pm-skill-validate per-skill field enforcement - scoped into F-31 for v2.12.0
Retroactive sample generation for existing skills that lack them - post-v2.12.0 candidate
MCP server unfreeze criteria (frozen per M-22)

[2.10.2] - 2026-04-14

Maintenance patch: corrects plugin manifest drift and extends the count-consistency CI to prevent it from recurring. No skill behavior changes.

Changed

.claude-plugin/plugin.json and marketplace.json - skill count in description corrected from 29 to 32 (reconciled with the 32-skill repo state shipped in v2.10.0)
scripts/check-count-consistency.sh / .ps1 / .md - extended to scan tracked .json files (previously .md only), so drift in plugin.json and marketplace.json is now caught by the same CI that covers markdown. Threshold comparison changed from > to >= to catch round-number boundary drift. Added exclusions for .github/.created-issues.json (tooling state) and .github/scripts/ (npm manifests).
README.md - v2.10.x What’s New entry corrected from “10 workflows” to “9 workflows” (no new workflow shipped in v2.10.x; the repo has been at 9 workflows since v2.9.0)

[2.10.1] - 2026-04-13

Documentation and tooling polish following v2.10.0. No skill behavior changes.

Added

Specifications for 10 backlog skills (draft effort briefs)
Generated docs/skills/ pages for F-16, F-19, F-24

Changed

scripts/generate-skill-pages.py - skill/command/workflow counts now computed dynamically instead of hardcoded, preventing the stale-count drift that previously required manual sweeps
Backlog updated to reflect v2.10.0 shipped state

Removed

F-25 effort brief (scope moved to a separate agent-config-toolkit initiative)

[2.10.0] - 2026-04-11

Note: F-16 (mermaid-diagrams) and F-19 (slideshow-creator) content has been available since v2.9.1 but is formally released and documented with v2.10.0 as the utility skill expansion release.

Added

F-16: utility-mermaid-diagrams - new utility skill teaching PMs to create syntactically valid mermaid diagrams. 15 diagram types with dual-lens navigation (type catalog + PM use-case guide), dedicated syntax validity reference, planning worksheet, and worked examples. 2,656 lines across 7 files.
F-19: utility-slideshow-creator - new utility skill for generating professional presentations from JSON deck specifications. 18 slide types with dark/light variants, content-to-layout decision logic, calibrated character limits, Google Slides compatibility. Ships with a generic professional theme. 766 lines across 7 files.
F-24: utility-update-pm-skills - new utility skill for checking, previewing, and applying pm-skills updates. Three modes: --status (quick version check), --report-only (preview without writing files), default (full update with confirmation). Includes validated-before-copy safety, optional backup, value-delta reports, post-update smoke test, 13-item quality checklist, FAQ, and degraded mode for no-network environments.
/mermaid-diagrams slash command
/slideshow-creator slash command
/update-pm-skills slash command with --status and --report-only flags
docs/guides/updating-pm-skills.md - user-facing guide for the update skill
_pm-skills/ local state directory convention (gitignored) for update reports and backups
7 new sample outputs in library/skill-output-samples/ for deliver-acceptance-criteria and all 6 utility skills (storevine thread). Sample library: 84 → 91, now covering all 32 skills.
Generated docs/skills/ pages for all 3 new utility skills

Changed

Repo now ships 32 skills (25 phase + 1 foundation + 6 utility), 39 command docs, and 10 workflows
Comprehensive docs count sweep across 20+ files
MCP server decoupled from pm-skills release cycle (M-22) - frozen, no longer a release prerequisite
Codex cross-LLM review completed for release plan and F-24 feature design (1 Blocker, 12 Major, 11 Minor resolved)

[2.9.1] - 2026-04-10

Added

D-05: Workflows guide - dedicated docs/guides/using-workflows.md with decision tree (mermaid), comparison matrix for all 9 workflows, invocation guide, and customization patterns. Replaces the brief workflow section previously in using-skills.md.
M-20: Documentation count consistency CI - 3 new validation script pairs:
- check-workflow-coverage - verifies every workflow has matching docs page, AGENTS.md entry, and mkdocs nav entry
- check-count-consistency - detects stale hardcoded skill/command/workflow counts in documentation
- check-generated-freshness - verifies generated workflow pages match sources
validate-version-consistency - hard-fail CI check ensuring plugin.json and marketplace.json versions match
validate-gitignore-pm-skills - advisory CI check for _pm-skills/ in .gitignore
validate-script-docs - advisory CI check ensuring every script pair has companion .md documentation
Companion .md documentation for all new scripts and 2 previously undocumented scripts (check-context-currency, check-stale-bundle-refs)
_pm-skills/ added to .gitignore (local state directory for update reports and backups)

Changed

scripts/README_SCRIPTS.md - expanded from 8 to 16 script entries with updated “When to use what” guide
.github/workflows/validation.yml - added 6 new CI checks (1 hard-fail, 5 advisory)
docs/guides/using-skills.md - trimmed workflow section to overview + link to new dedicated guide
docs/workflows/index.md - added link to workflows guide
mkdocs.yml - added “Using Workflows” nav entry under Guides
Fixed marketplace.json version 2.8.2 → 2.9.0 (was out of sync with plugin.json)

[2.9.0] - 2026-04-06

Added

6 new workflows: Customer Discovery, Sprint Planning, Product Strategy, Post-Launch Learning, Stakeholder Alignment, Technical Discovery
7 /workflow-* slash commands (1 renamed from M-19 + 6 new)
scripts/generate-workflow-pages.py - generates docs/workflows/ from source _workflows/

Changed

BREAKING: Renamed _bundles/ → _workflows/ and docs/bundles/ → docs/workflows/
BREAKING: Removed /kickoff command - replaced by /workflow-feature-kickoff
Renamed “Workflow Bundles” → “Workflows” across all documentation
Added URL redirects for old /bundles/* doc site paths

[2.8.2] - 2026-04-04

Added

Skill versioning concepts page - docs/concepts/versioning.md: public-facing guide to skill SemVer, HISTORY.md, skills-manifest.yaml, tie-breaker rule, and lifecycle tool integration.
git-revision-date-localized plugin - shows “last updated” and “created” dates on every page (enabled in CI).
Custom CSS - docs/stylesheets/extra.css for card grid, tag badge, and admonition styling.
Theme overrides directory - overrides/ for future MkDocs Material customization.
F-12 effort brief - skill quality convergence draft (first real-world use of lifecycle tools at scale).

Changed

requirements-docs.txt - added mkdocs-git-revision-date-localized-plugin.
mkdocs.yml - added git-revision-date, custom_dir, extra_css, versioning page in nav.
docs/reference/categories.md - fixed stale coordination skill count (5→7) and total (27→29).
marketplace.json - updated to v2.8.1 / 29 skills.

Release Notes

Documentation-only release. No skill or command behavior changes.
No pm-skills-mcp code changes required (docs parity update only).

[2.8.1] - 2026-04-04 (release notes)

Added

Documentation site at product-on-purpose.github.io/pm-skills - MkDocs Material with tab navigation, dark mode, search, and mermaid diagram rendering.
“Follow the Product” showcase - 3 interactive narrative journeys (Storevine B2B, Brainshelf Consumer, Workbench Enterprise) with 84 real sample outputs from the sample library, including prompts and full artifacts.
Skill finder - interactive decision tree and artifact table for choosing the right skill.
Recipes - 7 end-to-end workflows (Pitch a Feature, Run an Experiment, Launch a Feature, Discover and Frame, Define the Opportunity, Sprint Retro, Full Lifecycle) with mermaid flow diagrams.
Skill comparisons - 6 side-by-side comparisons for commonly confused skill pairs (PRD vs Solution Brief, Hypothesis vs Problem Statement, etc.).
Prompt gallery - curated real prompts in 3 styles (organized, casual, enterprise) from the sample library.
Per-skill real-world examples - 3 collapsible sample outputs (one per narrative thread) embedded on 25 skill pages.
Quick-try snippets - copy-pasteable slash command at the top of every skill page.
Phase flow diagrams - mermaid diagrams on all 6 phase index pages showing how skills connect.
Tags plugin - browse skills by phase and category tags.
Social cards - OpenGraph preview cards for link sharing (enabled in CI).
Generation scripts - scripts/generate-skill-pages.py (29 skill pages + indexes + commands ref) and scripts/generate-showcase.py (3 showcase journeys from sample library).
Deploy workflow - .github/workflows/deploy-docs.yml auto-deploys on push to main.
MkDocs config guide - docs/internal/mkdocs/mkdocs-config.md for maintainers.
MCP setup guide - docs/guides/mcp-setup.md for users: install, configure, and use pm-skills-mcp across Claude Desktop, Cursor, Claude Code, and VS Code.

Changed

MCP integration guide - updated tool counts (25→29 skill tools, 42 total), added acceptance-criteria and utility skill tools, updated slash command mapping table, removed stale catalog note, updated version references to v2.8.0.

Release Notes

Documentation-only release - no PM skill or slash-command behavior changes.
No pm-skills-mcp update required.
Site is generated from existing content (skills, samples, docs) plus new guide pages.
70+ navigable pages, zero build warnings.

[2.8.0] - 2026-04-03 (release notes)

Added

F-10: utility-pm-skill-validate skill (#121) - second utility skill. Audits existing skills against structural conventions (mirroring CI) and LLM-assessed quality criteria. Produces a pipe-delimited validation report (Report schema: v1) with severity-graded findings (FAIL/WARN/INFO) and actionable recommendations with target file paths. Two-tier assessment rebaselined against shipped library conventions. Includes SKILL.md, TEMPLATE.md (report format), EXAMPLE.md (validated deliver-prd), /pm-skill-validate command, and AGENTS.md entry. Skill count: 27 → 28.
F-11: utility-pm-skill-iterate skill (#122) - third utility skill. Applies targeted improvements to existing skills from feedback, validation reports, or convention changes. Unified flow with input normalization, before/after preview, stale-preview guard, version bump class suggestion (don’t auto-write), and HISTORY.md creation at second-version trigger point. Includes SKILL.md, TEMPLATE.md (change summary), EXAMPLE.md (iterated deliver-prd), /pm-skill-iterate command, and AGENTS.md entry. Skill count: 28 → 29.
M-18: CI skill versioning validation - two new advisory scripts following .sh + .ps1 + .md convention: validate-skill-history (checks HISTORY.md tracks current frontmatter version) and validate-skills-manifest (checks release manifest entries match skill directories). Added to validation.yml with continue-on-error: true.
D-03: docs/pm-skill-lifecycle.md - public guide explaining the Create → Validate → Iterate lifecycle with workflow patterns (new skill, improve existing, convention change, feedback loop), CI vs validator comparison, and quality standard model.
Governance: docs/internal/skill-versioning.md - SemVer rules for skills, HISTORY.md contract, skills-manifest.yaml format, release checklist, and tie-breaker rule for gray-area version bump classification.
docs/internal/release-plans/v2.7.0/skills-manifest.yaml - retroactive first use of the skills-manifest convention.
docs/internal/release-plans/v2.8.0/ - release governance with phased execution plan and Codex design review.

Changed

D-04: public docs refresh for v2.8.0 - updated skill counts (29), command counts (30), utility skill breakdown (3), Skill Lifecycle Tools section in README and QUICKSTART, command table, AGENTS.md entries, AGENTS/claude/CONTEXT.md, docs/pm-skill-anatomy.md lifecycle cross-reference, and scripts/README_SCRIPTS.md with M-18 script documentation.
docs/internal/releases/ renamed to docs/internal/release-plans/ with all internal references updated (34 files).
docs/internal/backlog-canonical.md updated with v2.8.0 assignments (F-10, F-11, D-03, M-18, D-04).

Release Notes

Completes the PM skill lifecycle: Create (/pm-skill-builder, v2.7.0) → Validate (/pm-skill-validate) → Iterate (/pm-skill-iterate).
First release with skill versioning governance - skills-manifest.yaml per release, HISTORY.md per skill (opt-in), SemVer tie-breaker rule.
First release with advisory CI for skill versioning - HISTORY.md and skills-manifest.yaml validators.
Repo now contains 29 skills (25 domain + 1 foundation + 3 utility), 30 command docs, and 3 workflow bundles.
MCP note: pm-skills-mcp needs a re-embed to pick up both new skills. utility-pm-skill-validate → pm_pm_skill_validate. utility-pm-skill-iterate → pm_pm_skill_iterate.

[2.7.0] - 2026-03-22 (release notes)

Added

F-06: deliver-acceptance-criteria skill (#114) - new Deliver phase skill for Given/When/Then acceptance criteria generation covering happy path, edge cases, error states, and non-functional criteria. Includes SKILL.md, TEMPLATE.md, EXAMPLE.md (e-commerce checkout scenario), /acceptance-criteria command, and AGENTS.md entry. Skill count: 25 → 26.
F-05: utility-pm-skill-builder skill (#113) - first utility-classified skill. Interactive builder that guides contributors from a PM skill idea to a complete Skill Implementation Packet with gap analysis, Why Gate, classification, exemplar-driven drafting, and staging-to-promotion workflow. Includes SKILL.md, TEMPLATE.md, EXAMPLE.md (change-communication scenario), /pm-skill-builder command, and AGENTS.md Utility Skills section. Skill count: 26 → 27.
M-12: CI validation enhancement (#112) - extended linter with description word count (20-100) and TEMPLATE.md header count (≥3) checks; new validate-agents-md script for AGENTS.md ↔ skill directory sync; new check-mcp-impact advisory script for MCP impact detection. All scripts follow .sh + .ps1 + .md convention.
M-16: exclude docs/internal from release ZIP (#123) - release packagers (build-release.sh and .ps1) now strip docs/internal/** from staged artifacts. Internal governance docs stay tracked in-repo but no longer ship to end users.
D-01: docs/pm-skill-anatomy.md - practical guide to pm-skills skill structure covering directory layout, classification types, frontmatter, Triple Diamond phases, wiring layer, and CI validation. Complements the spec-level docs/agent-skill-anatomy.md.
_staging/ added to .gitignore for pm-skill-builder draft artifacts.

Changed

D-02: public docs review for v2.7.0 - updated skill counts (27), command counts (28), M-12 script documentation, domain/foundation/utility classification model, skill template modernization, frontmatter schema with utility example, and docs/agent-skill-anatomy.md scope note. Post-F-05 reconciliation patched 3 stale references.
Fixed duplicate workflow steps in validation.yml (validate-agents-md and check-mcp-impact each ran twice).
AGENTS.md gains a ### Utility Skills section and /pm-skill-builder in the Commands table.
docs/internal/backlog-canonical.md rewritten with Release, Status, and Agent columns.
Release governance folders created for v2.2.0, v2.3.0, and v2.7.0 (v2.2.0 and v2.3.0 migrated from legacy locations).

Removed

docs/internal/delivery-plan/ - legacy directory removed from tracking.
docs/internal/release-planning/ - legacy directory removed from tracking.

Release Notes

First release with a utility skill classification - pm-skill-builder creates new PM skills interactively.
First release with enhanced CI: frontmatter linting, AGENTS.md sync validation, MCP impact detection.
Release ZIPs now exclude docs/internal/** while preserving all public documentation.
Repo now contains 27 skills (25 domain + 1 foundation + 1 utility), 28 command docs, and 3 workflow bundles.
MCP note: pm-skills-mcp needs a re-embed to pick up both new skills. deliver-acceptance-criteria → pm_acceptance_criteria. utility-pm-skill-builder → pm_pm_skill_builder (double pm_ is intentional - preserves skill name, consistent with future pm_agent_skill_builder). Update embed-skills.js to strip classification prefixes (foundation-, utility-) alongside phase prefixes.

[2.6.1] - 2026-03-04

Added

Release note artifact:
- docs/releases/Release_v2.6.1.md

Changed

Sample output library moved and normalized to:
- library/skill-output-samples/
Sample creation standards filename standardized to:
- library/skill-output-samples/SAMPLE_CREATION.md
Sample coverage manifest moved to release-planning artifacts (internal)
Release packaging now includes sample-library content:
- scripts/build-release.sh
- scripts/build-release.ps1
Release workflow-generated notes now list sample-library inclusion:
- .github/workflows/release.yml
README release metadata rolled forward to v2.6.1.

Release Notes

Patch release focused on sample-library recovery, naming/path normalization, and release-artifact inclusion.
No PM skill instruction or slash-command behavior changes.

[2.6.0] - 2026-03-04

Added

Claude plugin manifest: .claude-plugin/plugin.json.
Plugin packaging validation workflow:
- .github/workflows/validate-plugin.yml
Release note artifact:
- docs/releases/Release_v2.6.0.md

Changed

Release packaging now includes .claude-plugin/ in ZIP staging:
- scripts/build-release.sh
- scripts/build-release.ps1
Release packaging now enforces staged plugin-manifest version parity with the target release version.
GitHub release workflow notes now include plugin-manifest install guidance:
- .github/workflows/release.yml
README release/install guidance updated for plugin install plus explicit Copilot/OpenCode setup notes.

Release Notes

Minor release focused on Claude plugin packaging and release automation hardening.
No PM skill or slash-command behavior changes.
No pm-skills-mcp deploy is included in this release scope.

[2.5.2] - 2026-03-04

Changed

Rewrote public release-facing docs for clearer user-first language and historical readability.
Removed internal decision-ID style references from release-facing docs where they were not needed for external readers.
Removed local working-note path references from public release artifacts.
Added release note artifact:
- docs/releases/Release_v2.5.2.md

Release Notes

Patch release focused on public documentation quality and release-communication clarity.
No PM skill behavior changes and no output/config contract changes from v2.5.0.

[2.5.1] - 2026-03-04

Changed

Canonicalized Claude agent continuity workspace to AGENTS/claude/ and retired active AGENTS/claude-opus* paths.
Updated tracked .claude scaffolding templates to emit AGENTS/claude for init/wrap workflows.
Added clean-worktree release runbook for deterministic cut/tag/publish lanes:
- docs/internal/release-planning/runbook_clean-worktree-cut-tag-publish.md

Release Notes

Patch release focused on agent-workspace naming consistency and release-lane operational hygiene.
No PM skill behavior changes and no output/config contract changes from v2.5.0.

[2.5.0] - 2026-03-02

Added

Foundation persona capability with:
- skills/foundation-persona/ skill + references
- /persona command at commands/persona.md
- AGENTS discovery coverage for foundation classification

Highlights

Taxonomy updates shipped with explicit foundation classification handling.
Sample-library lane closure evidence captured in release planning/checklist artifacts.
Doc-hygiene closure completed across README/getting-started and release metadata references.
Persona archetype library shipment and full persona MCP exposure parity remain deferred from v2.5.0.

[2.4.3] - 2026-02-16

Added

Release note artifact: docs/releases/Release_v2.4.3.md.

Changed

Rolled forward release metadata references to treat v2.4.3 as the latest stable patch:
- README.md
- CHANGELOG.md
Captured explicit published-artifact links in release docs:
- docs/releases/Release_v2.4.3.md

Release Notes

Patch release to include post-v2.4.2 documentation/release-link updates in tagged artifacts.
No PM skill behavior changes and no output/config contract changes from v2.4.0.

[2.4.2] - 2026-02-16

Added

Release note artifact: docs/releases/Release_v2.4.2.md.
Canonical delivery-plan policy and migration docs:
- docs/internal/delivery-plan/README.md
- docs/internal/delivery-plan/v2.4-contract-lock-summary.md
- docs/internal/delivery-plan/v2.5/ continuity kickoff artifacts

Changed

Started v2.5 continuity execution in tracked release-planning artifacts and checklist status.
Updated release-planning and v2.4 release docs to treat docs/internal/delivery-plan/ as canonical release-governance truth.
Archived legacy internal repo-submission planning docs from tracked docs/internal/.

Removed

Legacy internal docs from tracked docs/internal/:
- docs/internal/repo-list_claude-code.md
- docs/internal/pr-quick-reference.md
- docs/internal/awesome-product-management-pr.md
- docs/internal/AWESOME-PM-PR.md
- docs/internal/awesome-lists-submission-package.md
- docs/internal/awesome-lists-submission-package_planning.md
- docs/internal/link-notes.md

Release Notes

Patch release focused on governance hygiene and tracked-vs-local artifact clarity.
No PM skill behavior changes and no output/config contract changes from v2.4.0.
Published GitHub release: https://github.com/product-on-purpose/pm-skills/releases/tag/v2.4.2.

[2.4.1] - 2026-02-16

Added

Release note artifact: docs/releases/Release_v2.4.1.md.
Long-form internal delivery/engineering explainer:
- docs/internal/Releases_2.3-2.4_detailed-breakdown.md

Changed

Finalized v2.4.x release-doc consistency:
- README.md
- CHANGELOG.md
- docs/releases/Release_v2.4.md
- docs/internal/release-planning/checklist_v2.4.0.md
- docs/internal/release-planning/Release_v2.2_to_v2.5_execution-plan.md

Release Notes

Patch follow-up for release documentation and communication alignment only.
No new PM skills and no output/config contract behavior changes from v2.4.0.

[2.4.0] - 2026-02-16

Added

Release note artifact: docs/releases/Release_v2.4.md.
Canonical tracked contract-lock summary:
- docs/internal/delivery-plan/v2.4-contract-lock-summary.md

Changed

Release-planning artifacts updated for v2.4.0 ship state:
- docs/internal/release-planning/Release_v2.2_to_v2.5_execution-plan.md
- docs/internal/release-planning/checklist_v2.4.0.md
- docs/internal/release-planning/README.md
Canonical backlog release cadence anchors synced for v2.4 closure:
- docs/internal/backlog-canonical.md
v2.4 contract-lock closure state advanced to closed-aligned and is summarized in:
- docs/internal/delivery-plan/v2.4-contract-lock-summary.md
Expanded validate-mcp-sync checks to include pm-skills-mcp pin metadata and contract-version parity via pm-skills-source.json.
Corrected MCP integration guide utility-tool inventory to 7 tools (pm_cache_stats included).
Updated MCP compatibility references to direct version tracking (pm-skills v2.4.x ↔ pm-skills-mcp v2.4.x) in ecosystem/integration docs.

Release Notes

This release closes the v2.4.0 contract-lock scope:
- Output behavior contract locked and recorded as aligned.
- Configuration contract/schema lock recorded as aligned with validator proof artifacts.

[2.3.0] - 2026-02-13

Added

Release note artifact: docs/releases/Release_v2.3.md.

Changed

MCP sync workflow default mode switched to block in .github/workflows/validate-mcp-sync.yml (manual workflow_dispatch can still set observe).
Updated MCP sync guide for blocking-default rollout state (docs/guides/validate-mcp-sync.md).
Updated compatibility references for current MCP status:
- README.md note now points to pm-skills-mcp v2.1+ as aligned baseline.
- docs/reference/ecosystem.md reflects 36 MCP tools (24 skills + 5 workflows + 7 utilities).
Release-planning artifacts updated for v2.3.0 closure:
- docs/internal/release-planning/checklist_v2.3.0.md
- docs/internal/release-planning/Release_v2.2_to_v2.5_execution-plan.md

Release Notes

This release closes the v2.3.0 scope:
- Cross-repo alignment closure recorded on pinned refs.
- Blocking validate-mcp-sync mode enabled by default.

[2.2.0] - 2026-02-13

Added

Validation-only MCP drift checker script: .github/scripts/validate-mcp-sync.js
MCP sync workflow: .github/workflows/validate-mcp-sync.yml (observe-only default)
MCP sync usage guide: docs/guides/validate-mcp-sync.md
Planning persistence governance docs:
- docs/internal/planning-persistence-policy.md
- docs/internal/planning-artifact-tier-map.md
Canonical backlog governance reference: docs/internal/backlog-canonical.md
Release execution artifacts:
- docs/releases/Release_v2.2.md
- docs/internal/release-planning/Release_v2.2_to_v2.5_execution-plan.md
- docs/internal/release-planning/checklist_v2.2.0.md
- docs/internal/release-planning/checklist_v2.3.0.md
- docs/internal/release-planning/checklist_v2.4.0.md
- docs/internal/release-planning/checklist_v2.5.0.md

Changed

CONTRIBUTING.md: added MCP sync guardrail guidance for contributors.
scripts/README_SCRIPTS.md: clarified .github/scripts/ usage and drift-check rollout.
docs/guides/mcp-integration.md: linked new MCP sync validation guide.
.gitignore: aligned AGENTS ignore rules with planning persistence policy.

Release Notes

This release establishes guardrails and governance:
- Observe-only sync validation baseline.
- Planning persistence policy baseline.
- Canonical backlog governance baseline.

[2.1.0] - 2026-01-27

Added

MCP Alignment Milestone - pm-skills-mcp v2.1.0 now fully aligned with flat structure
Version alignment table in ecosystem documentation

Changed

Updated ecosystem documentation noting MCP v2.1 compatibility
Clarified that pm-skills-mcp v2.1+ is required for full compatibility with pm-skills v2.x flat structure

Ecosystem

pm-skills-mcp v2.1.0 released with:
- Flat resource URIs: pm-skills://skills/{skill}
- Phase read from frontmatter, not path
- Tool names remain stable (pm_prd, pm_hypothesis, etc.)

[2.0.1] - 2026-01-27

Added

Validation workflow (validation.yml) running command + front-matter checks on Ubuntu and Windows.
Front-matter lint scripts (scripts/lint-skills-frontmatter.sh / .ps1) that verify required keys, directory-name alignment, and reference files.
Noted command validator scripts in project structure/README.
Scripts guide renamed to scripts/README_SCRIPTS.md to avoid name collisions.

Changed

Removed nested metadata.version fields from all skills; lint now enforces a single root version and required keys.
Parameterized build scripts (build-release.sh / .ps1) and release workflows to derive artifact names from the tag/ref (defaulting to v2.0.1); added zip/hash fallbacks for Windows.
validate-commands now reports multi-skill bundles (e.g., /kickoff) without misleading first-path-only output.
README path examples updated to skills/{phase-skill}/; AGENTS.md clarifies bundle links are repo-relative; release workflow typo fixed (openskills).
Moved skill templates to docs/templates/ and updated references (authoring guide, README, project-structure, AGENTS context).
README refresh: expanded v2.0 highlights, updated project structure tree, roadmap in-progress items, note that pm-skills-mcp v1.x is outdated (v2.1 underway).
docs/reference/project-structure.md now has a table of contents, updated directory tree, full commands list, and template path.

[2.0.0] - 2026-01-26

Breaking

Repository flattened to skills/{phase-skill}/ (hyphen-only). All prior nested skills/<phase>/<skill>/ paths removed.
Slash commands now point to the flat skill paths; update local references/scripts accordingly.

Added

Sync helpers scripts/sync-claude.sh and scripts/sync-claude.ps1 to regenerate .claude/skills and .claude/commands for Claude Code / openskills discovery with validation.
Build scripts scripts/build-release.sh and scripts/build-release.ps1 to create pm-skills-v2.0.zip with manifest/hash (excludes populated .claude).
.claude/pm-skills-for-claude.md usage note for discovery.

Changed

All 24 skills renamed to flat {phase-skill} directories; SKILL front matter updated with phase, version: 2.0.0, and updated: 2026-01-26.
Docs refreshed to reflect flat structure and two-path install story (flat source vs. optional .claude/ via sync helper), including README, QUICKSTART, AGENTS, bundles, guides, and references.
Workflows (release.yml, release-zips.yml) call the new build-release script.
.gitignore now excludes .claude/skills, .claude/commands, and dist/.

Validation

Path scan confirms no residual skills/<phase>/ references in public docs/commands.
Front-matter check: all skills/*/SKILL.md include required name, phase, version, updated.

[1.2.0] - 2026-01-20

PM-Skills v1.2.0 - Security & Community Infrastructure

This release adds essential security policies, automated vulnerability scanning, and improved issue/PR templates for community contributions.

Added

SECURITY.md - Security policy with vulnerability reporting guidelines
CodeQL code scanning - Automated security analysis via GitHub Actions (.github/workflows/codeql.yml)
Dependabot configuration - Automated dependency updates for GitHub Actions and npm (.github/dependabot.yml)
Issue templates - Structured forms for bug reports and feature requests
- bug_report.yml - Skill-specific bug reporting with environment details
- feature_request.yml - New skill and enhancement proposals
- config.yml - Directs questions to Discussions, security issues to policy
Pull request template - Standardized PR checklist (.github/PULL_REQUEST_TEMPLATE.md)

Changed

Issue creation now requires using templates (blank issues disabled)

Security

Enabled CodeQL scanning for JavaScript analysis on push, PR, and weekly schedule
Added security policy with responsible disclosure guidelines

[1.1.1] - 2026-01-20

Added

CODE_OF_CONDUCT.md - Contributor Covenant v2.1 for community guidelines
Attribution headers - Added HTML comment attribution to all 24 SKILL.md files
Open-skills ecosystem submissions
- Submitted PR to awesome-claude-skills
- Submitted to n-skills marketplace

Changed

CONTRIBUTING.md - Updated Code of Conduct section to link to dedicated CODE_OF_CONDUCT.md
README.md - Updated openskills CLI installation section with accurate guidance
README.md - Minor formatting cleanup (em dashes, navigation labels, alt text)

Fixed

openskills#48 resolved - numman-ali/openskills#48 fixed in openskills v1.3.1
- Root cause: hardcoded / path separator failed on Windows
- Verified: anthropics/skills now installs all 17 skills successfully
- Note: pm-skills uses deeper nesting than openskills auto-discovers; Git clone recommended

[1.1.0] - 2026-01-16

PM-Skills v1.1.0 - Documentation & README Overhaul

This release brings a comprehensive documentation expansion and a major README redesign following open-source best practices. The README now features better navigation, an FAQ section, and improved discoverability.

Added

Comprehensive Documentation Expansion
- docs/getting-started.md - Detailed setup guide covering 5 installation methods
- docs/guides/using-skills.md - Beginner to advanced usage guide with SPICE context framework, skill chaining, and 7 power-user patterns
- docs/guides/authoring-pm-skills.md - Complete guide for creating and submitting new skills
- docs/frameworks/triple-diamond-delivery-process.md - Triple Diamond methodology documentation
README Major Enhancements
- Collapsible Table of Contents for easier navigation
- FAQ section with 7 expandable Q&A items covering common questions
- License section with Apache 2.0 permissions explained
- Acknowledgments section crediting frameworks and resources
- About the Author section
- More Suggestions section for community engagement
- Project Status badge (Active)
- GitHub stats badges (stars, forks, issues, contributors, last commit)
- Back-to-top navigation links throughout
- Change Log Summary table with version highlights
- Releases section with download badge
- Expanded Usage intro explaining skills, commands, and bundles
- Workflow Bundles intro paragraph
- Updated Built with section with visual badges
Open-Skills Ecosystem Integration
- Prepared PR content for awesome-claude-skills submission
- Prepared submission content for n-skills marketplace
- Documented openskills CLI compatibility testing
- Filed openskills#48 for nested path bug
GitHub Release Workflow
- .github/workflows/release.yml - Automated ZIP creation on tag push
- Creates two artifacts: full package + Claude.ai bundle
CLAUDE.md - Agent instructions with documentation rules

Changed

Documentation Reference Files Significantly Expanded
- docs/reference/categories.md - Expanded from 54 to 420+ lines with diagrams, workflows, and framework mappings
- docs/reference/frontmatter-schema.yaml - Expanded from 91 to 600 lines with validation rules, examples, and best practices
New /docs Taxonomy Structure
- docs/reference/ - Technical specifications (categories, schema)
- docs/guides/ - How-to guides (using-skills, authoring-pm-skills)
- docs/frameworks/ - Methodology documentation (triple-diamond)
Renamed _docs/ → docs/ and _templates/ → templates/ for standard conventions
README.md restructured following best-practices from Best-README-Template and amazing-github-template
Updated README.md Quick Start with 4 installation options (Git clone recommended)
Reordered installation methods based on openskills bug discovery
Version badge updated to 1.1.0

Fixed

Discovered and documented openskills#48 - nested directory structure bug affecting pm-skills and anthropics/skills

[1.0.1] - 2026-01-15

Added

All 24 Slash Commands Complete - Every skill now has a corresponding command
- /competitive-analysis - Discover phase
- /interview-synthesis - Discover phase
- /stakeholder-summary - Discover phase
- /jtbd-canvas - Define phase
- /opportunity-tree - Define phase
- /adr - Develop phase
- /design-rationale - Develop phase
- /solution-brief - Develop phase
- /spike-summary - Develop phase
- /edge-cases - Deliver phase
- /launch-checklist - Deliver phase
- /release-notes - Deliver phase
- /dashboard-requirements - Measure phase
- /experiment-design - Measure phase
- /experiment-results - Measure phase
- /instrumentation-spec - Measure phase
- /lessons-log - Iterate phase
- /pivot-decision - Iterate phase
- /refinement-notes - Iterate phase
- /retrospective - Iterate phase
GitHub issues #43-62 created and closed for slash command tracking

Changed

Updated README.md Slash Commands section to list all 24 commands
Updated AGENTS.md Commands section to list all 24 commands
Updated plan-open-skills.md compatibility table to reflect slash commands complete

[1.0.0] - 2026-01-14

PM-Skills v1.0.0 - Complete Triple Diamond coverage is here!

This release marks the completion of all 24 PM skills across the entire product development lifecycle. From discovery to iteration, PM-Skills now provides comprehensive coverage for product managers using AI assistants.

Added

Phase 3 Complete: P2 Skills (11 skills) - All 24 skills now implemented!
- competitive-analysis skill - Discover phase (skills/discover-competitive-analysis/)
- stakeholder-summary skill - Discover phase (skills/discover-stakeholder-summary/)
- opportunity-tree skill - Define phase (skills/define-opportunity-tree/)
- jtbd-canvas skill - Define phase (skills/define-jtbd-canvas/)
- design-rationale skill - Develop phase (skills/develop-design-rationale/)
- dashboard-requirements skill - Measure phase (skills/measure-dashboard-requirements/)
- experiment-results skill - Measure phase (skills/measure-experiment-results/)
- retrospective skill - Iterate phase (skills/iterate-retrospective/)
- lessons-log skill - Iterate phase (skills/iterate-lessons-log/)
- refinement-notes skill - Iterate phase (skills/iterate-refinement-notes/)
- pivot-decision skill - Iterate phase (skills/iterate-pivot-decision/)
Each skill includes SKILL.md, references/TEMPLATE.md, and references/EXAMPLE.md
GitHub labels: phase-3, P2
GitHub issues #26-36 for skill tracking
Phase 3 Infrastructure: Workflow Bundles
- _bundles/triple-diamond.md - Complete product development cycle guide
- _bundles/lean-startup.md - Build-Measure-Learn rapid iteration guide
- _bundles/feature-kickoff.md - Quick-start workflow for feature development
Phase 3 Infrastructure: Slash Commands
- commands/prd.md - Create Product Requirements Document
- commands/problem-statement.md - Create problem statement
- commands/hypothesis.md - Define testable hypothesis
- commands/user-stories.md - Generate user stories
- commands/kickoff.md - Run Feature Kickoff workflow
Phase 3 Infrastructure: Agent Discovery
- AGENTS.md - Universal agent discovery file listing all 24 skills
Phase 3 Infrastructure: GitHub Actions
- .github/workflows/sync-agents-md.yml - Auto-sync AGENTS.md on skill changes
- .github/workflows/release-zips.yml - Package skills as ZIPs on release

Changed

Updated README.md Skills Inventory badge to 24/24 (complete)
Updated README.md all skill status indicators to ✅
Updated README.md roadmap to show Phase 3 P2 Skills complete
Updated CONTEXT.md to reflect Phase 3 completion

[0.3.0] - 2026-01-14

Added

Phase 2 Complete: P1 Skills (8 skills)
- interview-synthesis skill - Discover phase (skills/discover-interview-synthesis/)
- solution-brief skill - Develop phase (skills/develop-solution-brief/)
- spike-summary skill - Develop phase (skills/develop-spike-summary/)
- adr skill - Develop phase (skills/develop-adr/)
- edge-cases skill - Deliver phase (skills/deliver-edge-cases/)
- release-notes skill - Deliver phase (skills/deliver-release-notes/)
- experiment-design skill - Measure phase (skills/measure-experiment-design/)
- instrumentation-spec skill - Measure phase (skills/measure-instrumentation-spec/)
Each skill includes SKILL.md, references/TEMPLATE.md, and references/EXAMPLE.md
GitHub labels: phase-2, P1
GitHub milestone: v0.3.0 - P1 Skills
GitHub issues #18-25 for skill tracking

Changed

Updated README.md Skills Inventory with status indicators (✅ implemented, 🔜 coming soon)
Updated README.md roadmap to show Phase 2 complete
Updated plan-v1.md Progress Tracker with GitHub issue links for Phase 2
Updated CONTEXT.md to reflect Phase 2 completion and add Skills Inventory table

[0.2.0] - 2026-01-14

Added

Phase 1 Complete: P0 Core Skills
- problem-statement skill - Define phase (skills/define-problem-statement/)
- hypothesis skill - Define phase (skills/define-hypothesis/)
- prd skill - Deliver phase (skills/deliver-prd/)
- user-stories skill - Deliver phase (skills/deliver-user-stories/)
- launch-checklist skill - Deliver phase (skills/deliver-launch-checklist/)
Each skill includes SKILL.md, references/TEMPLATE.md, and references/EXAMPLE.md
GitHub labels: skill, phase-1, P0
GitHub milestone: v0.2.0 - P0 Core Skills
GitHub issues #10-14 for skill tracking

Changed

Updated plan-v1.md Progress Tracker with GitHub issue links
Updated CONTEXT.md to reflect Phase 1 completion

[0.1.0] - 2026-01-14

Added

Initial project structure with agentic coding support
Comprehensive README.md with badges, skills inventory, and platform compatibility matrix
Apache 2.0 LICENSE
CHANGELOG.md following Keep a Changelog format
.gitignore with standard exclusions
AGENTS/claude-opus-4.5/ folder for AI session continuity
- CONTEXT.md - Project state tracking
- TODO.md - Task management
- DECISIONS.md - Technical decision log
- SESSION-LOG/ - Session documentation
PLANNING/ folder convention for collaboration artifacts (reviews, drafts, analysis)
plan-v1-review.md - Comprehensive review of implementation plan
v0.1 tag - Plan review milestone
9 GitHub issues for plan-v1.md improvement opportunities
Phase 0 Foundation Complete:
- CONTRIBUTING.md with curated contribution model
- Full directory structure (skills/, _bundles/, docs/, templates/, commands/)
- Schema documentation (_docs/frontmatter-schema.yaml)
- Category reference (_docs/categories.md)
Skill template structure (docs/templates/skill-template/ with SKILL.md, TEMPLATE.md, EXAMPLE.md)
wrap-session skill for end-of-session documentation workflow

Changed

Updated CONTEXT.md status from “Foundation complete” to “Foundation in progress (~40%)”
Updated plan-v1.md Progress Tracker with inline status notes
Fixed README.md roadmap to reflect accurate Phase 0 status
Phase 0 → 100% complete - All foundation infrastructure now in place
Updated README.md roadmap to show Phase 0 complete
Expanded P1/P2 skill guidance in plan-v1.md (Issues #11-29)
Updated example dates in templates to use <YYYY-MM-DD> placeholder
Added PowerShell validation commands for Windows compatibility

Fixed

Pre-Flight Checklist path error in planning document
VISION.md location inconsistency resolved
Issue #1 conflict with existing files (added “skip if exists” note)

Closed

All 9 GitHub issues (#1-9) - plan improvements complete