Handbook
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.v1withworkcell: product_strategy_worker,mode: proposal - Result:
forge.workcell_result.v1withstatus: needs_approvaland 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)
- Ingest — capability ledger from
feature-index.mdrows, roadmap wave hints, dual-wiki requirements metadata, and paired page frontmatter (via index links); tagwiki_layerby FM domain prefix (WIKI/ASCII/GRAPH → product wiki). - Position — differentiation matrix vs static competitive landscape; never invent
implementedstatus. - 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). - 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. - Gate —
forge.pm_strategy_decision.v1; timeout = no commit (never auto-apply deltas). - Emit —
strategy-brief.md,alternatives.md,roadmap-delta.json; statusneeds_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
Related workcells
| 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