Example: JSON Schema

1{
2  "ref": "handoff-package",
3  "kind": "json-schema",
4  "outputContract": {
5    "title": "Handoff Package",
6    "mode": "workspace-files",
7    "targetSlot": { "kind": "deliverables" },
8    "files": [
9      {
10        "canonicalPath": "handoff.json",
11        "required": true,
12        "purpose": "Structured handoff with change units, problem landscape, and constraints.",
13        "contentKind": "json"
14      }
15    ]
16  },
17  "contentSchema": {
18    "type": "object",
19    "required": ["changeUnits", "problemLandscape"],
20    "properties": {
21      "changeUnits": {
22        "type": "array",
23        "items": {
24          "type": "object",
25          "required": ["id", "title"],
26          "properties": {
27            "id": { "type": "string" },
28            "title": { "type": "string" }
29          }
30        }
31      },
32      "problemLandscape": { "type": "string" }
33    }
34  }
35}

1apiVersion: xema.dev/workflow/v1alpha1
2kind: Workflow
3metadata:
4  name: json-schema-example
5  version: 1.0.0
6on:
7  workflow_dispatch:
8    inputs:
9      request:
10        type: string
11        required: true
12permissions:
13  artifacts: write
14jobs:
15  clarify:
16    title: Clarify request and emit handoff package
17    uses: xema/agent
18    with:
19      agentRef: clarification-coordinator
20      stageKey: clarification
21      deliverableSpecRef: handoff-package
22      agentSession: true
23      agentContext:
24        prompt: ${{ inputs.request }}
25    outputs:
26      changeUnits: ${{ job.outputs.deliverable.content.value.changeUnits }}
27      handoffPackage: ${{ job.outputs.deliverable.content.value }}
28      problemLandscape: ${{ job.outputs.deliverable.content.value.problemLandscape }}
29
30  per-cu:
31    needs: [clarify]
32    strategy:
33      dynamic:
34        from: ${{ needs.clarify.outputs.changeUnits }}
35        as: changeUnit
36        keyBy: id
37        maxEntries: 32
38    uses: xema/agent
39    with:
40      agentRef: requirements
41      stageKey: requirements
42      changeUnitId: ${{ matrix.changeUnit.id }}
43      deliverableSpecRef: requirements-standard
44      agentSession: false
45      agentContext:
46        changeUnit: ${{ matrix.changeUnit }}
47        handoffPackage: ${{ needs.clarify.outputs.handoffPackage }}

1// Producing job (clarify)
2agentResult: {
3  deliverable: {
4    specRef: 'handoff-package',
5    kind: 'json-schema',
6    targetSlot: { kind: 'deliverables' },
7    content: {
8      kind: 'json',
9      artifactId: 'art-1',
10      versionId: 'ver-1',
11      version: 1,
12      value: {
13        changeUnits: [
14          { id: 'cu-1', title: 'Auth migration' },
15          { id: 'cu-2', title: 'Billing rework' },
16        ],
17        problemLandscape: 'Legacy SSO blocks SaaS rollout...',
18      },
19    },
20  },
21}