Product Team — Domain Orchestrator & Discovery Loop
This orchestrator does two jobs. Routing: fork context, classify a product inquiry
with scripts/product_goal_router.py across all 16 product-team lanes (12 bundled + 4
standalone plugins), run exactly one, return a digest. Looping: run product work as
bounded agentic loops with machine-checkable gates — the continuous-discovery loop
(weekly cadence scored by discovery_cadence_tracker.py, tree structure enforced by
ost_linter.py) and goal-scale runs through the repo-wide agent-harness.
When to invoke
| Symptom |
Sub-skill |
| "Prioritize features / RICE / PRD" |
product-manager-toolkit |
| "OKRs, strategy cascade" |
product-strategist |
| "Personas, usability, research synthesis" |
ux-researcher-designer |
| "Design tokens, WCAG contrast" |
ui-design-system |
| "Competitor matrix, teardown" |
competitive-teardown |
| "Retention, cohorts, funnels, KPIs" |
product-analytics |
| "A/B test, sample size, hypothesis" |
experiment-designer |
| "Discovery, assumptions, opportunity trees" |
product-discovery |
| "Roadmap comms, release notes, changelog" |
roadmap-communicator |
| "Spec → runnable repo" |
spec-to-repo |
| "Landing page (Next.js/Tailwind)" |
landing-page-generator |
| "SaaS boilerplate" |
saas-scaffolder |
| "User stories, sprint capacity" |
agile-product-owner (standalone) |
| "Apple HIG audit" |
apple-hig-expert (standalone) |
| "PRD from an existing codebase" |
code-to-prd (standalone) |
| "Summarize papers/articles" |
research-summarizer (standalone) |
Routing logic (deterministic)
python3 scripts/product_goal_router.py --text "<the goal>" --output json
Exit 0 → route_to names the skill (with skill_path, including the standalone
plugins): load its SKILL.md and follow its workflow. Exit 2 → ask ONE clarifying question
naming the listed candidates, with a recommended answer. Exit 3 → no signal: ask the user
to restate the goal with the deliverable named. Never guess silently; never silently
chain — digest first, confirm, then chain.
The discovery loop (the domain's recurring agentic loop)
Modern discovery is a weekly habit, not a project phase (Torres). Run it as a bounded
loop with two machine gates:
- Observe — maintain
discovery_log.json (interviews, assumption tests; shape in
assets/sample_discovery_log.json) and score the cadence:python3 scripts/discovery_cadence_tracker.py --input discovery_log.json
Refuses on < 2 interviews (exit 5) — there is no cadence to measure yet. Output:
health 0–100, verdict HEALTHY/AT-RISK/DORMANT, named gaps, and next_loop_action.
- Choose — the tracker's
next_loop_action IS the choice: book the touchpoint,
re-anchor the guide on the outcome, or test the top untested assumption (route to
product-discovery's assumption_mapper for prioritization).
- Act — run the interview / assumption test with the routed sub-skill's tools.
- Verify — keep the tree structurally sound before it may drive a roadmap:
python3 scripts/ost_linter.py --input ost.json # exit 2 = NEEDS-REWORK, fix before citing the tree
Rules: one measurable outcome root (O1), opportunities are needs not features (O2),
targeted opportunities compare ≥ 2 solutions (O3), every solution has an assumption
test (O4), no orphan solutions (O5 — the feature-factory tell).
- Record / Repeat-or-stop — update the log, keep the weekly streak alive. Stop
states: HEALTHY + validated assumption → graduate to
experiment-designer (build the
A/B gate) or product-manager-toolkit (PRD); DORMANT for 4+ weeks → escalate to the
product lead by name — do not quietly let discovery die.
For build-scale goals ("turn this validated spec into a repo and verify it"), compile
through the repo-wide harness instead:
python3 engineering/agent-harness/skills/agent-harness/scripts/goal_compiler.py \
--goal "<goal>" --manifest engineering/agent-harness/skills/agent-harness/assets/harnesses/product-team.json \
--out .agent-harness/plan.json
The domain's three strongest close-out gates plug in as task verifications:
../spec-to-repo/scripts/validate_project.py (exit 0), code-to-prd's golden
expected_outputs/, and research-summarizer's citation-count check.
Hard rules
- Evidence before conviction: no roadmap item cites the OST unless
ost_linter.py
exits 0; no insight is asserted from a single participant (anecdote, not insight).
- Outcome-first: every loop hangs from one measurable outcome — the linter's O1 rule
is the intake gate.
- Experiments are gated by math: sample size from
../experiment-designer/scripts/sample_size_calculator.py, never gut feel; report the
MDE with the verdict.
- Prioritization shows its framework: RICE for steady-state, WSJF/cost-of-delay when
time sensitivity dominates, opportunity scoring for underserved needs — name which and
why (see references/product_operating_model.md).
- AI features ship with evals: a golden set + rubric is the PRD's quality contract
for probabilistic features
(references/ai_product_evals.md).
- Never modify a gate you are judged by; exhausted budgets escalate to a named human,
never report as success.
Forcing-question library (grill-with-docs pattern)
One per turn, recommended answer, canon citation. Never run a sub-skill or start a loop
until the lane-defining decision is locked:
- DISCOVERY lane: "What is the single outcome this discovery serves, stated with a
number? Recommended: write it as the OST root first — opportunities without an outcome
are a feature factory. Canon: Torres, Continuous Discovery Habits; opportunity
solution trees (producttalk.org)."
- PRIORITIZE lane: "Does time sensitivity change this ranking — would delaying any
item a quarter erode its value? Recommended: if yes, run WSJF/cost-of-delay alongside
RICE and compare ranks; flag items whose rank flips on a one-step estimate change.
Canon: Reinertsen, Principles of Product Development Flow; SAFe WSJF false-precision
critique."
- EXPERIMENT lane: "What baseline rate and MDE justify this test's runtime?
Recommended: compute n first; if you can't reach it in 4 weeks, test a bigger lever.
Canon: statistical power analysis (experiment-designer)."
- ANALYTICS lane: "Is your North Star a leading indicator of value exchange, or
revenue/vanity? Recommended: leading value metric with an input tree. Canon: Amplitude,
The North Star Playbook."
- STRATEGY lane: "Are these OKRs outcomes or shipping lists? Recommended: outcomes —
output OKRs are the #1 operating-model failure. Canon: Cagan, Transformed (SVPG,
2024)."
- BUILD lanes (spec-to-repo / saas-scaffolder): "Which validated assumption says this
should be built at all? Recommended: link the OST test that survived; building is the
most expensive way to test an idea. Canon: Torres; Bland, Testing Business Ideas."
Assumptions
- The user owns (or advises the owner of) the product decision.
- Discovery data lives in the workspace as JSON logs — the loop is file-backed and
resumable; every tool ships
--sample so the shape is visible first.
- The four standalone plugins are installed alongside the bundle (the router still
routes to them by path if not).
Non-goals
- Not the delivery loop — sprint/flow/Jira work routes to
project-management.
- Not the generic loop engine — that is
engineering/agent-harness; this orchestrator is
the product-domain adapter (router + discovery gates).
- Not campaign marketing —
marketing/landing builds from-scratch marketing pages;
landing-page-generator here scaffolds product Next.js/TSX pages.
Output artifacts
| Mode |
Artifact |
| Route |
Sub-skill's own artifact + ≤ 200-word digest with one canon-cited challenge |
| Discovery loop |
discovery_log.json + cadence report + linted ost.json |
| Harness run |
.agent-harness/plan.json + state.json + close handoff |
Anti-patterns (do not)
- ❌ Run all 16 lanes "to be thorough" — route to one, digest, chain on confirmation
- ❌ Cite an OST that fails the linter, or promote a single-participant anecdote to insight
- ❌ Ship an AI feature whose PRD has no eval (golden set + rubric)
- ❌ Let the discovery streak die silently — DORMANT escalates by name
- ❌ Treat RICE as the only prioritization lens when deadlines dominate
References
- references/continuous_discovery_canon.md —
Torres, OST, assumption testing, JTBD switch interviews, story mapping
- references/product_operating_model.md — Cagan
Transformed, North Star framework, PLG benchmarks, WSJF/ODI vs RICE
- references/ai_product_evals.md — evals-as-PRD, model
cards, evaluator-optimizer loops
- Loop engine:
engineering/agent-harness · Loop vocabulary: loop-library
1---2name: "product-skills"3description: "Use when coordinating product work across the 12 bundled product sub-skills (RICE, OKRs, UX research, design tokens, competitive teardown, analytics, experiments, discovery, roadmaps, spec-to-repo, landing pages, SaaS scaffolding) or the 4 standalone product-team plugins (user stories, Apple HIG, code-to-PRD, research summarizer). Triggers on 'help me prioritize', 'plan a product experiment', 'we ship features nobody uses', 'run the discovery loop', 'is our OST sound'. Forks context to route to one sub-skill via a deterministic signal router and returns a digest; can also drive a continuous-discovery loop (Torres cadence tracker + OST linter as machine gates) or a full goal→plan→execute→verify→close run through the repo-wide agent-harness. Distinct from project-management (how to deliver vs what to build), marketing/landing (from-scratch pages), and engineering/agent-harness (the generic loop engine this orchestrator plugs into)."4context: fork5license: MIT6metadata:7 source: https://skillmd.com/skills/slipcast-dev/product-skills8 version: 2.11.19 author: Alireza Rezvani10 tags: [product, product-management, orchestrator, discovery, ux, analytics, agent-harness]11 compatible_tools: [claude-code, codex-cli, cursor, antigravity, opencode, gemini-cli]12disable-model-invocation: true # skill-optimizer13---1415# Product Team — Domain Orchestrator & Discovery Loop1617This orchestrator does two jobs. **Routing:** fork context, classify a product inquiry18with `scripts/product_goal_router.py` across all 16 product-team lanes (12 bundled + 419standalone plugins), run exactly one, return a digest. **Looping:** run product work as20bounded agentic loops with machine-checkable gates — the continuous-discovery loop21(weekly cadence scored by `discovery_cadence_tracker.py`, tree structure enforced by22`ost_linter.py`) and goal-scale runs through the repo-wide agent-harness.2324## When to invoke2526| Symptom | Sub-skill |27|---|---|28| "Prioritize features / RICE / PRD" | `product-manager-toolkit` |29| "OKRs, strategy cascade" | `product-strategist` |30| "Personas, usability, research synthesis" | `ux-researcher-designer` |31| "Design tokens, WCAG contrast" | `ui-design-system` |32| "Competitor matrix, teardown" | `competitive-teardown` |33| "Retention, cohorts, funnels, KPIs" | `product-analytics` |34| "A/B test, sample size, hypothesis" | `experiment-designer` |35| "Discovery, assumptions, opportunity trees" | `product-discovery` |36| "Roadmap comms, release notes, changelog" | `roadmap-communicator` |37| "Spec → runnable repo" | `spec-to-repo` |38| "Landing page (Next.js/Tailwind)" | `landing-page-generator` |39| "SaaS boilerplate" | `saas-scaffolder` |40| "User stories, sprint capacity" | `agile-product-owner` (standalone) |41| "Apple HIG audit" | `apple-hig-expert` (standalone) |42| "PRD from an existing codebase" | `code-to-prd` (standalone) |43| "Summarize papers/articles" | `research-summarizer` (standalone) |4445## Routing logic (deterministic)4647```bash48python3 scripts/product_goal_router.py --text "<the goal>" --output json49```5051Exit 0 → `route_to` names the skill (with `skill_path`, including the standalone52plugins): load its SKILL.md and follow its workflow. Exit 2 → ask ONE clarifying question53naming the listed candidates, with a recommended answer. Exit 3 → no signal: ask the user54to restate the goal with the deliverable named. Never guess silently; never silently55chain — digest first, confirm, then chain.5657## The discovery loop (the domain's recurring agentic loop)5859Modern discovery is a weekly habit, not a project phase (Torres). Run it as a bounded60loop with two machine gates:61621. **Observe** — maintain `discovery_log.json` (interviews, assumption tests; shape in63 `assets/sample_discovery_log.json`) and score the cadence:64 ```bash65 python3 scripts/discovery_cadence_tracker.py --input discovery_log.json66 ```67 Refuses on < 2 interviews (exit 5) — there is no cadence to measure yet. Output:68 health 0–100, verdict HEALTHY/AT-RISK/DORMANT, named gaps, and `next_loop_action`.692. **Choose** — the tracker's `next_loop_action` IS the choice: book the touchpoint,70 re-anchor the guide on the outcome, or test the top untested assumption (route to71 `product-discovery`'s assumption_mapper for prioritization).723. **Act** — run the interview / assumption test with the routed sub-skill's tools.734. **Verify** — keep the tree structurally sound before it may drive a roadmap:74 ```bash75 python3 scripts/ost_linter.py --input ost.json # exit 2 = NEEDS-REWORK, fix before citing the tree76 ```77 Rules: one measurable outcome root (O1), opportunities are needs not features (O2),78 targeted opportunities compare ≥ 2 solutions (O3), every solution has an assumption79 test (O4), no orphan solutions (O5 — the feature-factory tell).805. **Record / Repeat-or-stop** — update the log, keep the weekly streak alive. Stop81 states: HEALTHY + validated assumption → graduate to `experiment-designer` (build the82 A/B gate) or `product-manager-toolkit` (PRD); DORMANT for 4+ weeks → escalate to the83 product lead by name — do not quietly let discovery die.8485For build-scale goals ("turn this validated spec into a repo and verify it"), compile86through the repo-wide harness instead:8788```bash89python3 engineering/agent-harness/skills/agent-harness/scripts/goal_compiler.py \90 --goal "<goal>" --manifest engineering/agent-harness/skills/agent-harness/assets/harnesses/product-team.json \91 --out .agent-harness/plan.json92```9394The domain's three strongest close-out gates plug in as task verifications:95`../spec-to-repo/scripts/validate_project.py` (exit 0), `code-to-prd`'s golden96`expected_outputs/`, and `research-summarizer`'s citation-count check.9798## Hard rules991001. **Evidence before conviction**: no roadmap item cites the OST unless `ost_linter.py`101 exits 0; no insight is asserted from a single participant (anecdote, not insight).1022. **Outcome-first**: every loop hangs from one measurable outcome — the linter's O1 rule103 is the intake gate.1043. **Experiments are gated by math**: sample size from105 `../experiment-designer/scripts/sample_size_calculator.py`, never gut feel; report the106 MDE with the verdict.1074. **Prioritization shows its framework**: RICE for steady-state, WSJF/cost-of-delay when108 time sensitivity dominates, opportunity scoring for underserved needs — name which and109 why (see [references/product_operating_model.md](references/product_operating_model.md)).1105. **AI features ship with evals**: a golden set + rubric is the PRD's quality contract111 for probabilistic features112 ([references/ai_product_evals.md](references/ai_product_evals.md)).1136. **Never modify a gate you are judged by**; exhausted budgets escalate to a named human,114 never report as success.115116## Forcing-question library (grill-with-docs pattern)117118One per turn, recommended answer, canon citation. Never run a sub-skill or start a loop119until the lane-defining decision is locked:120121- **DISCOVERY lane**: "What is the single outcome this discovery serves, stated with a122 number? Recommended: write it as the OST root first — opportunities without an outcome123 are a feature factory. Canon: Torres, *Continuous Discovery Habits*; opportunity124 solution trees (producttalk.org)."125- **PRIORITIZE lane**: "Does time sensitivity change this ranking — would delaying any126 item a quarter erode its value? Recommended: if yes, run WSJF/cost-of-delay alongside127 RICE and compare ranks; flag items whose rank flips on a one-step estimate change.128 Canon: Reinertsen, *Principles of Product Development Flow*; SAFe WSJF false-precision129 critique."130- **EXPERIMENT lane**: "What baseline rate and MDE justify this test's runtime?131 Recommended: compute n first; if you can't reach it in 4 weeks, test a bigger lever.132 Canon: statistical power analysis (experiment-designer)."133- **ANALYTICS lane**: "Is your North Star a leading indicator of value exchange, or134 revenue/vanity? Recommended: leading value metric with an input tree. Canon: Amplitude,135 *The North Star Playbook*."136- **STRATEGY lane**: "Are these OKRs outcomes or shipping lists? Recommended: outcomes —137 output OKRs are the #1 operating-model failure. Canon: Cagan, *Transformed* (SVPG,138 2024)."139- **BUILD lanes (spec-to-repo / saas-scaffolder)**: "Which validated assumption says this140 should be built at all? Recommended: link the OST test that survived; building is the141 most expensive way to test an idea. Canon: Torres; Bland, *Testing Business Ideas*."142143## Assumptions1441451. The user owns (or advises the owner of) the product decision.1462. Discovery data lives in the workspace as JSON logs — the loop is file-backed and147 resumable; every tool ships `--sample` so the shape is visible first.1483. The four standalone plugins are installed alongside the bundle (the router still149 routes to them by path if not).150151## Non-goals152153- Not the delivery loop — sprint/flow/Jira work routes to `project-management`.154- Not the generic loop engine — that is `engineering/agent-harness`; this orchestrator is155 the product-domain adapter (router + discovery gates).156- Not campaign marketing — `marketing/landing` builds from-scratch marketing pages;157 `landing-page-generator` here scaffolds product Next.js/TSX pages.158159## Output artifacts160161| Mode | Artifact |162|---|---|163| Route | Sub-skill's own artifact + ≤ 200-word digest with one canon-cited challenge |164| Discovery loop | `discovery_log.json` + cadence report + linted `ost.json` |165| Harness run | `.agent-harness/plan.json` + `state.json` + close handoff |166167## Anti-patterns (do not)168169- ❌ Run all 16 lanes "to be thorough" — route to one, digest, chain on confirmation170- ❌ Cite an OST that fails the linter, or promote a single-participant anecdote to insight171- ❌ Ship an AI feature whose PRD has no eval (golden set + rubric)172- ❌ Let the discovery streak die silently — DORMANT escalates by name173- ❌ Treat RICE as the only prioritization lens when deadlines dominate174175## References176177- [references/continuous_discovery_canon.md](references/continuous_discovery_canon.md) —178 Torres, OST, assumption testing, JTBD switch interviews, story mapping179- [references/product_operating_model.md](references/product_operating_model.md) — Cagan180 *Transformed*, North Star framework, PLG benchmarks, WSJF/ODI vs RICE181- [references/ai_product_evals.md](references/ai_product_evals.md) — evals-as-PRD, model182 cards, evaluator-optimizer loops183- Loop engine: `engineering/agent-harness` · Loop vocabulary: `loop-library`