The communication bedrock of Agentic Network. All message exchanges between agents must strictly follow the JSON schema defined by this protocol. Any message that does not conform to the schema is invalid; the receiver must reject it and write to the error log.
"{type}-{task_id}-{unix_ms}"Format. Globally unique, used for ACK traceback."AMP/1.0". Refuse to process when the receiver version is incompatible.admin | coordinator | executor | reviewer | systemadmin | coordinator | executor | reviewer"T-YYYY-NNN"Format. Associate the corresponding task JSON file in SSOT."2026-02-26T14:32:07+00:00"requires_ack = truevalid. The default value is determined by the message type and can be overridden.typeDecision, see each message definition.// Every message must contain this shell { "msg_id": "task_dispatch-T-2026-044-1740576727001", "protocol_version": "AMP/1.0", "type": "task_dispatch", "from": "coordinator", "to": "executor", "task_id": "T-2026-044", "timestamp": "2026-02-26T14:32:07+00:00", "requires_ack": true, "ack_timeout_sec": 300, "context_ref": ["task_dispatch-T-2026-043-..."], "payload": { // See the definition of each message type // ... } }
"/Users/kircerta/dev/Rhylm". must exist.git。mainormaster. Executor should be verified before execution.subtask_id、description、estimated_lines。low | medium | high. Determines the approval path, the Executor must not modify this value.["delete CoreData entities", "modify Info.plist"]。{"swift_version": "6.0", "min_ios": "17.0", "target": "watchOS"}。{
"description": "Reconstruct watchOS breathing engine timing logic and fix timer exception when background hangs",
"repo": "/Users/kircerta/dev/Rhylm",
"branch": "feature/watch-breath-v2",
"subtasks": [
{
"subtask_id": "T-2026-044-S1",
"description": "Replace Timer with WKExtendedRuntimeSession",
"estimated_lines": 60
},
{
"subtask_id": "T-2026-044-S2",
"description": "Add applicationDidEnterBackground handling",
"estimated_lines": 30
}
],
"acceptance_criteria": [
"Resume after background suspension, timing error < 500ms",
"XCode Cloud all tests passed",
"No memory leak (Instruments verification)"
],
"risk_level": "medium",
"forbidden_actions": [
"Modify HealthKit permission statement"
],
"tech_constraints": {
"swift_version": "6.0",
"min_watchos": "10.0"
}
}
branch != "main"andbranch != "master", otherwise execution is refused and escalation is triggered.acceptance_criteriaArray must not be empty. If the Coordinator does not provide it, the Executor should refuse to receive it and ask the Coordinator to complete it.task_resultmessage said.subtask_id. Correlate accurately and prevent ambiguity.complete | partial | failed。partialIndicates that it is partially completed and the reason needs to be explained.files_changed（string[]）、lines_added（int）、lines_removed（int）。criteria_met(bool[]) andnotes（string[]）。timestamp、action、file、detail. For use by Reviewer and Audit.completion_status = partial | failedmust be provided. Describe the cause of the blocking, and the Coordinator will make decisions based on this.{
"subtask_id": "T-2026-044-S1",
"completion_status": "complete",
"diff_summary": {
"files_changed": [
"Sources/WatchApp/BreathEngine.swift",
"Sources/WatchApp/SessionManager.swift"
],
"lines_added": 68,
"lines_removed": 24
},
"self_assessment": {
"criteria_met": [true, null, null],
// null = Unable to self-verify, requires Reviewer/CI
"notes": [
"Timing error ~200ms has been restored in the simulator verification background",
"Waiting for XCode Cloud to build",
"Waiting for Instruments analysis"
]
},
"work_log": [
{
"timestamp": "2026-02-26T14:28:00Z",
"action": "replace_timer",
"file": "BreathEngine.swift",
"detail": "Timer.scheduledTimer replaced with WKExtendedRuntimeSession"
}
],
"commit_hash": "a3f8d21"
}
null, rather than guessingtrue. Reviewer will focus onnullitem.partialstateblockersField is required. After receiving it, the Coordinator decides whether to re-dispatch or escalate.msg_id. Reviewer gets acceptance_criteria accordingly.msg_id. Reviewer obtains diff_summary and self_assessment accordingly.full | incremental。incrementalOnly new diffs since the last verdict are reviewed.{"xcode_cloud": "passed", "codex_review": "running"}。{
"original_dispatch_ref": "task_dispatch-T-2026-044-...",
"task_result_ref": "task_result-T-2026-044-...",
"review_scope": "full",
"diff_url": "https://github.com/.../compare/main...feature/watch-breath-v2",
"reject_count": 0,
"coordinator_notes": "Please focus on checking the life cycle management of WKExtendedRuntimeSession in the background",
"ci_status": {
"xcode_cloud": "passed",
"codex_review": "running",
"last_updated": "2026-02-26T14:30:00Z"
}
}
original_dispatch_refandtask_result_refThe pointed message is readable in SSOT, otherwise Reviewer cannot conduct effective review.reject_count >= 2When , the Coordinator should becoordinator_notesIt is clearly marked "Lock is approaching" to remind the Reviewer that it is currently in a high-risk iteration.ci_status.xcode_cloud = "failed", the Coordinator should not send review_request, but should directly initiate a new task_dispatch (to fix CI errors) to the Executor.approved | approved_with_fix | rejected。approved_with_fixIndicates that the minor issues have been fixed directly by the Reviewer.criterion、passed（bool）、evidence（string）。decision = rejectedmust be provided. Each issue containsseverity、file、line、description、suggested_fix。decision = approved_with_fixprovided at time. Record the content directly repaired by Reviewer, includingfile、change_type(only typo/lint/whitespace/import allowed),diff_lines(must <5).{
"decision": "rejected",
"criteria_results": [
{
"criterion": "Background recovery timing error < 500ms",
"passed": false,
"evidence": "WKExtendedRuntimeSession is not processed applicationDidBecomeActive, and the timing will start from the beginning after recovery"
},
{
"criterion": "XCode Cloud all tests passed",
"passed": null,
"evidence": "CI is still running"
}
],
"issues": [
{
"severity": "critical",
"file": "Sources/WatchApp/BreathEngine.swift",
"line": 87,
"description": "No session reference is held after session.start() is called, and ARC will recycle it immediately",
"suggested_fix": "Save session as class property and call session.invalidate() in deinit"
}
],
"architecture_notes": "It is recommended to separate the timing logic into an independent TimeKeeper actor in the future to improve testability",
"confidence": 0.95
}
change_typeMust be one of typo / lint / whitespace / import_order, anddiff_lines < 5. Out of range must be rejected.confidence < 0.8When , the Coordinator should report to the Admin before forwarding it to the Executor, and then decide whether to continue the QA Loop.critical(Must be repaired, blocking),major(Should be repaired, blocking),minor(Recommended fix, non-blocking).hallucination_lock | ack_timeout | branch_violation | ci_failure | conflict | heartbeat_timeout | permission_denied | unknowncritical | warning | info。criticalAll related Agents should immediately suspend waiting for Admin instructions.coordinator | executor | reviewer | system. Identify the source of responsibility.task_status、reject_count、last_successful_msg_id。["Reissue the revised task", "Roll back to checkpoint-xxx", "Terminate the current task"]。trueIndicates that the triggering party has suspended the operation waiting for Admin.falseIndicates that the system continues to run (info level only).{
"escalation_type": "hallucination_lock",
"severity": "critical",
"triggered_by": "coordinator",
"description": "T-2026-044 Hallucination Lock has been triggered: The Executor was called back by the Reviewer three times in a row, and the same logic error occurred repeatedly (WKExtendedRuntimeSession ARC problem). The system has been suspended, waiting for Admin's decision.",
"affected_msgs": [
"task_dispatch-T-2026-044-001",
"review_verdict-T-2026-044-003"
],
"system_state_snapshot": {
"task_status": "locked",
"reject_count": 3,
"last_successful_msg_id": "task_dispatch-T-2026-044-001"
},
"suggested_actions": [
"Admin directly reviews the diff and gives specific code modification guidance",
"Split the task into smaller subtasks and re-issue them",
"Roll back to checkpoint and terminate the current task branch"
],
"auto_suspended": true
}
// —— escalation_type reference ——
// hallucination_lock reject_count > 3, systemic problem
// ack_timeout Agent does not ACK within timeout
// branch_violation Executor tries to operate the main branch
// ci_failure XCode Cloud/Codex build failed
// heartbeat_timeout Agent 30min no SSOT write
// conflict Reviewer and Executor cannot be reconciled
// permission_denied operation exceeds risk_level authorization scope
severity = critical, all related agents must immediately suspend (auto_suspended = true) and must not perform any new operations until Admin issues a resume instruction via Dashboard or Telegram.suggested_actions are recommendations, not commands. Admin may ignore all recommendations and choose a completely different response. The sender must not assume Admin will adopt them.