CinvanaAI
← All projects

Experiment · Workflows & capabilities

Builder Prototypes

Follow an early builder experiment from a request to a prompt and a chain of registered steps.

Repository: CinvanaAI/builder-prototypes

Explore the repository ↗Try or inspect it ↓

Recorded synthetic example. An executable experiment using supplied synthetic inputs.

See the idea in action.

An inspectable queued request, an ordered prompt, a measured prompt length, and a failed result naming the unregistered step.

Example input
Describe the files for a tiny greeting project.
Captured result
{
  "queued_file": "20260101T000000Z_example_describe_demo.json",
  "intake": {
    "fields": {
      "assignment": "Describe the required files.",
      "summary": "A tiny offline project with one greeting function."
    },
    "project_name": "greeting",
    "task_type": "describe",
    "user": "example"
  },
  "prompt": "## System summary\nA tiny offline project with one greeting function.\n\n## Assignment\nDescribe the required files.",
  "execution": {
    "status": "complete",
    "payload": {
      "prompt": "## System summary\nA tiny offline project with one greeting function.\n\n## Assignment\nDescribe the required files.",
      "measurement": {
        "characters": 112
      },
      "summary": {
        "measured": 112,
        "summary": "Measurement: {\"characters\": 112}"
      }
    },
    "context": {},
    "evidence": [
      {
        "index": 0,
        "step": "measure",
        "status": "complete",
        "output_type": "dict",
        "output_bytes": 19,
        "error_type": null,
        "error_message": null
      },
      {
        "index": 1,
        "step": "summarize",
        "status": "complete",
        "output_type": "dict",
        "output_bytes": 66,
        "error_type": null,
        "error_message": null
      }
    ]
  },
  "unknown_step": {
    "status": "failed",
    "payload": {},
    "context": {},
    "evidence": [
      {
        "index": 0,
        "step": "unregistered",
        "status": "failed",
        "output_type": null,
        "output_bytes": null,
        "error_type": "KeyError",
        "error_message": "'unregistered step: unregistered'"
      }
    ]
  }
}

Try the example.

From the repository root, follow the dependency requirements in the README. This example uses supplied synthetic material.

python -m pip install -e .
python -m examples.walkthrough

An inspectable queued request, an ordered prompt, a measured prompt length, and a failed result naming the unregistered step.

Complete setup and instructions ↗

The interesting part.

Explicit step registration replaces ambient imports; evidence records bounded type/size/status instead of indiscriminate payloads.

Public continuation

Where it came from.

The spine and telephone ideas from a June 2025 Builder experiment.

June 2025 — Historical Builder spine/telephone experiment; not the public continuation publication date. Source ↗

Reimplements the authored orchestration ideas with explicit boundaries; the raw mixed-provenance working tree is not copied.

Executable representatives of the older ideas, not the complete historical Builder.

Source ↗

Follow the family: Builder, Factory and the Python Foundry