← ALL EXAMPLES

Research a question

Plan several research angles, gather evidence, and resolve the gaps before writing. These fixtures show actual control flow, not live model quality.

Recorded interpreter run · scripted model responses
OUTCOME / COMPLETE
{
  "summary": "Five research angles were explored against illustrative records. Relevant evidence was retained; one useful gap was selected for follow-up. This is a workflow demonstration, not an answer to a substantive research question.",
  "findings": [
    {
      "label": "D1",
      "detail": "Illustrative source for the origins angle of a research question; this is a fixture, not a substantive answer.",
      "sourceIds": [
        "D1"
      ]
    },
    {
      "label": "D2",
      "detail": "Illustrative source for the evidence angle of a research question; this is a fixture, not a substantive answer.",
      "sourceIds": [
        "D2"
      ]
    },
    {
      "label": "D3",
      "detail": "Illustrative source for the alternatives angle of a research question; this is a fixture, not a substantive answer.",
      "sourceIds": [
        "D3"
      ]
    },
    {
      "label": "D4",
      "detail": "Illustrative source for the limitations angle of a research question; this is a fixture, not a substantive answer.",
      "sourceIds": [
        "D4"
      ]
    },
    {
      "label": "D5",
      "detail": "Illustrative follow-up record addressing the previously open angle; no real research conclusion is claimed.",
      "sourceIds": [
        "D5"
      ]
    }
  ],
  "uncertainties": []
}

research-planner

