Galactic Protocol

Galactic Protocol

The Galactic Protocol is Demerzel's cross-repo communication framework — how governance artifacts, directives, and compliance reports flow between repositories.

Message Types

Message	Direction	Schema	Purpose
Directive	Demerzel → Consumer	directive.schema.json	Policy updates, compliance requests, reconnaissance
Compliance Report	Consumer → Demerzel	compliance-report.schema.json	Verification of policy adherence
Belief Snapshot	Consumer → Demerzel	belief-snapshot.schema.json	Point-in-time belief state export
Knowledge Package	Demerzel → Consumer	knowledge-package.schema.json	Teaching content, curriculum
Learning Outcome	Consumer → Demerzel	learning-outcome.schema.json	Comprehension verification
ML Feedback	ix → Demerzel	ml-feedback-recommendation.schema.json	Calibration recommendations
External Sync	Any → External	external-sync-envelope.schema.json	Cross-platform communication

Transport

Messages are stored as JSON files in the state/ directories of each repo. The Galactic Protocol is file-based, not API-based — this ensures:

• Full auditability (every message is a committed file)
• Schema validation at rest
• No runtime dependencies between repos
• Git history as the communication log

Directive Example

{
  "directive_id": "dir-2026-03-17-001",
  "type": "governance_directive",
  "from": "demerzel",
  "to": "ix",
  "priority": "P1",
  "subject": "Update submodule and create state directory",
  "requirements": [
    "Update governance/demerzel submodule to latest master",
    "Create governance/state/ directory with standard structure"
  ],
  "deadline": "2026-03-24",
  "compliance_verification": "Belief snapshot showing submodule current"
}

Compliance Flow

1. Demerzel issues a directive
2. Consumer repo receives directive (via submodule update or direct communication)
3. Consumer implements requirements
4. Consumer sends compliance report with evidence
5. Demerzel verifies compliance, updates belief state
6. If non-compliant, Demerzel may issue remediation directive

Consumer Integration

Each consumer repo:

• Includes Demerzel as git submodule at governance/demerzel/
• Maintains governance/state/ for belief persistence
• Has governance section in CLAUDE.md (from templates/CLAUDE.md.snippet)
• Defines agent personas in governance/personas/