Plan
Minimal Plan
Schema-valid JSON for the Plan resource.
Plan · ORBIT v0.1
Plan
Plan
Durable planning intent and desired outcomes.
OVERVIEW
A durable declaration of intent, outcomes, acceptance criteria, and the planning context that should survive execution cycles.
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/plan/v0.1.json",
"title": "ORBIT Plan",
"type": "object",
"additionalProperties": false,
"required": [
"specVersion",
"id",
"revision",
"project",
"title",
"intent",
"outcomes",
"acceptanceCriteria"
],
"properties": {
"specVersion": {
"const": "0.1",
"description": "ORBIT specification version."
},
"id": {
"type": "string",
"minLength": 1,
"description": "Stable Plan identifier."
},
"revision": {
"type": "integer",
"minimum": 1,
"description": "Plan revision number."
},
"project": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Stable project identifier."
}
},
"additionalProperties": false,
"description": "Project identity associated with the Plan."
},
"title": {
"type": "string",
"minLength": 1,
"description": "Human-readable Plan title."
},
"intent": {
"type": "string",
"minLength": 1,
"description": "Durable planning intent."
},
"outcomes": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title"
],
"properties": {
"id": {
"type": "string",
"description": "Stable Outcome identifier."
},
"title": {
"type": "string",
"description": "Outcome title."
},
"intent": {
"type": "string",
"description": "Outcome intent."
}
},
"additionalProperties": false
},
"description": "Desired outcomes within the Plan."
},
"acceptanceCriteria": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"outcomeId",
"statement"
],
"properties": {
"id": {
"type": "string",
"description": "Stable Acceptance Criterion identifier."
},
"outcomeId": {
"type": "string",
"description": "Outcome assessed by the criterion."
},
"statement": {
"type": "string",
"minLength": 1,
"description": "Canonical acceptance-criterion wording."
}
},
"additionalProperties": false
},
"description": "Stable checks for desired outcomes."
}
}
}FIELD REFERENCE
| Field | Type | Required | Meaning | Constraints |
|---|---|---|---|---|
specVersion | const "0.1" | yes | ORBIT specification version. | must equal "0.1" |
id | string | yes | Stable Plan identifier. | minLength 1 |
revision | integer | yes | Plan revision number. | minimum 1 |
project | object | yes | Project identity associated with the Plan. | — |
project.id | string | yes | Stable project identifier. | minLength 1 |
title | string | yes | Human-readable Plan title. | minLength 1 |
intent | string | yes | Durable planning intent. | minLength 1 |
outcomes | array<object> | yes | Desired outcomes within the Plan. | — |
outcomes[].id | string | yes | Stable Outcome identifier. | — |
outcomes[].title | string | yes | Outcome title. | — |
outcomes[].intent | string | optional | Outcome intent. | — |
acceptanceCriteria | array<object> | yes | Stable checks for desired outcomes. | — |
acceptanceCriteria[].id | string | yes | Stable Acceptance Criterion identifier. | — |
acceptanceCriteria[].outcomeId | string | yes | Outcome assessed by the criterion. | — |
acceptanceCriteria[].statement | string | yes | Canonical acceptance-criterion wording. | minLength 1 |
RELATIONSHIPS
| Resource | Reference | Meaning |
|---|---|---|
| Project | project.id | Identifies the project whose durable intent this Plan describes. |
| Outcomes | outcomes[].id | Groups one or more desired results within the Plan. |
| Acceptance Criteria | acceptanceCriteria[].id | Names stable checks that determine whether an Outcome is achieved. |
INVARIANTS
JSON Schema validates structure. These semantic rules explain what a structurally valid Plan must mean in the ORBIT model.
- A Plan revision identifies the version of durable intent assessed by later records.
- Acceptance Criteria retain stable IDs within the Plan revision that defines them.
- Each Acceptance Criterion references an Outcome in the same Plan.
EXAMPLES
Plan
Complete Plan
Schema-valid JSON for the Plan resource.
RAW SCHEMA
The canonical machine-readable contract is available at /schema/plan.schema.json.
Use it for tooling, CI validation, and agent integrations. The human guide explains semantics; the schema defines structural conformance.