INPUT
{
  "question": "A research question"
}
OUTPUT
{
  "questions": [
    {
      "angle": "origins",
      "question": "What does the supplied material establish about origins for: A research question?"
    },
    {
      "angle": "evidence",
      "question": "What does the supplied material establish about evidence for: A research question?"
    },
    {
      "angle": "alternatives",
      "question": "What does the supplied material establish about alternatives for: A research question?"
    },
    {
      "angle": "limitations",
      "question": "What does the supplied material establish about limitations for: A research question?"
    },
    {
      "angle": "open questions",
      "question": "What does the supplied material establish about open questions for: A research question?"
    }
  ]
}
View execution events (28)
[
  {
    "type": "node.start",
    "label": "research-planner",
    "detail": {
      "kind": "decide"
    },
    "executionPath": "/root/steps/0"
  },
  {
    "type": "node.end",
    "label": "research-planner",
    "detail": {
      "kind": "decide",
      "status": "ok"
    },
    "executionPath": "/root/steps/0"
  },
  {
    "type": "node.start",
    "label": "research-angle",
    "detail": {
      "kind": "agent"
    },
    "executionPath": "/root/steps/1/items/0/body"
  },
  {
    "type": "node.start",
    "label": "research-angle",
    "detail": {
      "kind": "agent"
    },
    "executionPath": "/root/steps/1/items/1/body"
  },
  {
    "type": "node.start",
    "label": "research-angle",
    "detail": {
      "kind": "agent"
    },
    "executionPath": "/root/steps/1/items/2/body"
  },
  {
    "type": "node.end",
    "label": "research-angle",
    "detail": {
      "kind": "agent",
      "status": "ok"
    },
    "executionPath": "/root/steps/1/items/0/body"
  },
  {
    "type": "node.end",
    "label": "research-angle",
    "detail": {
      "kind": "agent",
      "status": "ok"
    },
    "executionPath": "/root/steps/1/items/1/body"
  },
  {
    "type": "node.end",
    "label": "research-angle",
    "detail": {
      "kind": "agent",
      "status": "ok"
    },
    "executionPath": "/root/steps/1/items/2/body"
  },
  {
    "type": "node.start",
    "label": "research-angle",
    "detail": {
      "kind": "agent"
    },
    "executionPath": "/root/steps/1/items/3/body"
  },
  {
    "type": "node.start",
    "label": "research-angle",
    "detail": {
      "kind": "agent"
    },
    "executionPath": "/root/steps/1/items/4/body"
  },
  {
    "type": "node.end",
    "label": "research-angle",
    "detail": {
      "kind": "agent",
      "status": "ok"
    },
    "executionPath": "/root/steps/1/items/3/body"
  },
  {
    "type": "node.end",
    "label": "research-angle",
    "detail": {
      "kind": "agent",
      "status": "ok"
    },
    "executionPath": "/root/steps/1/items/4/body"
  },
  {
    "type": "node.start",
    "label": "collect-research",
    "detail": {
      "kind": "code"
    },
    "executionPath": "/root/steps/2"
  },
  {
    "type": "code.patch",
    "label": "collect-research",
    "detail": {
      "rawEvidence": [
        {
          "id": "D1",
          "angle": "origins",
          "phase": "initial",
          "relevant": true,
          "text": "Illustrative source for the origins angle of a research question; this is a fixture, not a substantive answer."
        },
        {
          "id": "D2",
          "angle": "evidence",
          "phase": "initial",
          "relevant": true,
          "text": "Illustrative source for the evidence angle of a research question; this is a fixture, not a substantive answer."
        },
        {
          "id": "D-noise",
          "angle": "evidence",
          "phase": "initial",
          "relevant": false,
          "text": "An unrelated promotional announcement with no evidence for this research question."
        },
        {
          "id": "D3",
          "angle": "alternatives",
          "phase": "initial",
          "relevant": true,
          "text": "Illustrative source for the alternatives angle of a research question; this is a fixture, not a substantive answer."
        },
        {
          "id": "D4",
          "angle": "limitations",
          "phase": "initial",
          "relevant": true,
          "text": "Illustrative source for the limitations angle of a research question; this is a fixture, not a substantive answer."
        }
      ],
      "gaps": [
        {
          "angle": "open questions",
          "question": "What does the supplied material establish about open questions for: A research question?"
        }
      ]
    },
    "executionPath": "/root/steps/2"
  },
  {
    "type": "node.end",
    "label": "collect-research",
    "detail": {
      "kind": "code",
      "status": "ok"
    },
    "executionPath": "/root/steps/2"
  },
  {
    "type": "node.start",
    "label": "sift-evidence",
    "detail": {
      "kind": "sift"
    },
    "executionPath": "/root/steps/3"
  },
  {
    "type": "judge.answered",
    "label": "sift-evidence",
    "detail": {
      "kind": "sift",
      "as": "usefulEvidence",
      "value": {
        "items": [
          {
            "id": "D1",
            "angle": "origins",
            "phase": "initial",
            "relevant": true,
            "text": "Illustrative source for the origins angle of a research question; this is a fixture, not a substantive answer."
          },
          {
            "id": "D2",
            "angle": "evidence",
            "phase": "initial",
            "relevant": true,
            "text": "Illustrative source for the evidence angle of a research question; this is a fixture, not a substantive answer."
          },
          {
            "id": "D3",
            "angle": "alternatives",
            "phase": "initial",
            "relevant": true,
            "text": "Illustrative source for the alternatives angle of a research question; this is a fixture, not a substantive answer."
          },
          {
            "id": "D4",
            "angle": "limitations",
            "phase": "initial",
            "relevant": true,
            "text": "Illustrative source for the limitations angle of a research question; this is a fixture, not a substantive answer."
          }
        ],
        "values": [
          {
            "useful": true
          },
          {
            "useful": true
          },
          {
            "useful": false
          },
          {
            "useful": true
          },
          {
            "useful": true
          }
        ],
        "answers": [
          {
            "answers": {
              "useful": {
                "type": "noul",
                "noul": 1
              }
            },
            "confidence": {
              "useful": 1
            },
            "weakest": "useful",
            "min_confidence": 1
          },
          {
            "answers": {
              "useful": {
                "type": "noul",
                "noul": 1
              }
            },
            "confidence": {
              "useful": 1
            },
            "weakest": "useful",
            "min_confidence": 1
          },
          {
            "answers": {
              "useful": {
                "type": "noul",
                "noul": 0
              }
            },
            "confidence": {
              "useful": 1
            },
            "weakest": "useful",
            "min_confidence": 1
          },
          {
            "answers": {
              "useful": {
                "type": "noul",
                "noul": 1
              }
            },
            "confidence": {
              "useful": 1
            },
            "weakest": "useful",
            "min_confidence": 1
          },
          {
            "answers": {
              "useful": {
                "type": "noul",
                "noul": 1
              }
            },
            "confidence": {
              "useful": 1
            },
            "weakest": "useful",
            "min_confidence": 1
          }
        ],
        "kept": [
          0,
          1,
          3,
          4
        ]
      },
      "count": 5,
      "kept": 4,
      "model": null,
      "cost_usd": null
    },
    "executionPath": "/root/steps/3"
  },
  {
    "type": "node.end",
    "label": "sift-evidence",
    "detail": {
      "kind": "sift",
      "status": "ok"
    },
    "executionPath": "/root/steps/3"
  },
  {
    "type": "node.start",
    "label": "pick-followup",
    "detail": {
      "kind": "pick"
    },
    "executionPath": "/root/steps/4"
  },
  {
    "type": "judge.answered",
    "label": "pick-followup",
    "detail": {
      "kind": "pick",
      "as": "followupChoice",
      "value": {
        "index": 0,
        "item": {
          "angle": "open questions",
          "question": "What does the supplied material establish about open questions for: A research question?"
        },
        "none": false,
        "option": "What does the supplied material establish about open questions for: A research question?"
      },
      "sidecar": {
        "answers": {
          "pick": {
            "type": "choice",
            "choice": "item_0",
            "confidence": 1,
            "probabilities": {
              "item_0": 1,
              "none_of_these": 0
            }
          }
        },
        "confidence": {
          "pick": 1
        },
        "weakest": "pick",
        "min_confidence": 1
      },
      "model": null,
      "cost_usd": null
    },
    "executionPath": "/root/steps/4"
  },
  {
    "type": "node.end",
    "label": "pick-followup",
    "detail": {
      "kind": "pick",
      "status": "ok"
    },
    "executionPath": "/root/steps/4"
  },
  {
    "type": "node.start",
    "label": "followup-gate",
    "detail": {
      "kind": "code"
    },
    "executionPath": "/root/steps/5"
  },
  {
    "type": "code.patch",
    "label": "followup-gate",
    "detail": {
      "followupQueue": [
        {
          "angle": "open questions",
          "question": "What does the supplied material establish about open questions for: A research question?"
        }
      ]
    },
    "executionPath": "/root/steps/5"
  },
  {
    "type": "node.end",
    "label": "followup-gate",
    "detail": {
      "kind": "code",
      "status": "ok"
    },
    "executionPath": "/root/steps/5"
  },
  {
    "type": "node.start",
    "label": "followup-research",
    "detail": {
      "kind": "agent"
    },
    "executionPath": "/root/steps/6/items/0/body"
  },
  {
    "type": "node.end",
    "label": "followup-research",
    "detail": {
      "kind": "agent",
      "status": "ok"
    },
    "executionPath": "/root/steps/6/items/0/body"
  },
  {
    "type": "node.start",
    "label": "consolidate-report",
    "detail": {
      "kind": "agent"
    },
    "executionPath": "/root/steps/7"
  },
  {
    "type": "node.end",
    "label": "consolidate-report",
    "detail": {
      "kind": "agent",
      "status": "ok"
    },
    "executionPath": "/root/steps/7"
  }
]
Complete source ↗Workflow definitions (JSON) ↗Recorded inputs, outputs, and events ↗