Files
Jonathan Boniface 8bb62a4a42 ALZ-F01 Discovery sub-agent pattern: report phase and fetch in code
Orchestrator report phase (ADR 0013) and fetching in code (ADR 0014), with the report renderer.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 22:13:25 +00:00

159 lines
3.5 KiB
JSON

{
"type": "object",
"title": "The outcome of one discovery phase",
"additionalProperties": false,
"properties": {
"engagement_id": {
"type": "string"
},
"run_id": {
"type": "string"
},
"phase": {
"type": "string",
"enum": [
"plan",
"collect",
"analyse",
"critique",
"report"
]
},
"status": {
"type": "string",
"enum": [
"completed",
"completed_with_gaps",
"halted",
"failed"
],
"description": "completed only when the phase's checks passed. A critique whose verdict is not pass is never completed."
},
"artifacts": {
"type": "array",
"description": "What this phase stored in the run workspace, as recorded by the workspace itself (post_process replaces the model's list with the manifest).",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"ref": {
"type": "string",
"description": "Workspace reference: <phase>/<name>."
},
"sha256": {
"type": "string"
},
"produced_by": {
"type": "string",
"description": "orchestrator, or the sub-agent whose reply this is."
}
},
"required": [
"name",
"ref",
"sha256",
"produced_by"
]
}
},
"summary": {
"type": "string",
"maxLength": 800,
"description": "Three sentences at most, for the engagement lead."
},
"issues": {
"type": "array",
"items": {
"type": "string"
},
"description": "Anything that stopped or weakened the phase: refused calls, failed sub-agents, failed checks, declared gaps."
},
"next_phase": {
"type": [
"string",
"null"
],
"enum": [
"collect",
"analyse",
"critique",
"report",
null
]
},
"verdict": {
"type": [
"object",
"null"
],
"description": "critique only: the verdict as enforced by post_process, not as the model wrote it.",
"additionalProperties": false,
"properties": {
"verdict": {
"type": "string",
"enum": [
"pass",
"fail"
]
},
"coverage_complete": {
"type": "boolean"
},
"coverage_gaps": {
"type": "array",
"items": {
"type": "string"
}
},
"declared_gaps": {
"type": "array",
"items": {
"type": "string"
}
},
"reasons": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"verdict",
"coverage_complete",
"coverage_gaps",
"declared_gaps",
"reasons"
]
},
"manifest_head": {
"type": "string",
"description": "Hash at the head of the run's workspace manifest after this phase; each entry is chained to the one before it."
},
"report_markdown": {
"type": "string"
},
"report_html": {
"type": "string"
},
"report_data": {
"type": "object"
}
},
"required": [
"engagement_id",
"run_id",
"phase",
"status",
"artifacts",
"summary",
"issues",
"next_phase",
"verdict",
"manifest_head"
]
}