feat(examples): add workflow readiness instrument family

README.md

@@ -60,6 +60,12 @@ node dist/cli.js emit-spss examples/tam-bundle.json
 node dist/cli.js csv examples/tam-dataset.json
 ```
 
+The `examples/workflow-readiness-*.json` family is a second bundled
+demonstration. It uses four factors with 4/3/5/4 items, mixed 1–7 and 1–5
+scales, reverse-keyed items, and a formative factor. Every item is labelled
+`demonstration` and is explicitly not a published scale; the files contain no
+research citation or provenance claim.
+
 MCP stdio: `node dist/mcp.js` (`agentbiz-quant-mcp`). Tools are executable through `executeTool`, not documentation-only.
 
 Agent skill: copy `skills/quant-research/SKILL.md` into the target agent's skill directory, or use the installed package with `AGENTBIZ_QUANT_RESEARCH_ROOT` pointing at a clone. The skill is portable and does not assume the maintainer's filesystem path.

examples/reproducibility-manifest.json

@@ -32,6 +32,34 @@
     {
       "path": "examples/tam-topic-card.json",
       "sha256": "sha256:5ee4ca7bfc930c85fb9bbb7d956a5c13cb6b6c054c343d454ffe2f0619bea98a"
+    },
+    {
+      "path": "examples/workflow-readiness-bundle.json",
+      "sha256": "sha256:1b6ac30e2a10ce7ed9d8156a33ba2651e5d846717444f4f9c1267594c5ed0f79"
+    },
+    {
+      "path": "examples/workflow-readiness-dataset.json",
+      "sha256": "sha256:0b090fe711e3f8db109f466e8cdb54316e53a74b980bdab94d164039e86d9f2f"
+    },
+    {
+      "path": "examples/workflow-readiness-instrument.json",
+      "sha256": "sha256:259ac672182600d4e42a68a2484fd433bfcc43d52ace04ab571bb9e575c66bbf"
+    },
+    {
+      "path": "examples/workflow-readiness-measurement.json",
+      "sha256": "sha256:f1fd1084c8f4beb68d345576f82921440445953f9227635084ebe65941a065a6"
+    },
+    {
+      "path": "examples/workflow-readiness-observed.json",
+      "sha256": "sha256:a627201ca8d31f721b835ac46f4dcd489d283e318f570d8eca02da7522624db1"
+    },
+    {
+      "path": "examples/workflow-readiness-recode.json",
+      "sha256": "sha256:c276e99b1552aaddd83d0cda203b258185048dc3af656b2979ce6ffc9fedad91"
+    },
+    {
+      "path": "examples/workflow-readiness-topic-card.json",
+      "sha256": "sha256:2d4980adfed94d8dc1aac2ebe59283369687ae168d49f3a188c9d17b90a781e5"
     }
   ],
   "replays": [

examples/workflow-readiness-bundle.json

@@ -0,0 +1,111 @@
+{
+  "instrument": {
+    "schemaVersion": "agentbiz.instrument.v1",
+    "language": "en",
+    "constructs": [
+      {
+        "code": "WC",
+        "name": "Workflow clarity",
+        "kind": "reflective",
+        "scale": {
+          "min": 1,
+          "max": 7,
+          "anchors": [
+            { "value": 1, "label": "Strongly disagree" },
+            { "value": 4, "label": "Neither agree nor disagree" },
+            { "value": 7, "label": "Strongly agree" }
+          ]
+        },
+        "items": [
+          { "code": "WC1", "text": "The steps in this workflow are clear to me.", "status": "demonstration", "source": { "note": "Demonstration item only; not a published scale." } },
+          { "code": "WC2", "text": "I can tell what should happen next in this workflow.", "status": "demonstration", "source": { "note": "Demonstration item only; not a published scale." } },
+          { "code": "WC3", "text": "This workflow often leaves me unsure about the next step.", "reverse": true, "status": "demonstration", "source": { "note": "Demonstration reverse-keyed item only; not a published scale." } },
+          { "code": "WC4", "text": "The workflow makes task responsibilities easy to understand.", "status": "demonstration", "source": { "note": "Demonstration item only; not a published scale." } }
+        ]
+      },
+      {
+        "code": "DC",
+        "name": "Data confidence",
+        "kind": "reflective",
+        "scale": {
+          "min": 1,
+          "max": 5,
+          "anchors": [
+            { "value": 1, "label": "Strongly disagree" },
+            { "value": 3, "label": "Neither agree nor disagree" },
+            { "value": 5, "label": "Strongly agree" }
+          ]
+        },
+        "items": [
+          { "code": "DC1", "text": "I can find the information needed to complete a task.", "status": "demonstration", "source": { "note": "Demonstration item only; not a published scale." } },
+          { "code": "DC2", "text": "I often doubt whether the available information is reliable.", "reverse": true, "status": "demonstration", "source": { "note": "Demonstration reverse-keyed item only; not a published scale." } },
+          { "code": "DC3", "text": "The information available to me supports confident decisions.", "status": "demonstration", "source": { "note": "Demonstration item only; not a published scale." } }
+        ]
+      },
+      {
+        "code": "SR",
+        "name": "Support readiness",
+        "kind": "formative",
+        "scale": {
+          "min": 1,
+          "max": 7,
+          "anchors": [
+            { "value": 1, "label": "Strongly disagree" },
+            { "value": 4, "label": "Neither agree nor disagree" },
+            { "value": 7, "label": "Strongly agree" }
+          ]
+        },
+        "items": [
+          { "code": "SR1", "text": "Help is available when I encounter a workflow problem.", "status": "demonstration", "source": { "note": "Demonstration item only; not a published scale." } },
+          { "code": "SR2", "text": "Training materials cover the tasks I am expected to perform.", "status": "demonstration", "source": { "note": "Demonstration item only; not a published scale." } },
+          { "code": "SR3", "text": "Getting support for a workflow issue is difficult.", "reverse": true, "status": "demonstration", "source": { "note": "Demonstration reverse-keyed item only; not a published scale." } },
+          { "code": "SR4", "text": "The responsible team communicates changes clearly.", "status": "demonstration", "source": { "note": "Demonstration item only; not a published scale." } },
+          { "code": "SR5", "text": "I know where to report a recurring workflow problem.", "status": "demonstration", "source": { "note": "Demonstration item only; not a published scale." } }
+        ]
+      },
+      {
+        "code": "CI",
+        "name": "Continued-use intention",
+        "kind": "reflective",
+        "scale": {
+          "min": 1,
+          "max": 5,
+          "anchors": [
+            { "value": 1, "label": "Strongly disagree" },
+            { "value": 3, "label": "Neither agree nor disagree" },
+            { "value": 5, "label": "Strongly agree" }
+          ]
+        },
+        "items": [
+          { "code": "CI1", "text": "I expect to continue using this workflow.", "status": "demonstration", "source": { "note": "Demonstration item only; not a published scale." } },
+          { "code": "CI2", "text": "I would choose this workflow for similar tasks.", "status": "demonstration", "source": { "note": "Demonstration item only; not a published scale." } },
+          { "code": "CI3", "text": "Using this workflow is worth the effort.", "status": "demonstration", "source": { "note": "Demonstration item only; not a published scale." } },
+          { "code": "CI4", "text": "I would avoid using this workflow again when an alternative exists.", "reverse": true, "status": "demonstration", "source": { "note": "Demonstration reverse-keyed item only; not a published scale." } }
+        ]
+      }
+    ]
+  },
+  "topicCard": {
+    "schemaVersion": "agentbiz.topic-card.v1",
+    "question": "How are workflow clarity, data confidence, support readiness, and continued-use intention associated in this demonstration instrument?",
+    "claimClass": "association",
+    "population": "not specified; demonstration only",
+    "unit": "workflow user (demonstration record)",
+    "timeframe": "not specified",
+    "constructCodes": ["WC", "DC", "SR", "CI"],
+    "hypotheses": [
+      { "id": "H1", "from": "SR", "to": "WC", "sign": "+" },
+      { "id": "H2", "from": "DC", "to": "WC", "sign": "+" },
+      { "id": "H3", "from": "WC", "to": "CI", "sign": "+" },
+      { "id": "H4", "from": "DC", "to": "CI", "sign": "+" },
+      { "id": "H5", "from": "SR", "to": "CI", "sign": "+" }
+    ],
+    "engine": "smartpls",
+    "mode": "exploratory"
+  },
+  "measurement": {
+    "schemaVersion": "agentbiz.measurement.v1",
+    "mode": "pls-sem",
+    "engineOptions": { "estimator": "PLS" }
+  }
+}

examples/workflow-readiness-dataset.json

@@ -0,0 +1,30 @@
+{
+  "schemaVersion": "agentbiz.dataset.v1",
+  "columns": [
+    { "name": "id", "role": "id" },
+    { "name": "WC1", "role": "indicator", "itemCode": "WC1" },
+    { "name": "WC2", "role": "indicator", "itemCode": "WC2" },
+    { "name": "WC3", "role": "indicator", "itemCode": "WC3" },
+    { "name": "WC4", "role": "indicator", "itemCode": "WC4" },
+    { "name": "DC1", "role": "indicator", "itemCode": "DC1" },
+    { "name": "DC2", "role": "indicator", "itemCode": "DC2" },
+    { "name": "DC3", "role": "indicator", "itemCode": "DC3" },
+    { "name": "SR1", "role": "indicator", "itemCode": "SR1" },
+    { "name": "SR2", "role": "indicator", "itemCode": "SR2" },
+    { "name": "SR3", "role": "indicator", "itemCode": "SR3" },
+    { "name": "SR4", "role": "indicator", "itemCode": "SR4" },
+    { "name": "SR5", "role": "indicator", "itemCode": "SR5" },
+    { "name": "CI1", "role": "indicator", "itemCode": "CI1" },
+    { "name": "CI2", "role": "indicator", "itemCode": "CI2" },
+    { "name": "CI3", "role": "indicator", "itemCode": "CI3" },
+    { "name": "CI4", "role": "indicator", "itemCode": "CI4" },
+    { "name": "team", "role": "demographic" }
+  ],
+  "rowCount": 4,
+  "rows": [
+    { "id": "R01", "WC1": 4, "WC2": 4, "WC3": 4, "WC4": 4, "DC1": 4, "DC2": 4, "DC3": 4, "SR1": 4, "SR2": 4, "SR3": 4, "SR4": 4, "SR5": 4, "CI1": 4, "CI2": 4, "CI3": 4, "CI4": 4, "team": "A" },
+    { "id": "R02", "WC1": 6, "WC2": 5, "WC3": 2, "WC4": 6, "DC1": 5, "DC2": 2, "DC3": 4, "SR1": 5, "SR2": 6, "SR3": 2, "SR4": 5, "SR5": 6, "CI1": 5, "CI2": 4, "CI3": 4, "CI4": 2, "team": "B" },
+    { "id": "R03", "WC1": 3, "WC2": 4, "WC3": 5, "WC4": 3, "DC1": 3, "DC2": null, "DC3": 3, "SR1": 3, "SR2": 4, "SR3": 5, "SR4": 3, "SR5": 4, "CI1": 3, "CI2": 3, "CI3": 2, "CI4": 4, "team": "A" },
+    { "id": "R04", "WC1": 7, "WC2": 6, "WC3": 1, "WC4": 7, "DC1": 4, "DC2": 1, "DC3": 5, "SR1": 6, "SR2": 5, "SR3": 1, "SR4": 6, "SR5": 5, "CI1": 5, "CI2": 4, "CI3": 5, "CI4": 1, "team": "B" }
+  ]
+}

examples/workflow-readiness-instrument.json

@@ -0,0 +1,170 @@
+{
+  "schemaVersion": "agentbiz.instrument.v1",
+  "language": "en",
+  "constructs": [
+    {
+      "code": "WC",
+      "name": "Workflow clarity",
+      "kind": "reflective",
+      "scale": {
+        "min": 1,
+        "max": 7,
+        "anchors": [
+          { "value": 1, "label": "Strongly disagree" },
+          { "value": 4, "label": "Neither agree nor disagree" },
+          { "value": 7, "label": "Strongly agree" }
+        ]
+      },
+      "items": [
+        {
+          "code": "WC1",
+          "text": "The steps in this workflow are clear to me.",
+          "status": "demonstration",
+          "source": { "note": "Demonstration item only; not a published scale." }
+        },
+        {
+          "code": "WC2",
+          "text": "I can tell what should happen next in this workflow.",
+          "status": "demonstration",
+          "source": { "note": "Demonstration item only; not a published scale." }
+        },
+        {
+          "code": "WC3",
+          "text": "This workflow often leaves me unsure about the next step.",
+          "reverse": true,
+          "status": "demonstration",
+          "source": { "note": "Demonstration reverse-keyed item only; not a published scale." }
+        },
+        {
+          "code": "WC4",
+          "text": "The workflow makes task responsibilities easy to understand.",
+          "status": "demonstration",
+          "source": { "note": "Demonstration item only; not a published scale." }
+        }
+      ]
+    },
+    {
+      "code": "DC",
+      "name": "Data confidence",
+      "kind": "reflective",
+      "scale": {
+        "min": 1,
+        "max": 5,
+        "anchors": [
+          { "value": 1, "label": "Strongly disagree" },
+          { "value": 3, "label": "Neither agree nor disagree" },
+          { "value": 5, "label": "Strongly agree" }
+        ]
+      },
+      "items": [
+        {
+          "code": "DC1",
+          "text": "I can find the information needed to complete a task.",
+          "status": "demonstration",
+          "source": { "note": "Demonstration item only; not a published scale." }
+        },
+        {
+          "code": "DC2",
+          "text": "I often doubt whether the available information is reliable.",
+          "reverse": true,
+          "status": "demonstration",
+          "source": { "note": "Demonstration reverse-keyed item only; not a published scale." }
+        },
+        {
+          "code": "DC3",
+          "text": "The information available to me supports confident decisions.",
+          "status": "demonstration",
+          "source": { "note": "Demonstration item only; not a published scale." }
+        }
+      ]
+    },
+    {
+      "code": "SR",
+      "name": "Support readiness",
+      "kind": "formative",
+      "scale": {
+        "min": 1,
+        "max": 7,
+        "anchors": [
+          { "value": 1, "label": "Strongly disagree" },
+          { "value": 4, "label": "Neither agree nor disagree" },
+          { "value": 7, "label": "Strongly agree" }
+        ]
+      },
+      "items": [
+        {
+          "code": "SR1",
+          "text": "Help is available when I encounter a workflow problem.",
+          "status": "demonstration",
+          "source": { "note": "Demonstration item only; not a published scale." }
+        },
+        {
+          "code": "SR2",
+          "text": "Training materials cover the tasks I am expected to perform.",
+          "status": "demonstration",
+          "source": { "note": "Demonstration item only; not a published scale." }
+        },
+        {
+          "code": "SR3",
+          "text": "Getting support for a workflow issue is difficult.",
+          "reverse": true,
+          "status": "demonstration",
+          "source": { "note": "Demonstration reverse-keyed item only; not a published scale." }
+        },
+        {
+          "code": "SR4",
+          "text": "The responsible team communicates changes clearly.",
+          "status": "demonstration",
+          "source": { "note": "Demonstration item only; not a published scale." }
+        },
+        {
+          "code": "SR5",
+          "text": "I know where to report a recurring workflow problem.",
+          "status": "demonstration",
+          "source": { "note": "Demonstration item only; not a published scale." }
+        }
+      ]
+    },
+    {
+      "code": "CI",
+      "name": "Continued-use intention",
+      "kind": "reflective",
+      "scale": {
+        "min": 1,
+        "max": 5,
+        "anchors": [
+          { "value": 1, "label": "Strongly disagree" },
+          { "value": 3, "label": "Neither agree nor disagree" },
+          { "value": 5, "label": "Strongly agree" }
+        ]
+      },
+      "items": [
+        {
+          "code": "CI1",
+          "text": "I expect to continue using this workflow.",
+          "status": "demonstration",
+          "source": { "note": "Demonstration item only; not a published scale." }
+        },
+        {
+          "code": "CI2",
+          "text": "I would choose this workflow for similar tasks.",
+          "status": "demonstration",
+          "source": { "note": "Demonstration item only; not a published scale." }
+        },
+        {
+          "code": "CI3",
+          "text": "Using this workflow is worth the effort.",
+          "status": "demonstration",
+          "source": { "note": "Demonstration item only; not a published scale." }
+        },
+        {
+          "code": "CI4",
+          "text": "I would avoid using this workflow again when an alternative exists.",
+          "reverse": true,
+          "status": "demonstration",
+          "source": { "note": "Demonstration reverse-keyed item only; not a published scale." }
+        }
+      ]
+    }
+  ]
+}

examples/workflow-readiness-measurement.json

@@ -0,0 +1,5 @@
+{
+  "schemaVersion": "agentbiz.measurement.v1",
+  "mode": "pls-sem",
+  "engineOptions": { "estimator": "PLS" }
+}

examples/workflow-readiness-observed.json

@@ -0,0 +1,21 @@
+{
+  "schemaVersion": "agentbiz.gap-map.v1",
+  "observed": [
+    { "column": "WC1", "itemCode": "WC1", "constructCode": "WC", "reverse": false, "scale": { "min": 1, "max": 7 } },
+    { "column": "WC2", "itemCode": "WC2", "constructCode": "WC", "reverse": false, "scale": { "min": 1, "max": 7 } },
+    { "column": "WC3", "itemCode": "WC3", "constructCode": "WC", "reverse": true, "scale": { "min": 1, "max": 7 } },
+    { "column": "WC4", "itemCode": "WC4", "constructCode": "WC", "reverse": false, "scale": { "min": 1, "max": 7 } },
+    { "column": "DC1", "itemCode": "DC1", "constructCode": "DC", "reverse": false, "scale": { "min": 1, "max": 5 } },
+    { "column": "DC2", "itemCode": "DC2", "constructCode": "DC", "reverse": true, "scale": { "min": 1, "max": 5 } },
+    { "column": "DC3", "itemCode": "DC3", "constructCode": "DC", "reverse": false, "scale": { "min": 1, "max": 5 } },
+    { "column": "SR1", "itemCode": "SR1", "constructCode": "SR", "reverse": false, "scale": { "min": 1, "max": 7 } },
+    { "column": "SR2", "itemCode": "SR2", "constructCode": "SR", "reverse": false, "scale": { "min": 1, "max": 7 } },
+    { "column": "SR3", "itemCode": "SR3", "constructCode": "SR", "reverse": true, "scale": { "min": 1, "max": 7 } },
+    { "column": "SR4", "itemCode": "SR4", "constructCode": "SR", "reverse": false, "scale": { "min": 1, "max": 7 } },
+    { "column": "SR5", "itemCode": "SR5", "constructCode": "SR", "reverse": false, "scale": { "min": 1, "max": 7 } },
+    { "column": "CI1", "itemCode": "CI1", "constructCode": "CI", "reverse": false, "scale": { "min": 1, "max": 5 } },
+    { "column": "CI2", "itemCode": "CI2", "constructCode": "CI", "reverse": false, "scale": { "min": 1, "max": 5 } },
+    { "column": "CI3", "itemCode": "CI3", "constructCode": "CI", "reverse": false, "scale": { "min": 1, "max": 5 } },
+    { "column": "CI4", "itemCode": "CI4", "constructCode": "CI", "reverse": true, "scale": { "min": 1, "max": 5 } }
+  ]
+}