docs/CODEX_COMMUNICATION_PROTOCOL.md

CODEX KOMMUNIKATIONSPROTOKOL

Agent-til-Agent Kommunikation i WidgeTDC

FIRE KOMMUNIKATIONSKANALER

1. Neural Chat (Real-time)
2. Agent Messages (Async Inbox)
3. DropZone (File-based Handovers)
4. Neo4j Oracelet (Shared Knowledge)

---

1. NEURAL CHAT (Real-time)

Kanaler

• core-dev: Hovedudviklingskanal
• standup: Status updates
• alerts: Kritiske advarsler

Send Besked

Tool: widgetdc-neural-bridge:neural_chat_send

Parametre:

• channel: "core-dev" | "standup" | "alerts"
• from: "codex" | "claude" | "gemini" | "deepseek" | "clak"
• body: "Din besked"
• type: "chat" | "task" | "status" | "alert" | "handover"
• priority: "low" | "normal" | "high" | "critical"

Læs Beskeder

Tool: widgetdc-neural-bridge:neural_chat_read

Parametre:

• channel: (optional) specifik kanal
• limit: antal beskeder (default: 20)
• since: ISO timestamp

Eksempel - Send task til Claude

channel: "core-dev" from: "codex" body: "Claude: Søg efter mockData i apps/frontend/src/widgets/" type: "task" priority: "high"

---

2. AGENT MESSAGES (Async Inbox)

Send til Agent

Tool: widgetdc-neural-bridge:send_agent_message

Parametre:

• to: "claude" | "gemini" | "human"
• subject: "Emne"
• body: "Detaljeret besked"
• type: "task" | "question" | "status" | "alert"
• priority: "low" | "normal" | "high" | "critical"

Læs Inbox

Tool: widgetdc-neural-bridge:read_agent_messages

Parametre:

• agent: "claude" | "gemini"
• unreadOnly: true | false

---

3. DROPZONE (File-based Handovers)

Lokation

C:\Users\claus\Projects\WidgeTDC\WidgeTDC\apps\backend\dropzone\

Filnavn Format

HANDOVER_[FROM]TO[TO]_[TIMESTAMP].json

MCP Tools

• widgetdc-neural-bridge:list_dropzone_files
• widgetdc-neural-bridge:read_dropzone_file

---

4. NEO4J ORACELET (Shared Knowledge)

Query Graph

Tool: widgetdc-neural-bridge:query_knowledge_graph

Parametre:

• query: "Cypher query eller søgeterm"
• type: "search" | "cypher" | "labels" | "relationships"
• limit: antal resultater

Gem Finding

Tool: widgetdc-neural-bridge:create_graph_node

Parametre:

• label: "QAFinding" | "BugReport"
• properties: { title, severity, file, discoveredBy }

---

5. PING & HEALTH

Ping Service

Tool: widgetdc-neural-bridge:emit_sonar_pulse

• target: "neo4j" | "postgres" | "backend" | "filesystem"

System Health

Tool: widgetdc-neural-bridge:get_system_health

• detailed: true | false

---

AGENT IDENTITETER

• claude: Primær AI - kode, analyse, søgning
• gemini: Sekundær AI - frontend, design
• deepseek: Specialist - deep analysis
• clak: Human Owner - beslutninger
• codex: QA Direktør - audit, review
• system: Automatiseret - monitoring

---

CODEX QUICK REFERENCE

START SESSION: neural_chat_send(channel="core-dev", from="codex", body="QA AUDIT INITIATED", type="status", priority="high")

DELEGÉR TIL CLAUDE: neural_chat_send(channel="core-dev", from="codex", body="Claude: [INSTRUKTION]", type="task")

RAPPORTÉR FINDING: neural_chat_send(channel="alerts", from="codex", body="KRITISK: [FINDING]", type="alert", priority="critical")

GEM FINDING: create_graph_node(label="QAFinding", properties={...})

PING SYSTEM: emit_sonar_pulse(target="neo4j") get_system_health(detailed=true)