convoke-agents 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +920 -0
- package/INSTALLATION.md +230 -0
- package/LICENSE +21 -0
- package/README.md +330 -0
- package/UPDATE-GUIDE.md +220 -0
- package/_bmad/bme/_vortex/README.md +150 -0
- package/_bmad/bme/_vortex/agents/contextualization-expert.md +100 -0
- package/_bmad/bme/_vortex/agents/discovery-empathy-expert.md +117 -0
- package/_bmad/bme/_vortex/agents/hypothesis-engineer.md +117 -0
- package/_bmad/bme/_vortex/agents/lean-experiments-specialist.md +118 -0
- package/_bmad/bme/_vortex/agents/learning-decision-expert.md +117 -0
- package/_bmad/bme/_vortex/agents/production-intelligence-specialist.md +117 -0
- package/_bmad/bme/_vortex/agents/research-convergence-specialist.md +117 -0
- package/_bmad/bme/_vortex/compass-routing-reference.md +312 -0
- package/_bmad/bme/_vortex/config.yaml +46 -0
- package/_bmad/bme/_vortex/contracts/hc1-empathy-artifacts.md +152 -0
- package/_bmad/bme/_vortex/contracts/hc2-problem-definition.md +125 -0
- package/_bmad/bme/_vortex/contracts/hc3-hypothesis-contract.md +112 -0
- package/_bmad/bme/_vortex/contracts/hc4-experiment-context.md +140 -0
- package/_bmad/bme/_vortex/contracts/hc5-signal-report.md +130 -0
- package/_bmad/bme/_vortex/examples/hc2-example-problem-definition.md +85 -0
- package/_bmad/bme/_vortex/examples/hc3-example-hypothesis-contract.md +103 -0
- package/_bmad/bme/_vortex/examples/hc5-example-signal-report.md +76 -0
- package/_bmad/bme/_vortex/guides/EMMA-USER-GUIDE.md +232 -0
- package/_bmad/bme/_vortex/guides/ISLA-USER-GUIDE.md +208 -0
- package/_bmad/bme/_vortex/guides/LIAM-USER-GUIDE.md +255 -0
- package/_bmad/bme/_vortex/guides/MAX-USER-GUIDE.md +213 -0
- package/_bmad/bme/_vortex/guides/MILA-USER-GUIDE.md +235 -0
- package/_bmad/bme/_vortex/guides/NOAH-USER-GUIDE.md +258 -0
- package/_bmad/bme/_vortex/guides/WADE-USER-GUIDE.md +245 -0
- package/_bmad/bme/_vortex/workflows/_deprecated/empathy-map/empathy-map.template.md +143 -0
- package/_bmad/bme/_vortex/workflows/_deprecated/empathy-map/steps/step-01-define-user.md +60 -0
- package/_bmad/bme/_vortex/workflows/_deprecated/empathy-map/steps/step-02-says-thinks.md +67 -0
- package/_bmad/bme/_vortex/workflows/_deprecated/empathy-map/steps/step-03-does-feels.md +79 -0
- package/_bmad/bme/_vortex/workflows/_deprecated/empathy-map/steps/step-04-pain-points.md +87 -0
- package/_bmad/bme/_vortex/workflows/_deprecated/empathy-map/steps/step-05-gains.md +103 -0
- package/_bmad/bme/_vortex/workflows/_deprecated/empathy-map/steps/step-06-synthesize.md +104 -0
- package/_bmad/bme/_vortex/workflows/_deprecated/empathy-map/validate.md +117 -0
- package/_bmad/bme/_vortex/workflows/_deprecated/empathy-map/workflow.md +44 -0
- package/_bmad/bme/_vortex/workflows/_deprecated/wireframe/steps/step-01-define-requirements.md +85 -0
- package/_bmad/bme/_vortex/workflows/_deprecated/wireframe/steps/step-02-user-flows.md +59 -0
- package/_bmad/bme/_vortex/workflows/_deprecated/wireframe/steps/step-03-information-architecture.md +68 -0
- package/_bmad/bme/_vortex/workflows/_deprecated/wireframe/steps/step-04-wireframe-sketch.md +97 -0
- package/_bmad/bme/_vortex/workflows/_deprecated/wireframe/steps/step-05-components.md +128 -0
- package/_bmad/bme/_vortex/workflows/_deprecated/wireframe/steps/step-06-synthesize.md +83 -0
- package/_bmad/bme/_vortex/workflows/_deprecated/wireframe/wireframe.template.md +287 -0
- package/_bmad/bme/_vortex/workflows/_deprecated/wireframe/workflow.md +44 -0
- package/_bmad/bme/_vortex/workflows/assumption-mapping/steps/step-01-setup.md +66 -0
- package/_bmad/bme/_vortex/workflows/assumption-mapping/steps/step-02-context.md +93 -0
- package/_bmad/bme/_vortex/workflows/assumption-mapping/steps/step-03-risk-mapping.md +103 -0
- package/_bmad/bme/_vortex/workflows/assumption-mapping/steps/step-04-synthesize.md +101 -0
- package/_bmad/bme/_vortex/workflows/assumption-mapping/workflow.md +49 -0
- package/_bmad/bme/_vortex/workflows/behavior-analysis/steps/step-01-setup.md +81 -0
- package/_bmad/bme/_vortex/workflows/behavior-analysis/steps/step-02-context.md +67 -0
- package/_bmad/bme/_vortex/workflows/behavior-analysis/steps/step-03-classification.md +98 -0
- package/_bmad/bme/_vortex/workflows/behavior-analysis/steps/step-04-evidence.md +100 -0
- package/_bmad/bme/_vortex/workflows/behavior-analysis/steps/step-05-synthesize.md +174 -0
- package/_bmad/bme/_vortex/workflows/behavior-analysis/workflow.md +52 -0
- package/_bmad/bme/_vortex/workflows/contextualize-scope/contextualize-scope.template.md +67 -0
- package/_bmad/bme/_vortex/workflows/contextualize-scope/steps/step-01-list-opportunities.md +47 -0
- package/_bmad/bme/_vortex/workflows/contextualize-scope/steps/step-02-define-criteria.md +36 -0
- package/_bmad/bme/_vortex/workflows/contextualize-scope/steps/step-03-evaluate-opportunities.md +30 -0
- package/_bmad/bme/_vortex/workflows/contextualize-scope/steps/step-04-define-boundaries.md +32 -0
- package/_bmad/bme/_vortex/workflows/contextualize-scope/steps/step-05-validate-fit.md +28 -0
- package/_bmad/bme/_vortex/workflows/contextualize-scope/steps/step-06-synthesize.md +36 -0
- package/_bmad/bme/_vortex/workflows/contextualize-scope/validate.md +30 -0
- package/_bmad/bme/_vortex/workflows/contextualize-scope/workflow.md +59 -0
- package/_bmad/bme/_vortex/workflows/empathy-map/empathy-map.template.md +143 -0
- package/_bmad/bme/_vortex/workflows/empathy-map/steps/step-01-define-user.md +60 -0
- package/_bmad/bme/_vortex/workflows/empathy-map/steps/step-02-says-thinks.md +67 -0
- package/_bmad/bme/_vortex/workflows/empathy-map/steps/step-03-does-feels.md +79 -0
- package/_bmad/bme/_vortex/workflows/empathy-map/steps/step-04-pain-points.md +87 -0
- package/_bmad/bme/_vortex/workflows/empathy-map/steps/step-05-gains.md +103 -0
- package/_bmad/bme/_vortex/workflows/empathy-map/steps/step-06-synthesize.md +107 -0
- package/_bmad/bme/_vortex/workflows/empathy-map/validate.md +117 -0
- package/_bmad/bme/_vortex/workflows/empathy-map/workflow.md +45 -0
- package/_bmad/bme/_vortex/workflows/experiment-design/steps/step-01-setup.md +66 -0
- package/_bmad/bme/_vortex/workflows/experiment-design/steps/step-02-context.md +77 -0
- package/_bmad/bme/_vortex/workflows/experiment-design/steps/step-03-design.md +114 -0
- package/_bmad/bme/_vortex/workflows/experiment-design/steps/step-04-synthesize.md +128 -0
- package/_bmad/bme/_vortex/workflows/experiment-design/workflow.md +51 -0
- package/_bmad/bme/_vortex/workflows/hypothesis-engineering/steps/step-01-setup.md +66 -0
- package/_bmad/bme/_vortex/workflows/hypothesis-engineering/steps/step-02-context.md +80 -0
- package/_bmad/bme/_vortex/workflows/hypothesis-engineering/steps/step-03-brainwriting.md +79 -0
- package/_bmad/bme/_vortex/workflows/hypothesis-engineering/steps/step-04-assumption-mapping.md +102 -0
- package/_bmad/bme/_vortex/workflows/hypothesis-engineering/steps/step-05-synthesize.md +130 -0
- package/_bmad/bme/_vortex/workflows/hypothesis-engineering/workflow.md +52 -0
- package/_bmad/bme/_vortex/workflows/lean-experiment/lean-experiment.template.md +29 -0
- package/_bmad/bme/_vortex/workflows/lean-experiment/steps/step-01-hypothesis.md +58 -0
- package/_bmad/bme/_vortex/workflows/lean-experiment/steps/step-02-design.md +68 -0
- package/_bmad/bme/_vortex/workflows/lean-experiment/steps/step-03-metrics.md +73 -0
- package/_bmad/bme/_vortex/workflows/lean-experiment/steps/step-04-run.md +75 -0
- package/_bmad/bme/_vortex/workflows/lean-experiment/steps/step-05-analyze.md +84 -0
- package/_bmad/bme/_vortex/workflows/lean-experiment/steps/step-06-decide.md +111 -0
- package/_bmad/bme/_vortex/workflows/lean-experiment/validate.md +30 -0
- package/_bmad/bme/_vortex/workflows/lean-experiment/workflow.md +26 -0
- package/_bmad/bme/_vortex/workflows/lean-persona/lean-persona.template.md +163 -0
- package/_bmad/bme/_vortex/workflows/lean-persona/steps/step-01-define-job.md +72 -0
- package/_bmad/bme/_vortex/workflows/lean-persona/steps/step-02-current-solution.md +83 -0
- package/_bmad/bme/_vortex/workflows/lean-persona/steps/step-03-problem-contexts.md +90 -0
- package/_bmad/bme/_vortex/workflows/lean-persona/steps/step-04-forces-anxieties.md +98 -0
- package/_bmad/bme/_vortex/workflows/lean-persona/steps/step-05-success-criteria.md +103 -0
- package/_bmad/bme/_vortex/workflows/lean-persona/steps/step-06-synthesize.md +129 -0
- package/_bmad/bme/_vortex/workflows/lean-persona/validate.md +30 -0
- package/_bmad/bme/_vortex/workflows/lean-persona/workflow.md +50 -0
- package/_bmad/bme/_vortex/workflows/learning-card/learning-card.template.md +179 -0
- package/_bmad/bme/_vortex/workflows/learning-card/steps/step-01-experiment-context.md +100 -0
- package/_bmad/bme/_vortex/workflows/learning-card/steps/step-02-raw-results.md +125 -0
- package/_bmad/bme/_vortex/workflows/learning-card/steps/step-03-analysis.md +125 -0
- package/_bmad/bme/_vortex/workflows/learning-card/steps/step-04-validated-learning.md +139 -0
- package/_bmad/bme/_vortex/workflows/learning-card/steps/step-05-implications.md +134 -0
- package/_bmad/bme/_vortex/workflows/learning-card/steps/step-06-synthesize.md +121 -0
- package/_bmad/bme/_vortex/workflows/learning-card/validate.md +134 -0
- package/_bmad/bme/_vortex/workflows/learning-card/workflow.md +51 -0
- package/_bmad/bme/_vortex/workflows/mvp/mvp.template.md +40 -0
- package/_bmad/bme/_vortex/workflows/mvp/steps/step-01-riskiest-assumption.md +17 -0
- package/_bmad/bme/_vortex/workflows/mvp/steps/step-02-success-criteria.md +13 -0
- package/_bmad/bme/_vortex/workflows/mvp/steps/step-03-smallest-test.md +13 -0
- package/_bmad/bme/_vortex/workflows/mvp/steps/step-04-scope-features.md +13 -0
- package/_bmad/bme/_vortex/workflows/mvp/steps/step-05-build-measure-learn.md +13 -0
- package/_bmad/bme/_vortex/workflows/mvp/steps/step-06-synthesize.md +28 -0
- package/_bmad/bme/_vortex/workflows/mvp/validate.md +30 -0
- package/_bmad/bme/_vortex/workflows/mvp/workflow.md +36 -0
- package/_bmad/bme/_vortex/workflows/pattern-mapping/steps/step-01-setup.md +102 -0
- package/_bmad/bme/_vortex/workflows/pattern-mapping/steps/step-02-context.md +81 -0
- package/_bmad/bme/_vortex/workflows/pattern-mapping/steps/step-03-pattern-identification.md +88 -0
- package/_bmad/bme/_vortex/workflows/pattern-mapping/steps/step-04-theme-clustering.md +100 -0
- package/_bmad/bme/_vortex/workflows/pattern-mapping/steps/step-05-synthesize.md +135 -0
- package/_bmad/bme/_vortex/workflows/pattern-mapping/workflow.md +58 -0
- package/_bmad/bme/_vortex/workflows/pivot-patch-persevere/pivot-patch-persevere.template.md +201 -0
- package/_bmad/bme/_vortex/workflows/pivot-patch-persevere/steps/step-01-evidence-review.md +125 -0
- package/_bmad/bme/_vortex/workflows/pivot-patch-persevere/steps/step-02-hypothesis-assessment.md +132 -0
- package/_bmad/bme/_vortex/workflows/pivot-patch-persevere/steps/step-03-option-analysis.md +167 -0
- package/_bmad/bme/_vortex/workflows/pivot-patch-persevere/steps/step-04-stakeholder-input.md +141 -0
- package/_bmad/bme/_vortex/workflows/pivot-patch-persevere/steps/step-05-decision.md +161 -0
- package/_bmad/bme/_vortex/workflows/pivot-patch-persevere/steps/step-06-action-plan.md +188 -0
- package/_bmad/bme/_vortex/workflows/pivot-patch-persevere/validate.md +159 -0
- package/_bmad/bme/_vortex/workflows/pivot-patch-persevere/workflow.md +51 -0
- package/_bmad/bme/_vortex/workflows/pivot-resynthesis/steps/step-01-setup.md +97 -0
- package/_bmad/bme/_vortex/workflows/pivot-resynthesis/steps/step-02-context.md +86 -0
- package/_bmad/bme/_vortex/workflows/pivot-resynthesis/steps/step-03-jtbd-reframing.md +88 -0
- package/_bmad/bme/_vortex/workflows/pivot-resynthesis/steps/step-04-pains-gains-revision.md +76 -0
- package/_bmad/bme/_vortex/workflows/pivot-resynthesis/steps/step-05-synthesize.md +158 -0
- package/_bmad/bme/_vortex/workflows/pivot-resynthesis/workflow.md +52 -0
- package/_bmad/bme/_vortex/workflows/product-vision/product-vision.template.md +147 -0
- package/_bmad/bme/_vortex/workflows/product-vision/steps/step-01-define-problem.md +89 -0
- package/_bmad/bme/_vortex/workflows/product-vision/steps/step-02-target-market.md +91 -0
- package/_bmad/bme/_vortex/workflows/product-vision/steps/step-03-unique-approach.md +87 -0
- package/_bmad/bme/_vortex/workflows/product-vision/steps/step-04-future-state.md +100 -0
- package/_bmad/bme/_vortex/workflows/product-vision/steps/step-05-principles.md +92 -0
- package/_bmad/bme/_vortex/workflows/product-vision/steps/step-06-synthesize.md +170 -0
- package/_bmad/bme/_vortex/workflows/product-vision/validate.md +30 -0
- package/_bmad/bme/_vortex/workflows/product-vision/workflow.md +55 -0
- package/_bmad/bme/_vortex/workflows/production-monitoring/steps/step-01-setup.md +84 -0
- package/_bmad/bme/_vortex/workflows/production-monitoring/steps/step-02-context.md +66 -0
- package/_bmad/bme/_vortex/workflows/production-monitoring/steps/step-03-monitoring.md +74 -0
- package/_bmad/bme/_vortex/workflows/production-monitoring/steps/step-04-prioritization.md +97 -0
- package/_bmad/bme/_vortex/workflows/production-monitoring/steps/step-05-synthesize.md +183 -0
- package/_bmad/bme/_vortex/workflows/production-monitoring/workflow.md +52 -0
- package/_bmad/bme/_vortex/workflows/proof-of-concept/proof-of-concept.template.md +25 -0
- package/_bmad/bme/_vortex/workflows/proof-of-concept/steps/step-01-risk.md +79 -0
- package/_bmad/bme/_vortex/workflows/proof-of-concept/steps/step-02-scope.md +105 -0
- package/_bmad/bme/_vortex/workflows/proof-of-concept/steps/step-03-build.md +92 -0
- package/_bmad/bme/_vortex/workflows/proof-of-concept/steps/step-04-test.md +103 -0
- package/_bmad/bme/_vortex/workflows/proof-of-concept/steps/step-05-evaluate.md +114 -0
- package/_bmad/bme/_vortex/workflows/proof-of-concept/steps/step-06-document.md +125 -0
- package/_bmad/bme/_vortex/workflows/proof-of-concept/validate.md +30 -0
- package/_bmad/bme/_vortex/workflows/proof-of-concept/workflow.md +26 -0
- package/_bmad/bme/_vortex/workflows/proof-of-value/proof-of-value.template.md +29 -0
- package/_bmad/bme/_vortex/workflows/proof-of-value/steps/step-01-value-hypothesis.md +75 -0
- package/_bmad/bme/_vortex/workflows/proof-of-value/steps/step-02-validation-design.md +94 -0
- package/_bmad/bme/_vortex/workflows/proof-of-value/steps/step-03-willingness.md +96 -0
- package/_bmad/bme/_vortex/workflows/proof-of-value/steps/step-04-test.md +107 -0
- package/_bmad/bme/_vortex/workflows/proof-of-value/steps/step-05-analyze.md +116 -0
- package/_bmad/bme/_vortex/workflows/proof-of-value/steps/step-06-document.md +147 -0
- package/_bmad/bme/_vortex/workflows/proof-of-value/validate.md +30 -0
- package/_bmad/bme/_vortex/workflows/proof-of-value/workflow.md +26 -0
- package/_bmad/bme/_vortex/workflows/research-convergence/steps/step-01-setup.md +69 -0
- package/_bmad/bme/_vortex/workflows/research-convergence/steps/step-02-context.md +70 -0
- package/_bmad/bme/_vortex/workflows/research-convergence/steps/step-03-jtbd-framing.md +81 -0
- package/_bmad/bme/_vortex/workflows/research-convergence/steps/step-04-pains-gains.md +77 -0
- package/_bmad/bme/_vortex/workflows/research-convergence/steps/step-05-synthesize.md +147 -0
- package/_bmad/bme/_vortex/workflows/research-convergence/workflow.md +50 -0
- package/_bmad/bme/_vortex/workflows/signal-interpretation/steps/step-01-setup.md +68 -0
- package/_bmad/bme/_vortex/workflows/signal-interpretation/steps/step-02-context.md +67 -0
- package/_bmad/bme/_vortex/workflows/signal-interpretation/steps/step-03-signal-analysis.md +85 -0
- package/_bmad/bme/_vortex/workflows/signal-interpretation/steps/step-04-anomaly-detection.md +93 -0
- package/_bmad/bme/_vortex/workflows/signal-interpretation/steps/step-05-synthesize.md +163 -0
- package/_bmad/bme/_vortex/workflows/signal-interpretation/workflow.md +52 -0
- package/_bmad/bme/_vortex/workflows/user-discovery/steps/step-01-discovery-scope.md +77 -0
- package/_bmad/bme/_vortex/workflows/user-discovery/steps/step-02-research-methods.md +152 -0
- package/_bmad/bme/_vortex/workflows/user-discovery/steps/step-03-research-plan.md +159 -0
- package/_bmad/bme/_vortex/workflows/user-discovery/steps/step-04-execute.md +169 -0
- package/_bmad/bme/_vortex/workflows/user-discovery/steps/step-05-organize-data.md +149 -0
- package/_bmad/bme/_vortex/workflows/user-discovery/steps/step-06-synthesize.md +159 -0
- package/_bmad/bme/_vortex/workflows/user-discovery/user-discovery.template.md +231 -0
- package/_bmad/bme/_vortex/workflows/user-discovery/validate.md +153 -0
- package/_bmad/bme/_vortex/workflows/user-discovery/workflow.md +45 -0
- package/_bmad/bme/_vortex/workflows/user-interview/steps/step-01-research-goals.md +100 -0
- package/_bmad/bme/_vortex/workflows/user-interview/steps/step-02-interview-script.md +123 -0
- package/_bmad/bme/_vortex/workflows/user-interview/steps/step-03-recruitment.md +144 -0
- package/_bmad/bme/_vortex/workflows/user-interview/steps/step-04-conduct.md +154 -0
- package/_bmad/bme/_vortex/workflows/user-interview/steps/step-05-findings.md +163 -0
- package/_bmad/bme/_vortex/workflows/user-interview/steps/step-06-synthesize.md +171 -0
- package/_bmad/bme/_vortex/workflows/user-interview/user-interview.template.md +250 -0
- package/_bmad/bme/_vortex/workflows/user-interview/validate.md +142 -0
- package/_bmad/bme/_vortex/workflows/user-interview/workflow.md +51 -0
- package/_bmad/bme/_vortex/workflows/vortex-navigation/steps/step-01-current-state.md +56 -0
- package/_bmad/bme/_vortex/workflows/vortex-navigation/steps/step-02-evidence-inventory.md +70 -0
- package/_bmad/bme/_vortex/workflows/vortex-navigation/steps/step-03-gap-analysis.md +76 -0
- package/_bmad/bme/_vortex/workflows/vortex-navigation/steps/step-04-stream-evaluation.md +57 -0
- package/_bmad/bme/_vortex/workflows/vortex-navigation/steps/step-05-recommendation.md +65 -0
- package/_bmad/bme/_vortex/workflows/vortex-navigation/steps/step-06-navigation-plan.md +72 -0
- package/_bmad/bme/_vortex/workflows/vortex-navigation/validate.md +75 -0
- package/_bmad/bme/_vortex/workflows/vortex-navigation/vortex-navigation.template.md +105 -0
- package/_bmad/bme/_vortex/workflows/vortex-navigation/workflow.md +54 -0
- package/index.js +56 -0
- package/package.json +77 -0
- package/scripts/README.md +226 -0
- package/scripts/convoke-doctor.js +322 -0
- package/scripts/docs-audit.js +584 -0
- package/scripts/install-all-agents.js +9 -0
- package/scripts/install-vortex-agents.js +208 -0
- package/scripts/postinstall.js +104 -0
- package/scripts/update/convoke-migrate.js +169 -0
- package/scripts/update/convoke-update.js +272 -0
- package/scripts/update/convoke-version.js +134 -0
- package/scripts/update/lib/agent-registry.js +144 -0
- package/scripts/update/lib/backup-manager.js +243 -0
- package/scripts/update/lib/config-merger.js +242 -0
- package/scripts/update/lib/migration-runner.js +367 -0
- package/scripts/update/lib/refresh-installation.js +171 -0
- package/scripts/update/lib/utils.js +96 -0
- package/scripts/update/lib/validator.js +360 -0
- package/scripts/update/lib/version-detector.js +241 -0
- package/scripts/update/migrations/1.0.x-to-1.3.0.js +128 -0
- package/scripts/update/migrations/1.1.x-to-1.3.0.js +29 -0
- package/scripts/update/migrations/1.2.x-to-1.3.0.js +29 -0
- package/scripts/update/migrations/1.3.x-to-1.5.0.js +29 -0
- package/scripts/update/migrations/1.4.x-to-1.5.0.js +29 -0
- package/scripts/update/migrations/1.5.x-to-1.6.0.js +95 -0
- package/scripts/update/migrations/1.6.x-to-1.7.0.js +29 -0
- package/scripts/update/migrations/1.7.x-to-2.0.0.js +31 -0
- package/scripts/update/migrations/registry.js +194 -0
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
workflow: pivot-patch-persevere
|
|
3
|
+
type: step-file
|
|
4
|
+
description: Make strategic pivot, patch, or persevere decisions based on experiment evidence
|
|
5
|
+
author: Max (learning-decision-expert)
|
|
6
|
+
version: 1.5.0
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Pivot / Patch / Persevere Decision Workflow
|
|
10
|
+
|
|
11
|
+
This workflow guides you through making a rigorous strategic decision after experiments: should you change direction (Pivot), adjust your approach (Patch), or stay the course (Persevere)?
|
|
12
|
+
|
|
13
|
+
## What is Pivot / Patch / Persevere?
|
|
14
|
+
|
|
15
|
+
Based on Eric Ries' Lean Startup methodology, this is a structured decision framework for what to do after experiments. Instead of relying on gut feelings or sunk-cost reasoning, you systematically evaluate evidence and make a defensible choice:
|
|
16
|
+
|
|
17
|
+
- **Pivot** - Fundamentally change direction. Your core hypothesis is wrong, and incremental adjustments won't fix it. You need a different approach, market, value proposition, or business model.
|
|
18
|
+
- **Patch** - Adjust your approach while keeping the core direction. The hypothesis is partially right but your execution, targeting, or specific solution needs modification.
|
|
19
|
+
- **Persevere** - Stay the course. Evidence supports your direction, and you should double down with more resources, broader experiments, or next-stage development.
|
|
20
|
+
|
|
21
|
+
**Why these three, not just "pivot or persevere"?** Most real decisions aren't binary. The most common outcome is "we're directionally right but need to adjust." Patch captures this middle ground and prevents both premature pivots (throwing away good ideas) and false perseverance (refusing to adapt).
|
|
22
|
+
|
|
23
|
+
## Workflow Structure
|
|
24
|
+
|
|
25
|
+
**Step-file architecture:**
|
|
26
|
+
- Just-in-time loading (each step loads only when needed)
|
|
27
|
+
- Sequential enforcement (must complete step N before step N+1)
|
|
28
|
+
- State tracking in frontmatter (progress preserved)
|
|
29
|
+
|
|
30
|
+
## Steps Overview
|
|
31
|
+
|
|
32
|
+
1. **Evidence Review** - Gather all relevant learning cards, experiment results, and evidence
|
|
33
|
+
2. **Hypothesis Assessment** - Assess original hypotheses: confirmed, partially confirmed, or invalidated?
|
|
34
|
+
3. **Option Analysis** - Analyze all three options with pros, cons, and risks
|
|
35
|
+
4. **Stakeholder Input** - Capture team perspectives, concerns, and preferences
|
|
36
|
+
5. **Decision** - Make and document the decision with clear rationale
|
|
37
|
+
6. **Action Plan** - Create a concrete action plan for the chosen direction
|
|
38
|
+
|
|
39
|
+
## Output
|
|
40
|
+
|
|
41
|
+
**Artifact:** Decision record in `{output_folder}/ppp-decision-{topic}-{date}.md`
|
|
42
|
+
|
|
43
|
+
**Template:** Uses [pivot-patch-persevere.template.md](pivot-patch-persevere.template.md)
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## INITIALIZATION
|
|
48
|
+
|
|
49
|
+
Load config from {project-root}/_bmad/bme/_vortex/config.yaml
|
|
50
|
+
|
|
51
|
+
Load step: {project-root}/_bmad/bme/_vortex/workflows/pivot-patch-persevere/steps/step-01-evidence-review.md
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
---
|
|
2
|
+
step: 1
|
|
3
|
+
workflow: pivot-resynthesis
|
|
4
|
+
title: Setup & Input Validation
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Step 1: Setup & Input Validation
|
|
8
|
+
|
|
9
|
+
You're here because Max analyzed the evidence and made a decision: **pivot**. The solution direction failed, but the problem definition is sound. The experiment told us something important — and now we use that knowledge to sharpen, not restart.
|
|
10
|
+
|
|
11
|
+
## Why This Matters
|
|
12
|
+
|
|
13
|
+
Pivot resynthesis is fundamentally different from fresh convergence. You already have a validated problem space. What you're doing now is integrating new evidence — from experiments that didn't go as expected — into a revised problem definition. We're not starting over. We're iterating within the known space.
|
|
14
|
+
|
|
15
|
+
## Your Task
|
|
16
|
+
|
|
17
|
+
### 1. Understand the Pivot Context
|
|
18
|
+
|
|
19
|
+
Max decided "pivot" based on the evidence. This means:
|
|
20
|
+
- **The problem is correct** — users do experience the pain your research identified
|
|
21
|
+
- **The solution direction failed** — the hypothesis about how to solve it was wrong
|
|
22
|
+
- **New evidence exists** — the failed experiment revealed what doesn't work and why
|
|
23
|
+
|
|
24
|
+
### 2. List Your Input Artifacts
|
|
25
|
+
|
|
26
|
+
You'll need two types of input:
|
|
27
|
+
|
|
28
|
+
**Original Research (HC1 Empathy Artifacts):**
|
|
29
|
+
Your original Isla artifacts — empathy maps, interview syntheses, observation reports. These provide the research foundation that remains valid.
|
|
30
|
+
|
|
31
|
+
**Experiment Evidence (HC4 or informal):**
|
|
32
|
+
Results from the failed experiment — what was tested, what happened, what was learned. This can be a formal HC4 artifact from Wade or informal experiment notes.
|
|
33
|
+
|
|
34
|
+
**Prior Problem Definition (optional):**
|
|
35
|
+
If you have the original HC2 problem definition from before the experiment, it provides the JTBD baseline for re-framing.
|
|
36
|
+
|
|
37
|
+
### 3. Validate Your Artifacts
|
|
38
|
+
|
|
39
|
+
**HC1 Empathy Artifacts — Frontmatter Check:**
|
|
40
|
+
- `contract: HC1`
|
|
41
|
+
- `type: artifact`
|
|
42
|
+
- `source_agent` (e.g., `isla`)
|
|
43
|
+
- `source_workflow` (e.g., `empathy-map`, `user-interview`, `user-discovery`)
|
|
44
|
+
- `target_agents` (should include `mila`)
|
|
45
|
+
- `input_artifacts`
|
|
46
|
+
- `created` (YYYY-MM-DD)
|
|
47
|
+
|
|
48
|
+
**HC1 Body Sections:**
|
|
49
|
+
- Executive Summary
|
|
50
|
+
- Research Context
|
|
51
|
+
- Synthesized Insights
|
|
52
|
+
- Key Themes
|
|
53
|
+
- Pain Points
|
|
54
|
+
- Desired Gains
|
|
55
|
+
- Recommendations
|
|
56
|
+
|
|
57
|
+
Reference: `{project-root}/_bmad/bme/_vortex/contracts/hc1-empathy-artifacts.md`
|
|
58
|
+
|
|
59
|
+
**HC4 Experiment Context — Frontmatter Check:**
|
|
60
|
+
- `contract: HC4`
|
|
61
|
+
- `type: artifact`
|
|
62
|
+
- `source_agent` (e.g., `wade`)
|
|
63
|
+
- `source_workflow` (e.g., `lean-experiment`, `proof-of-concept`)
|
|
64
|
+
- `target_agents`
|
|
65
|
+
- `input_artifacts`
|
|
66
|
+
- `created` (YYYY-MM-DD)
|
|
67
|
+
|
|
68
|
+
**HC4 Body Sections:**
|
|
69
|
+
- Experiment Summary
|
|
70
|
+
- Hypothesis Tested
|
|
71
|
+
- Experiment Method
|
|
72
|
+
- Pre-Defined Success Criteria
|
|
73
|
+
- Confirmed/Rejected Hypotheses
|
|
74
|
+
- Strategic Context
|
|
75
|
+
- Production Readiness (if experiment graduated to production)
|
|
76
|
+
|
|
77
|
+
Reference: `{project-root}/_bmad/bme/_vortex/contracts/hc4-experiment-context.md`
|
|
78
|
+
|
|
79
|
+
### 4. Non-Conforming Input
|
|
80
|
+
|
|
81
|
+
If your artifacts don't perfectly match the HC1 or HC4 schemas, we don't reject them — the data shows that real-world research rarely arrives in perfect format. Instead, note which sections are present and which are missing. We'll work with what you have and guide you to fill gaps where needed.
|
|
82
|
+
|
|
83
|
+
The critical information for pivot resynthesis is:
|
|
84
|
+
- From HC1: What pains and gains did the original research identify?
|
|
85
|
+
- From HC4: What was tested? What failed? What did we learn?
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## Your Turn
|
|
90
|
+
|
|
91
|
+
Walk me through your artifacts. What HC1 research do you have, and what experiment evidence are you bringing to the table? The data shows that the most effective pivots happen when we lay all the evidence side by side.
|
|
92
|
+
|
|
93
|
+
## Next Step
|
|
94
|
+
|
|
95
|
+
When we've validated your inputs, I'll load:
|
|
96
|
+
|
|
97
|
+
{project-root}/_bmad/bme/_vortex/workflows/pivot-resynthesis/steps/step-02-context.md
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
---
|
|
2
|
+
step: 2
|
|
3
|
+
workflow: pivot-resynthesis
|
|
4
|
+
title: Context Loading & Analysis
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Step 2: Context Loading & Analysis
|
|
8
|
+
|
|
9
|
+
Now that we know what artifacts we're working with, let's load them all and build the pivot context. The data shows that the most important step in pivot resynthesis is understanding what the experiment actually revealed — and separating that from what the original research already told us.
|
|
10
|
+
|
|
11
|
+
## Why This Matters
|
|
12
|
+
|
|
13
|
+
You have two evidence streams: the original research and the experiment results. Laying them side by side reveals what still holds, what's been disproved, and what's newly understood. This is where we figure out what to revise and what to preserve.
|
|
14
|
+
|
|
15
|
+
## Your Task
|
|
16
|
+
|
|
17
|
+
### 1. Load All Input Artifacts
|
|
18
|
+
|
|
19
|
+
Read through each of your input artifacts completely. For each artifact, note:
|
|
20
|
+
- **What** was the original finding or hypothesis
|
|
21
|
+
- **How strong** the evidence was (direct quotes, observed behavior, survey data, or assumptions)
|
|
22
|
+
- **What happened** in the experiment related to this finding
|
|
23
|
+
|
|
24
|
+
### 2. Establish Pivot Context
|
|
25
|
+
|
|
26
|
+
Answer these four questions — they form the foundation for everything that follows:
|
|
27
|
+
|
|
28
|
+
**(a) What was the original problem definition?**
|
|
29
|
+
What JTBD, pains, and gains did the original HC2 define? If you don't have a prior HC2, summarize the original problem understanding from your HC1 artifacts.
|
|
30
|
+
|
|
31
|
+
**(b) What hypothesis was tested?**
|
|
32
|
+
What did the team believe would work? What riskiest assumption was the experiment designed to validate?
|
|
33
|
+
|
|
34
|
+
**(c) What did the experiment reveal?**
|
|
35
|
+
What failed and why? Was the hypothesis rejected outright, or partially confirmed? What unexpected results emerged?
|
|
36
|
+
|
|
37
|
+
**(d) What unexpected findings emerged?**
|
|
38
|
+
The data shows that failed experiments often reveal more than successful ones. What did you learn that nobody predicted?
|
|
39
|
+
|
|
40
|
+
### 3. "What Still Holds?" Assessment
|
|
41
|
+
|
|
42
|
+
This is the critical pivot analysis. For each element of your original problem definition, assess:
|
|
43
|
+
|
|
44
|
+
| Element | Status | Evidence |
|
|
45
|
+
|---------|--------|----------|
|
|
46
|
+
| JTBD core (situation/motivation/outcome) | `Holds` / `Needs revision` / `Invalidated` | What evidence supports this assessment? |
|
|
47
|
+
| Pain 1: [name] | `Retained` / `Revised` / `Removed` / `New` | Experiment confirmed/contradicted this? |
|
|
48
|
+
| Pain 2: [name] | `Retained` / `Revised` / `Removed` / `New` | Experiment confirmed/contradicted this? |
|
|
49
|
+
| Gain 1: [name] | `Retained` / `Revised` / `Reprioritized` / `Removed` / `New` | What did the experiment show about this gain? |
|
|
50
|
+
| *Add rows as needed* | | |
|
|
51
|
+
|
|
52
|
+
**New elements to add:**
|
|
53
|
+
- Pains newly revealed by experiment failure
|
|
54
|
+
- Gains suggested by unexpected experiment findings
|
|
55
|
+
- Assumptions invalidated by experiment evidence
|
|
56
|
+
|
|
57
|
+
### 4. Synthesis Inventory
|
|
58
|
+
|
|
59
|
+
Based on your pivot context analysis, organize your thinking:
|
|
60
|
+
|
|
61
|
+
- **Strongest surviving signal:** Which original finding is most strongly confirmed by the experiment evidence?
|
|
62
|
+
- **Biggest revision needed:** What did the experiment most clearly disprove or change?
|
|
63
|
+
- **Most surprising insight:** What unexpected learning emerged from the failed experiment?
|
|
64
|
+
- **Revised problem shape:** If you had to describe the revised core problem in one sentence right now, what would it be?
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
## Example Pivot Context Analysis
|
|
69
|
+
|
|
70
|
+
**From original research (HC1)** + **experiment results (HC4):**
|
|
71
|
+
|
|
72
|
+
- **Original JTBD:** "When switching between tools during analysis, I want consolidated data views, so I can make decisions without context-switching."
|
|
73
|
+
- **Experiment tested:** A consolidated dashboard reducing tool-switching by 50%
|
|
74
|
+
- **What failed:** Users still switched tools despite the dashboard — the pain wasn't tool-switching, it was *not knowing which data to trust*
|
|
75
|
+
- **What holds:** JTBD core holds (users want to make decisions without friction). Situation needs revision: not "switching between tools" but "encountering conflicting data."
|
|
76
|
+
- **What changed:** Pain A (time spent switching tools) → Invalidated. New Pain: uncertainty about data accuracy. Gain priority shifted: "faster decisions" is less important than "confident decisions."
|
|
77
|
+
|
|
78
|
+
## Your Turn
|
|
79
|
+
|
|
80
|
+
Walk me through your pivot context analysis. The original research still holds — here's what we're revising based on what the experiment revealed. Three patterns converge on this insight — share what you're finding and I'll help you sharpen the revision.
|
|
81
|
+
|
|
82
|
+
## Next Step
|
|
83
|
+
|
|
84
|
+
When we've mapped the pivot landscape, I'll load:
|
|
85
|
+
|
|
86
|
+
{project-root}/_bmad/bme/_vortex/workflows/pivot-resynthesis/steps/step-03-jtbd-reframing.md
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
---
|
|
2
|
+
step: 3
|
|
3
|
+
workflow: pivot-resynthesis
|
|
4
|
+
title: JTBD Re-Framing
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Step 3: JTBD Re-Framing
|
|
8
|
+
|
|
9
|
+
Now we take your "What Still Holds?" assessment and apply it to the Jobs-to-be-Done framing. The JTBD core is sound. What changed is the evidence around it — and that may require revisions to the situation, motivation, or outcome.
|
|
10
|
+
|
|
11
|
+
## Why This Matters
|
|
12
|
+
|
|
13
|
+
The data shows that in a pivot scenario, the JTBD core typically remains stable. Max routed you here — not to Emma — because the problem itself is right. What failed is the solution direction, which means the way we framed the pains and gains around the job may need updating. But we start from the existing JTBD, not from blank.
|
|
14
|
+
|
|
15
|
+
We're not starting over — we're sharpening.
|
|
16
|
+
|
|
17
|
+
## Your Task
|
|
18
|
+
|
|
19
|
+
### 1. Review the Original JTBD
|
|
20
|
+
|
|
21
|
+
Start from your existing JTBD (from the original HC2 or your step-02 analysis):
|
|
22
|
+
|
|
23
|
+
> When [original situation], I want to [original motivation], so I can [original expected outcome].
|
|
24
|
+
|
|
25
|
+
### 2. Assess Each Component Against Experiment Evidence
|
|
26
|
+
|
|
27
|
+
For each part of the JTBD, ask:
|
|
28
|
+
|
|
29
|
+
**Situation — Does the triggering context still hold?**
|
|
30
|
+
- Did the experiment confirm users are in this situation?
|
|
31
|
+
- Or did it reveal the real triggering context is different?
|
|
32
|
+
- Example: "When switching between tools" → revised to "When encountering conflicting data sources"
|
|
33
|
+
|
|
34
|
+
**Motivation — Does the core want still hold?**
|
|
35
|
+
- The motivation is usually the most stable part. Did the experiment challenge what users actually want?
|
|
36
|
+
- Example: "I want consolidated data views" → typically stable, but might shift to "I want trustworthy data"
|
|
37
|
+
|
|
38
|
+
**Expected Outcome — Does the desired end state still hold?**
|
|
39
|
+
- Did the experiment reveal that users' real desired outcome is different from what was assumed?
|
|
40
|
+
- Example: "so I can make decisions without context-switching" → revised to "so I can make decisions with confidence"
|
|
41
|
+
|
|
42
|
+
### 3. Draft the Revised JTBD
|
|
43
|
+
|
|
44
|
+
> When [revised situation], I want to [revised motivation], so I can [revised expected outcome].
|
|
45
|
+
|
|
46
|
+
For each component you revised, note:
|
|
47
|
+
- **What changed** and **why** (link to specific experiment evidence)
|
|
48
|
+
- **What stayed the same** and **why** it's confirmed
|
|
49
|
+
|
|
50
|
+
### 4. Assess Functional, Emotional, and Social Jobs
|
|
51
|
+
|
|
52
|
+
**Functional Job** (required): What practical task is the user trying to accomplish?
|
|
53
|
+
- Did the experiment change our understanding of the functional job?
|
|
54
|
+
- The data shows that functional jobs rarely change in a pivot — the "what" is usually right, it's the "how" that failed.
|
|
55
|
+
|
|
56
|
+
**Emotional Job** (if evidence exists): How does the user want to feel?
|
|
57
|
+
- Failed experiments often reveal emotional jobs more clearly than successful ones.
|
|
58
|
+
- Did the experiment surface emotional needs that the original research missed?
|
|
59
|
+
|
|
60
|
+
**Social Job** (if evidence exists): How does the user want to be perceived?
|
|
61
|
+
- Did experiment evidence surface social dynamics that affect the job?
|
|
62
|
+
|
|
63
|
+
### 5. Evidence Grounding
|
|
64
|
+
|
|
65
|
+
For every revision, ground it in specific evidence:
|
|
66
|
+
- "We revised the situation because HC4 showed [specific finding]"
|
|
67
|
+
- "The motivation holds because HC1 artifacts A and B both support [evidence]"
|
|
68
|
+
- "The outcome shifted because the experiment revealed [unexpected result]"
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
## Your Turn
|
|
73
|
+
|
|
74
|
+
Share your revised JTBD. Walk me through what changed, what held, and what evidence drove each decision. Across the original research and the pivot evidence, the revised problem should feel like a sharper version of the original — not a different problem entirely.
|
|
75
|
+
|
|
76
|
+
---
|
|
77
|
+
|
|
78
|
+
**[a]** Advanced Elicitation — Deep dive into JTBD re-framing with guided questioning
|
|
79
|
+
**[p]** Party Mode — Bring in other Vortex agents for collaborative discussion
|
|
80
|
+
**[c]** Continue — Move to Pains & Gains Revision
|
|
81
|
+
|
|
82
|
+
---
|
|
83
|
+
|
|
84
|
+
## Next Step
|
|
85
|
+
|
|
86
|
+
When we've locked in the revised JTBD, I'll load:
|
|
87
|
+
|
|
88
|
+
{project-root}/_bmad/bme/_vortex/workflows/pivot-resynthesis/steps/step-04-pains-gains-revision.md
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
---
|
|
2
|
+
step: 4
|
|
3
|
+
workflow: pivot-resynthesis
|
|
4
|
+
title: Pains & Gains Revision
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Step 4: Pains & Gains Revision
|
|
8
|
+
|
|
9
|
+
With the revised JTBD in place, it's time to update the pains and gains. The experiment evidence changes the landscape — some original pains are confirmed, some are invalidated, and new ones have emerged. The data shows that the pains and gains table is where pivots have their biggest impact.
|
|
10
|
+
|
|
11
|
+
## Why This Matters
|
|
12
|
+
|
|
13
|
+
Pains and gains are the operational layer of your problem definition. They're what Liam will use to generate new hypotheses, and what Wade will use to design new experiments. Getting them right — grounded in both original research AND experiment evidence — is the highest-leverage activity in pivot resynthesis.
|
|
14
|
+
|
|
15
|
+
## Your Task
|
|
16
|
+
|
|
17
|
+
### 1. Revise Pains
|
|
18
|
+
|
|
19
|
+
Work through each pain from your original problem definition using this framework:
|
|
20
|
+
|
|
21
|
+
**Retain:** Pains validated by the experiment (evidence confirms users experience this)
|
|
22
|
+
**Remove or deprioritize:** Pains invalidated by experiment evidence (the experiment showed this isn't actually a pain, or it's far less severe than assumed)
|
|
23
|
+
**Add:** New pains revealed by the experiment failure (things we didn't know were painful until the experiment failed)
|
|
24
|
+
**Update:** Pains whose frequency or intensity changed based on experiment data
|
|
25
|
+
|
|
26
|
+
| Pain Description | Revision Status | Priority | Frequency | Intensity | Evidence Sources | Current Coping |
|
|
27
|
+
|-----------------|-----------------|----------|-----------|-----------|-----------------|----------------|
|
|
28
|
+
| *[Original pain — keep/revise/remove]* | `Retained` / `Revised` / `Removed` / `New` | High/Med/Low | How often | How severely | HC1 artifact + HC4 finding | How users cope |
|
|
29
|
+
|
|
30
|
+
**For each retained pain:** Note which HC1 artifact originally identified it AND what HC4 evidence confirmed it.
|
|
31
|
+
|
|
32
|
+
**For each removed pain:** Note which HC4 evidence invalidated it and why.
|
|
33
|
+
|
|
34
|
+
**For each new pain:** Note which HC4 evidence revealed it and why the original research missed it.
|
|
35
|
+
|
|
36
|
+
### 2. Revise Gains
|
|
37
|
+
|
|
38
|
+
Apply the same framework to gains:
|
|
39
|
+
|
|
40
|
+
**Retain:** Gains still relevant after the experiment
|
|
41
|
+
**Reprioritize:** Gains whose importance shifted based on experiment results
|
|
42
|
+
**Add:** New gains suggested by the pivot direction or experiment insights
|
|
43
|
+
**Remove:** Gains that the experiment showed users don't actually want
|
|
44
|
+
|
|
45
|
+
| Gain Description | Revision Status | Priority | Expected Impact | Evidence Sources |
|
|
46
|
+
|-----------------|-----------------|----------|-----------------|-----------------|
|
|
47
|
+
| *[Original gain — keep/revise/remove]* | `Retained` / `Revised` / `Reprioritized` / `Removed` / `New` | High/Med/Low | How this changes the user's situation | HC1 artifact + HC4 finding |
|
|
48
|
+
|
|
49
|
+
### 3. Cross-Reference Against Revised JTBD
|
|
50
|
+
|
|
51
|
+
Now verify alignment. For each revised pain and gain:
|
|
52
|
+
- Does it connect logically to the revised JTBD from Step 3?
|
|
53
|
+
- If a pain no longer applies to the job, remove it — even if it was originally High priority
|
|
54
|
+
- If a gain doesn't relate to the revised motivation or outcome, reconsider its relevance
|
|
55
|
+
|
|
56
|
+
Three patterns converge on this insight: the pains and gains that survive both original research AND experiment evidence are your strongest signals. These are the foundation for Liam's next round of hypotheses.
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
## Your Turn
|
|
61
|
+
|
|
62
|
+
Walk me through your revised pains and gains tables. For each change, tell me: what changed, what evidence drove the change, and how it connects to the revised JTBD. Based on the experiment evidence, the revised picture should feel sharper and more grounded than the original.
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
**[a]** Advanced Elicitation — Deep dive into pains and gains revision with guided questioning
|
|
67
|
+
**[p]** Party Mode — Bring in other Vortex agents for collaborative discussion
|
|
68
|
+
**[c]** Continue — Move to Synthesis & Routing
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
## Next Step
|
|
73
|
+
|
|
74
|
+
When we've finalized the revised pains and gains, I'll load:
|
|
75
|
+
|
|
76
|
+
{project-root}/_bmad/bme/_vortex/workflows/pivot-resynthesis/steps/step-05-synthesize.md
|
|
@@ -0,0 +1,158 @@
|
|
|
1
|
+
---
|
|
2
|
+
step: 5
|
|
3
|
+
workflow: pivot-resynthesis
|
|
4
|
+
title: Synthesize & Route
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Step 5: Synthesize & Route
|
|
8
|
+
|
|
9
|
+
Time to bring everything together. We've validated artifacts, established pivot context, re-framed the JTBD, and revised pains and gains. Now we converge it all into a revised HC2 Problem Definition artifact. Across the original research and the pivot evidence, the revised problem should feel like a sharper, evidence-strengthened version of the original.
|
|
10
|
+
|
|
11
|
+
## Why This Matters
|
|
12
|
+
|
|
13
|
+
This revised problem definition is what Liam will use to generate new hypotheses. It needs to be clear about what changed, what held, and why — so Liam doesn't repeat the failed experiment direction. The data shows that the most effective pivots are ones where the revised problem definition makes the old direction's failure obvious in hindsight.
|
|
14
|
+
|
|
15
|
+
## Your Task
|
|
16
|
+
|
|
17
|
+
### 1. Revised Converged Problem Statement
|
|
18
|
+
|
|
19
|
+
Write a single, clear problem statement that synthesizes both the original research and the experiment evidence:
|
|
20
|
+
|
|
21
|
+
**Problem Statement:** One concise paragraph defining the revised core problem. This should feel like a sharper version of the original — not a different problem entirely.
|
|
22
|
+
|
|
23
|
+
**What Changed:** Explicitly note what shifted from the original problem definition and why.
|
|
24
|
+
|
|
25
|
+
**Confidence:** `High` / `Medium` / `Low`
|
|
26
|
+
- **High:** Original research confirmed by experiment evidence; revisions are evidence-backed
|
|
27
|
+
- **Medium:** Evidence points in this direction but the pivot introduced new uncertainties
|
|
28
|
+
- **Low:** Experiment contradicted significant original assumptions; the revised definition is best-effort
|
|
29
|
+
|
|
30
|
+
Note: Confidence may increase (we eliminated wrong directions) or decrease (experiment revealed we misunderstood key pains). Assess honestly based on total evidence.
|
|
31
|
+
|
|
32
|
+
**Scope:** What is explicitly in and out of scope for this revised problem.
|
|
33
|
+
|
|
34
|
+
### 2. Evidence Summary
|
|
35
|
+
|
|
36
|
+
Build the traceability record — how did we get here, and what's different?
|
|
37
|
+
|
|
38
|
+
| Field | Your Answer |
|
|
39
|
+
|-------|-------------|
|
|
40
|
+
| **Artifacts Analyzed** | Count and list both HC1 artifacts AND HC4 experiment evidence used |
|
|
41
|
+
| **Total Evidence Points** | Count discrete quotes, observations, and data points across all artifacts (original + experiment) |
|
|
42
|
+
| **Convergence Assessment** | How strongly does the revised evidence converge on a single problem? Is it stronger or weaker than the original? |
|
|
43
|
+
| **Contradictions** | Where did original research and experiment evidence conflict? How was this resolved? |
|
|
44
|
+
| **Evidence Gaps** | What's still missing that would strengthen this revised problem definition? |
|
|
45
|
+
|
|
46
|
+
**Provenance — What Changed and Why:**
|
|
47
|
+
For each major revision to pains and gains, note:
|
|
48
|
+
- Which HC4 experiment evidence triggered the revision
|
|
49
|
+
- Which HC1 original source the item came from
|
|
50
|
+
- Whether the item was retained, revised, removed, or newly added
|
|
51
|
+
|
|
52
|
+
### 3. Assumptions
|
|
53
|
+
|
|
54
|
+
Every problem definition embeds assumptions. After a pivot, some assumptions are validated, some invalidated, and some are new:
|
|
55
|
+
|
|
56
|
+
| Assumption | Basis | Risk if Wrong | Validation Status |
|
|
57
|
+
|------------|-------|---------------|-------------------|
|
|
58
|
+
| *What we're assuming is true* | *Why it seems reasonable given original + experiment evidence* | *What happens if this is incorrect* | `Validated` / `Partially Validated` / `Assumed` |
|
|
59
|
+
|
|
60
|
+
> **Pivot-resynthesis note:** For assumptions that were **invalidated by the experiment**, don't include them in this table — they've already been removed or revised in your pains/gains. This table captures what you're carrying forward. If you need to document what was invalidated, note it in the Evidence Summary's provenance section.
|
|
61
|
+
|
|
62
|
+
Note which assumptions were **validated by the experiment** (strongest basis), which were **invalidated** (removed or revised), and which are **new assumptions** that emerged from the pivot evidence.
|
|
63
|
+
|
|
64
|
+
### 4. Generate the HC2 Artifact
|
|
65
|
+
|
|
66
|
+
I'll produce the revised HC2 Problem Definition artifact with this structure:
|
|
67
|
+
|
|
68
|
+
```yaml
|
|
69
|
+
---
|
|
70
|
+
contract: HC2
|
|
71
|
+
type: artifact
|
|
72
|
+
source_agent: mila
|
|
73
|
+
source_workflow: pivot-resynthesis
|
|
74
|
+
target_agents: [liam]
|
|
75
|
+
input_artifacts:
|
|
76
|
+
- path: "_bmad-output/vortex-artifacts/{your-hc1-artifact-1}"
|
|
77
|
+
contract: HC1
|
|
78
|
+
- path: "_bmad-output/vortex-artifacts/{your-hc4-experiment}"
|
|
79
|
+
contract: HC4
|
|
80
|
+
created: YYYY-MM-DD
|
|
81
|
+
---
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
**HC2 Required Body Sections:**
|
|
85
|
+
1. **Converged Problem Statement** — Revised Problem Statement, What Changed, Confidence, Scope
|
|
86
|
+
2. **Jobs-to-be-Done** — Revised JTBD (from Step 3) + Functional/Emotional/Social Jobs
|
|
87
|
+
3. **Pains** — Revised pain table with revision status (from Step 4)
|
|
88
|
+
4. **Gains** — Revised gain table with revision status (from Step 4)
|
|
89
|
+
5. **Evidence Summary** — Dual-source traceability record (from above)
|
|
90
|
+
6. **Assumptions** — Updated assumptions with validation status (from above)
|
|
91
|
+
|
|
92
|
+
**Save to:** `{output_folder}/vortex-artifacts/hc2-problem-definition-{date}.md`
|
|
93
|
+
|
|
94
|
+
I'll create this file with all the sections above once you confirm the content is ready.
|
|
95
|
+
|
|
96
|
+
### 5. Validation Questions
|
|
97
|
+
|
|
98
|
+
Before we finalize, let's validate:
|
|
99
|
+
|
|
100
|
+
**Evidence Check:**
|
|
101
|
+
- [ ] Is every revised pain and gain backed by at least one HC1 or HC4 artifact reference?
|
|
102
|
+
- [ ] Can we trace the revised JTBD back to specific original research AND experiment evidence?
|
|
103
|
+
- [ ] Did we document contradictions between original research and experiment evidence honestly?
|
|
104
|
+
- [ ] Is it clear which items were retained, revised, removed, or newly added?
|
|
105
|
+
|
|
106
|
+
**Convergence Check:**
|
|
107
|
+
- [ ] Does the revised problem statement follow naturally from the revised JTBD + Pains + Gains?
|
|
108
|
+
- [ ] Would someone reading only the revised problem statement understand what changed and why?
|
|
109
|
+
- [ ] Is the confidence level honest given both original and experiment evidence?
|
|
110
|
+
|
|
111
|
+
**Actionability Check:**
|
|
112
|
+
- [ ] Can Liam use this to generate NEW hypotheses that avoid the failed experiment direction?
|
|
113
|
+
- [ ] Are the assumptions specific enough to validate or invalidate?
|
|
114
|
+
- [ ] Is it clear what the experiment disproved so Liam doesn't repeat the same direction?
|
|
115
|
+
|
|
116
|
+
---
|
|
117
|
+
|
|
118
|
+
## Your Turn
|
|
119
|
+
|
|
120
|
+
Let's build the Revised Converged Problem Statement, Evidence Summary, and Assumptions table. Confirm when you're ready for me to generate the final HC2 artifact.
|
|
121
|
+
|
|
122
|
+
---
|
|
123
|
+
|
|
124
|
+
**[a]** Advanced Elicitation — Deep dive into synthesis with guided questioning
|
|
125
|
+
**[p]** Party Mode — Bring in other Vortex agents for collaborative discussion
|
|
126
|
+
**[c]** Continue — Generate the HC2 artifact and proceed to routing
|
|
127
|
+
|
|
128
|
+
---
|
|
129
|
+
|
|
130
|
+
## Vortex Compass
|
|
131
|
+
|
|
132
|
+
Based on what you just completed, here are your evidence-driven options:
|
|
133
|
+
|
|
134
|
+
| If you learned... | Consider next... | Agent | Why |
|
|
135
|
+
|---|---|---|---|
|
|
136
|
+
| Revised problem definition is ready with strong evidence | hypothesis-engineering | Liam 💡 | Revised problem ready for new hypothesis generation (HC2) |
|
|
137
|
+
| Assumptions from pivot need validation before new hypotheses | user-interview | Isla 🔍 | New assumptions need real-user validation before proceeding |
|
|
138
|
+
|
|
139
|
+
> **Note:** These are evidence-based recommendations. You can navigate to any Vortex agent
|
|
140
|
+
> at any time based on your judgment.
|
|
141
|
+
|
|
142
|
+
**Or run Max's [VN] Vortex Navigation** for a full gap analysis across all streams.
|
|
143
|
+
|
|
144
|
+
### ⚠️ Insufficient Evidence for Routing
|
|
145
|
+
|
|
146
|
+
If the evidence gathered so far doesn't clearly point to a single next step:
|
|
147
|
+
|
|
148
|
+
| To route to... | You need... |
|
|
149
|
+
|----------------|-------------|
|
|
150
|
+
| Liam 💡 | Revised problem definition with clear JTBD, revised pains/gains, and evidence that avoids the failed direction |
|
|
151
|
+
| Isla 🔍 | Identified new assumptions from the pivot that are too risky to proceed without validation |
|
|
152
|
+
|
|
153
|
+
**Workflow-specific signals:**
|
|
154
|
+
- Revised problem statement is low-confidence → consider **Isla** for more evidence before proceeding
|
|
155
|
+
- Experiment evidence contradicts all original pains → more discovery needed; consider **Isla** for focused research
|
|
156
|
+
- JTBD itself is questioned (not just pains/gains) → the problem space may be wrong; consider **Emma** for re-scoping
|
|
157
|
+
|
|
158
|
+
**Recommended:** Revisit earlier steps to strengthen your evidence, or run **Max's [VN] Vortex Navigation** for a full gap analysis.
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
---
|
|
2
|
+
workflow: pivot-resynthesis
|
|
3
|
+
type: step-file
|
|
4
|
+
description: Re-synthesize a problem definition after failed experiments using original research plus pivot evidence
|
|
5
|
+
author: Mila (research-convergence-specialist)
|
|
6
|
+
version: 1.6.0
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Pivot Resynthesis Workflow
|
|
10
|
+
|
|
11
|
+
This workflow guides you through re-synthesizing a problem definition after Max's pivot decision. You'll integrate your original Isla artifacts with new evidence from failed experiments to produce a revised, evidence-backed problem statement.
|
|
12
|
+
|
|
13
|
+
## What is Pivot Resynthesis?
|
|
14
|
+
|
|
15
|
+
The experiment told us something important: the solution direction was wrong, but the problem definition is sound. Pivot resynthesis is how we respond — not by starting over, but by sharpening what we already know.
|
|
16
|
+
|
|
17
|
+
Here's what the research is telling us: your original findings still hold. What changed is the evidence landscape. Failed experiments reveal which pains and gains were real and which were assumptions. This workflow helps you revise your problem definition using both the original research and the new experiment evidence.
|
|
18
|
+
|
|
19
|
+
The key distinction: research convergence creates a problem definition from scratch. Pivot resynthesis revises an existing one. We're not starting over — we're iterating within the known problem space.
|
|
20
|
+
|
|
21
|
+
## Workflow Structure
|
|
22
|
+
|
|
23
|
+
**Step-file architecture:**
|
|
24
|
+
- Just-in-time loading (each step loads only when needed)
|
|
25
|
+
- Sequential enforcement (must complete step N before step N+1)
|
|
26
|
+
- State tracking in frontmatter (progress preserved)
|
|
27
|
+
|
|
28
|
+
## Steps Overview
|
|
29
|
+
|
|
30
|
+
1. **Setup & Input Validation** - Validate dual inputs: original HC1 empathy artifacts plus experiment evidence (HC4 or informal)
|
|
31
|
+
2. **Context Loading & Analysis** - Load all artifacts, establish pivot context, assess "What Still Holds?"
|
|
32
|
+
3. **JTBD Re-Framing** - Revise the existing JTBD based on experiment evidence (preserve what's valid, revise what's disproved)
|
|
33
|
+
4. **Pains & Gains Revision** - Update pains and gains: retain validated, remove invalidated, add newly revealed
|
|
34
|
+
5. **Synthesize & Route** - Converge into a revised HC2 problem definition and route via Compass
|
|
35
|
+
|
|
36
|
+
## Output
|
|
37
|
+
|
|
38
|
+
**Artifact:** HC2 Problem Definition markdown file in `{output_folder}/vortex-artifacts/hc2-problem-definition-{date}.md`
|
|
39
|
+
|
|
40
|
+
**Template:** None (HC2 artifact is generated inline during Step 5)
|
|
41
|
+
|
|
42
|
+
**Schema:** Conforms to HC2 contract (`_bmad/bme/_vortex/contracts/hc2-problem-definition.md`)
|
|
43
|
+
|
|
44
|
+
**Consumer:** Liam (hypothesis-engineering) uses this to ground new hypothesis generation in a revised, evidence-strengthened problem.
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
## INITIALIZATION
|
|
49
|
+
|
|
50
|
+
Load config from {project-root}/_bmad/bme/_vortex/config.yaml
|
|
51
|
+
|
|
52
|
+
Load step: {project-root}/_bmad/bme/_vortex/workflows/pivot-resynthesis/steps/step-01-setup.md
|