Files
Brian Borghei a8063e1c83 feat(pm): tier 2 — red-flag libraries (54) + runnable pipelines (5)
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.
2026-05-22 12:02:51 +02:00
..

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:

  1. Parse CLI args (--demo, --input, --output, --format).
  2. Load context (either built-in demo data or the input JSON).
  3. Derive lightweight intermediate artifacts (clustering, summaries) from the input data using stdlib only -- no LLM calls.
  4. For each stage, invoke the underlying PM tool via subprocess.run with --demo --format markdown --output <stage-artifact>. If the tool is not present, write a stub artifact noting which tool was missing.
  5. Emit a single summary (markdown or JSON) listing each stage, its artifact, run mode (ran / stub / skipped), and exit code.
  6. 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.json is 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-assumptions
  • discovery/brainstorm-experiments
  • discovery/pre-mortem
  • execution/create-prd
  • execution/brainstorm-okrs
  • execution/prioritization-frameworks
  • execution/release-notes

weekly-cadence.py

Three PM skills (plus built-in Jira / Linear adapters):

  • execution/status-update-generator
  • execution/cycle-time-analyzer (flow_metrics)
  • execution/dependency-map (dependency_graph)

customer-discovery.py

Four PM skills:

  • discovery/interview-synthesis
  • discovery/identify-assumptions
  • discovery/brainstorm-experiments
  • execution/north-star-metric

post-mortem-flow.py

Three PM skills:

  • execution/post-mortem
  • discovery/pre-mortem
  • execution/dependency-map

launch-coordination.py

Four PM skills:

  • execution/beta-program
  • execution/feature-flag-strategy
  • execution/launch-playbook
  • execution/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: stub so 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.