Execution Slice

OVERVIEW

A bounded, execution-ready change derived from a Reconciliation and tied to the Plan revision and repository state that justified it.

Canonical type ExecutionSlice
References Plan revision, Outcome, Reconciliation, Acceptance Criteria, repository provenance

STRUCTURE

The raw JSON Schema is the machine contract for this resource. The field reference below is derived from that schema.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://orbitspec.dev/schema/execution-slice/v0.1.json",
  "title": "ORBIT Execution Slice",
  "type": "object",
  "required": [
    "specVersion",
    "id",
    "planId",
    "outcomeId",
    "basedOn",
    "objective",
    "why",
    "contributesTo",
    "scope"
  ],
  "properties": {
    "specVersion": {
      "const": "0.1",
      "description": "ORBIT specification version."
    },
    "id": {
      "type": "string",
      "description": "Stable ExecutionSlice identifier."
    },
    "planId": {
      "type": "string",
      "description": "Referenced Plan identifier."
    },
    "outcomeId": {
      "type": "string",
      "description": "Referenced Outcome identifier."
    },
    "basedOn": {
      "type": "object",
      "required": [
        "planRevision",
        "reconciliationId",
        "repositories"
      ],
      "properties": {
        "planRevision": {
          "type": "integer",
          "minimum": 1,
          "description": "Plan revision used for reconciliation."
        },
        "reconciliationId": {
          "type": "string",
          "description": "Reconciliation that justified the slice."
        },
        "repositories": {
          "type": "object",
          "description": "Repository revisions used as evidence."
        }
      },
      "additionalProperties": false,
      "description": "Provenance for the slice."
    },
    "objective": {
      "type": "string",
      "description": "Bounded change objective."
    },
    "why": {
      "type": "string",
      "description": "Reason the change is justified."
    },
    "contributesTo": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Acceptance Criteria advanced by the slice."
    },
    "scope": {
      "type": "object",
      "required": [
        "include",
        "exclude"
      ],
      "properties": {
        "include": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Included work."
        },
        "exclude": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Excluded work."
        }
      },
      "additionalProperties": false,
      "description": "Explicit change boundary."
    }
  },
  "additionalProperties": false
}

FIELD REFERENCE

RELATIONSHIPS

INVARIANTS

JSON Schema validates structure. These semantic rules explain what a structurally valid ExecutionSlice must mean in the ORBIT model.

• basedOn.planRevision identifies the Plan revision used during reconciliation.
• basedOn.reconciliationId identifies the Reconciliation that justified the slice.
• contributesTo references Acceptance Criteria in the referenced Plan revision.
• Repository provenance identifies the state against which the slice was justified.
• If relevant Plan or repository provenance changes before execution, the slice is stale and must be reconciled again.

EXAMPLES

RAW SCHEMA

RELATED RESOURCES