Product strategy worker

Dual-wiki: operator · system. Bet clustering is FW-WC-006.

Updated

Definition

Workcell id: product_strategy_worker

A governed product-management loop: ingest dual-wiki + roadmap → differentiation matrix → strategy bets and alternatives → Element dialog (paper or live) → decision manifest → advisory roadmap delta. Proposal-only — no auto-commit of canonical roadmap files.

Orchestration contract: lmeta/flows/product-strategy-cycle.lmeta + scripts/fm-product-strategy/flow_hooks.py.

Maturity: defined · Runtime: implemented (local cycle + workcell) · Output gate: needs_approval; human promotion required.

Runtime homes

Mode Host Entry
Composer (reference) forge-market Runtime prompts R00–R05 under docs/prompts/fm-product-strategy-pdca/
Governed local forge-workcells forge-workcells run --workcell product_strategy_worker --request …
Direct CLI forge-market ./scripts/fm-product-strategy/run-strategy-cycle.sh <campaign>
Element (optional) Matrix room #forge-market-pm Interactive bet approval before promotion

Envelopes

  • Cycle artifact schema: forge.pm_strategy_cycle.v1 (schemas/pm_strategy_cycle.v1.schema.json)
  • Request: forge.workcell_request.v1 with workcell: product_strategy_worker, mode: proposal
  • Result: forge.workcell_result.v1 with status: needs_approval and artifact paths

Domain schemas

Schema Purpose
forge.pm_capability_ledger.v1 FM-* rows parsed from feature-index + dual-wiki
forge.pm_differentiation_matrix.v1 UNIQUE / BEST_IN_CLASS / PARITY / INTENTIONALLY_BEHIND / DEFER axes
forge.pm_roadmap_delta.v1 Proposed priority/status/horizon changes
forge.pm_strategy_decision.v1 Element or human approval record

Flow inputs (launch_pack)

Field Required Description
product_id yes e.g. forge-market
repo_root yes Absolute path to product repo
campaign_id yes Stable campaign folder name
wiki_sources.feature_index yes Relative path to feature-index.md
wiki_sources.roadmap yes Relative path to enterprise-priority-roadmap.md
wiki_sources.competitive_context no Static competitive landscape path
matrix_room_id no Element room (PW-2); default #forge-market-pm
mode no paper (default) or interactive
focus_areas no Axis or bet focus strings

Sample request: forge-market/docs/prompts/fm-product-strategy-pdca/samples/workcell_request.sample.json

Loop (six steps)

  1. Ingest — capability ledger from feature-index.md rows, roadmap wave hints, dual-wiki requirements metadata, and paired page frontmatter (via index links); tag wiki_layer by FM domain prefix (WIKI/ASCII/GRAPH → product wiki).
  2. Position — differentiation matrix vs static competitive landscape; never invent implemented status.
  3. Synthesize — 1–3 bets + 2–4 alternatives; each change includes roadmap Definition of Ready fields plus optional product_spark_candidate (PoC/MVP/phased handoff hint — not a Forge Spark).
  4. Element dialog — campaign thread + per-bet threads; commands: approve 1,2, approve bet-a, bank alternative-3, deep-dive FM-GRAPH-007, compare: A vs B, rework, skip.
  5. Gate — forge.pm_strategy_decision.v1; timeout = no commit (never auto-apply deltas).
  6. Emit — strategy-brief.md, alternatives.md, roadmap-delta.json; status needs_approval.

Trust boundary

Workcell output is never canonical. Roadmap deltas, feature-index status flips, and enterprise PDCA phase picks require a human decision manifest. LLM steps classify and draft only — capability truth comes from feature-index.md and dual-wiki pairs.

No auto-commit: timeout or missing approval leaves roadmap files unchanged (timeout_no_commit: true).

Element protocol summary

  • Room: #forge-market-pm (separate from #studio-ux).
  • Thread root: campaign start message.
  • Approval grammar: aligned with Studio UX (approve 1,3, approve all, skip) plus bet aliases (approve bet-a).
  • Timeout: default 900s; on timeout → no roadmap writes.

Full grammar: forge-market fixtures/element-commands.md

Workcell Role in loop
doc_hydration_worker Promotion gate pattern (needs_approval + decision manifest)
studio_ux_pdca_worker Element approval grammar reference
pm_bet_cluster_llm_worker Bet-cluster JSON (forge.pm_bet_cluster_analysis.v1) via bet_cluster_analysis.py
Enterprise PDCA (fm-studio-enterprise-pdca) Executes approved implementation waves
@versona-product-management Optional §5 review after strategy brief

PW-2 runner (implemented)

cd forge-market
./scripts/fm-product-strategy/run-strategy-cycle.sh fm-pm-20260818-positioning

forge-workcells run --workcell product_strategy_worker \
  --request docs/prompts/fm-product-strategy-pdca/samples/workcell_request.sample.json \
  --out-dir ../workbench/product-strategy/forge-market/fm-pm-workcell-sample

Live Matrix notify when MATRIX_ACCESS_TOKEN is set; paper notify is the default shippable path.

PW-3 — Element + promotion

Script Role
element_approval.py Parse #forge-market-pm replies (approve bet-a, bank alt-*, skip)
notify_element.py Paper notify JSON + optional live Matrix post
promote-roadmap-delta.sh R06 dry-run / --apply priority shifts
run-runtime-phase.sh Print or run R00–R08

PW-5 — Matrix poll + bet cluster

Script Role
matrix_poll_approval.py Live #forge-market-pm thread poll when FM_PM_STRATEGY_MATRIX_POLL=1
bet_cluster_analysis.py Deterministic or LLM bet-cluster analysis (bet-cluster-v1 pack)

Docs

  • Consumer handbook: forge-market docs/handbook/operator/product-strategy.md
  • PDCA pack: forge-market docs/prompts/fm-product-strategy-pdca/00-master-sequence.md
  • Contracts: Workcell contracts