Quality differentiation pass on the 54 PM skills.
1. RED-FLAG LIBRARIES (~12,000 lines across 54 files)
Each PM skill now has references/red-flags.md with 10-12 concrete
anti-patterns. Each red flag has:
- Symptom (one sentence)
- Why it's bad (downstream harm)
- Bad example (quoted artifact snippet)
- Good example (same scenario done right)
- How to catch it (specific check question)
Plus a Quick Reference table and Related Reading section.
Anchors to canonical authors: Wodtke, Wake, Lawrence, Vacanti,
Allspaw, Dekker, Cagan, Klein, Klement, Ellis, McClure, Karpathy,
Anthropic RSP, Ramanujam, Westendorp, Fowler, Conway, Watkins, Lin,
Pichler, Moore, Raskin, Strategyzer, Ulwick, Moesta, Christensen,
Fitzpatrick, Portigal, Torres, Patton, Google SRE.
Highlight red flags:
- status-update-generator: watermelon status
- create-prd: solution-before-problem
- post-mortem: blame language vs systemic framing
- brainstorm-okrs: output-as-KR, sandbagging, mid-Q drift
- customer-feedback-triage: squeaky-wheel bias
- north-star-metric: NSM = revenue
- ai-feature-prd: hallucination tolerance hand-waving
2. RUNNABLE PIPELINES (5 stdlib-only scripts at pipelines/)
Chain multiple PM skills end-to-end with one command.
- feature-end-to-end.py: 7 skills (assumptions -> experiments ->
pre-mortem -> PRD -> OKRs -> priorities -> release notes)
- weekly-cadence.py: 4 skills (adapter -> status + flow + deps)
- customer-discovery.py: 4 skills (interview-synthesis -> assumptions
-> experiments -> NSM)
- post-mortem-flow.py: 3 skills (post-mortem -> follow-up risks ->
cross-team mitigations)
- launch-coordination.py: 4 skills (beta -> flags -> launch -> notes)
Each supports --demo, --input <json>, --format markdown|json,
--output <dir>. Pipelines gracefully stub a stage if the downstream
tool isn't available, so the chain always completes. Smoke-tested:
feature-end-to-end --demo and post-mortem-flow --demo both produce
stage artifacts + summary.md.
PM README updated with Red Flags and Pipelines sections. CHANGELOG
[4.6.0] entry added.
Pipelines
Runnable skill-chain pipelines that orchestrate multiple PM skills end-to-end.
Each pipeline is a standalone Python script (stdlib only) that calls the
underlying PM skill scripts via subprocess and emits a single summary plus
per-stage artifacts. Every pipeline supports --demo for a no-input dry
run with built-in sample data, --format markdown|json for the summary
output, and --output <dir> to save artifacts to a directory.
If a downstream skill's Python tool is not present, the pipeline writes a stub artifact and continues -- this keeps the pipeline runnable in any environment, while signaling which tools need to be installed.
Date: 2026-05-22
The five pipelines
| Pipeline | When to use | Inputs | Outputs |
|---|---|---|---|
| feature-end-to-end.py | Greenfield feature: discovery -> PRD -> OKRs -> backlog -> release | feature JSON (name, owner, target release, evidence) | 7 stage artifacts + summary |
| weekly-cadence.py | Friday/Monday cadence: status + flow metrics + dependencies | Jira or Linear export JSON | status.md, flow.md, deps.md + summary |
| customer-discovery.py | Discovery sprint: interviews -> opportunity tree -> assumption map -> experiments -> NSM | interviews JSON | opportunities.json + 4 stage artifacts + summary |
| post-mortem-flow.py | After an incident: RCA + follow-up risk classification + cross-team mitigations | incident JSON | post-mortem doc + followup-risks.json + summary |
| launch-coordination.py | Coordinated launch: beta -> flags -> playbook -> release notes | launch JSON | 4 stage artifacts + go/no-go checklist + summary |
Quick start
# Run any pipeline with built-in demo data
python pipelines/feature-end-to-end.py --demo --output /tmp/feature-demo
python pipelines/weekly-cadence.py --demo --output /tmp/weekly-demo
python pipelines/customer-discovery.py --demo --output /tmp/discovery-demo
python pipelines/post-mortem-flow.py --demo --output /tmp/postmortem-demo
python pipelines/launch-coordination.py --demo --output /tmp/launch-demo
# Or use your own JSON input
python pipelines/weekly-cadence.py --input jira-export.json --source jira --output ./this-week
python pipelines/customer-discovery.py --input interviews.json --output ./q2-discovery
Pipeline structure
Every pipeline follows the same pattern:
- Parse CLI args (
--demo,--input,--output,--format). - Load context (either built-in demo data or the input JSON).
- Derive lightweight intermediate artifacts (clustering, summaries) from the input data using stdlib only -- no LLM calls.
- For each stage, invoke the underlying PM tool via
subprocess.runwith--demo --format markdown --output <stage-artifact>. If the tool is not present, write a stub artifact noting which tool was missing. - Emit a single summary (markdown or JSON) listing each stage, its artifact, run mode (ran / stub / skipped), and exit code.
- Cross-reference the PM skills the pipeline chains.
Integration points
- Atlassian MCP: pipelines do not call MCP directly; they emit markdown / JSON artifacts that the user (or a separate MCP-aware agent) can post into Jira / Confluence.
- Linear: same model -- pipelines produce Linear-compatible markdown (status updates, release notes) but do not call the GraphQL API.
- Productboard: discovery pipeline's
opportunities.jsonis a feed candidate for the Productboard insights inbox. - Notion: every artifact can be pushed to a Notion DB via
notion-pm/references/notion-api-patterns.md.
Pipeline -> Skills mapping
feature-end-to-end.py
Chains seven PM skills in sequence:
discovery/identify-assumptionsdiscovery/brainstorm-experimentsdiscovery/pre-mortemexecution/create-prdexecution/brainstorm-okrsexecution/prioritization-frameworksexecution/release-notes
weekly-cadence.py
Three PM skills (plus built-in Jira / Linear adapters):
execution/status-update-generatorexecution/cycle-time-analyzer(flow_metrics)execution/dependency-map(dependency_graph)
customer-discovery.py
Four PM skills:
discovery/interview-synthesisdiscovery/identify-assumptionsdiscovery/brainstorm-experimentsexecution/north-star-metric
post-mortem-flow.py
Three PM skills:
execution/post-mortemdiscovery/pre-mortemexecution/dependency-map
launch-coordination.py
Four PM skills:
execution/beta-programexecution/feature-flag-strategyexecution/launch-playbookexecution/release-notes
Design notes
- Stdlib only: each pipeline is one file, no extra dependencies.
- Subprocess orchestration: pipelines call PM tools as separate processes. This isolates failures and keeps the pipeline robust if a tool aborts.
- Stub fallback: when a tool is absent, the pipeline writes a stub
artifact and continues. The summary shows
mode: stubso users see what needs to be installed. - Timeouts: each stage has a 60-second subprocess timeout to keep the pipeline responsive.
- No external network calls: pipelines do not hit Jira, Linear, Productboard, Notion, or Confluence APIs. They emit artifacts that the user pushes (manually or via a separate MCP agent).
See each pipeline's docstring for stage details and the corresponding
PM skill's references/red-flags.md for common failure modes.