Skip to main content

Turns and Commits

T3X separates source evidence from reviewed structured state.

Turns​

A turn is one source event: a message, assistant response, tool result, pasted note, imported document, or other piece of source material. Turns preserve provenance so committed state can trace back to evidence.

Commits​

A commit is a reviewed checkpoint of structured state:

{
  "schema": "t3x/commit",
  "parents": ["sha256:..."],
  "content": {
    "trees": []
  },
  "operations": {
    "yops": []
  },
  "provenance": {
    "sources": []
  }
}

The hash covers the committed state and commit metadata that define the checkpoint. The same reviewed content produces the same commit identity.

Practical habit​

Use turns as evidence. Use YOps as the reviewed change. Use commits as durable state checkpoints.