Skip to content
holonicweb2
CoGov 2.0
CoGov 2.0 (Governance Architecture)
Share
Explore

CoGov Configuration (JSON Schema)

CoGovernance Configuration JSON Schema

Spec name: holonic-governance-config
Schema dialect: JSON Schema 2020-12
It is designed to be:
Parameter-based (same architecture, different configs)
Instance + version aware
Modular (modules can be enabled/disabled with required minima)
Machine-validated (Dapp/AI can check completeness deterministically)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://holonic.dev/schemas/holonic-governance-config.schema.json",
"title": "holonic-governance-config",
"type": "object",
"additionalProperties": false,
"required": ["spec", "instance", "modules"],
"properties": {
"spec": {
"type": "object",
"additionalProperties": false,
"required": ["name", "version", "created_at"],
"properties": {
"name": { "const": "holonic-governance-config" },
"version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
"created_at": { "type": "string", "format": "date-time" },
"notes": { "type": "string" }
}
},
"instance": {
"type": "object",
"additionalProperties": false,
"required": ["instance_id", "name", "profile", "jurisdiction", "status"],
"properties": {
"instance_id": { "type": "string", "minLength": 6 },
"name": { "type": "string", "minLength": 2 },
"profile": {
"type": "string",
"enum": ["organizational", "network", "subdao", "project", "initiative", "custom"]
},
"jurisdiction": {
"type": "object",
"additionalProperties": false,
"required": ["legal_wrapper", "region"],
"properties": {
"legal_wrapper": {
"type": "string",
"enum": [
"dao",
"llc",
"cooperative",
"foundation",
"trust",
"unincorporated",
"hybrid",
"unknown"
]
},
"region": { "type": "string" },
"compliance_flags": { "type": "array", "items": { "type": "string" } }
}
},
"status": {
"type": "string",
"enum": ["draft", "ratified", "active", "paused", "sunset", "archived"]
},
"parent_instance_id": { "type": ["string", "null"] },
"tags": { "type": "array", "items": { "type": "string" } }
}
},
"modules": {
"type": "object",
"additionalProperties": false,
"required": [
"foundational_pattern",
"constitutional_core",
"governance_and_roles",
"decision_systems",
"treasury_and_capital",
"accountability_ledger",
"network_graph_and_metaontology",
"participation_and_boundaries",
"conflict_resolution",
"adaptation_and_evolution",
"token_and_incentive_alignment",
"replication_and_deployment"
],
"properties": {
"foundational_pattern": { "$ref": "#/$defs/foundationalPattern" },
"constitutional_core": { "$ref": "#/$defs/constitutionalCore" },
"governance_and_roles": { "$ref": "#/$defs/governanceAndRoles" },
"decision_systems": { "$ref": "#/$defs/decisionSystems" },
"treasury_and_capital": { "$ref": "#/$defs/treasuryAndCapital" },
"accountability_ledger": { "$ref": "#/$defs/accountabilityLedger" },
"network_graph_and_metaontology": { "$ref": "#/$defs/networkGraphAndMetaOntology" },
"participation_and_boundaries": { "$ref": "#/$defs/participationAndBoundaries" },
"conflict_resolution": { "$ref": "#/$defs/conflictResolution" },
"adaptation_and_evolution": { "$ref": "#/$defs/adaptationAndEvolution" },
"token_and_incentive_alignment": { "$ref": "#/$defs/tokenAndIncentiveAlignment" },
"replication_and_deployment": { "$ref": "#/$defs/replicationAndDeployment" }
}
}
},
"$defs": {
"enabledBlock": {
"type": "object",
"additionalProperties": false,
"required": ["enabled"],
"properties": { "enabled": { "type": "boolean" } }
},
"reference": {
"type": "object",
"additionalProperties": false,
"properties": {
"uri": { "type": "string" },
"hash": { "type": "string" },
"label": { "type": "string" }
}
},
"threshold": {
"type": "object",
"additionalProperties": false,
"required": ["type"],
"properties": {
"type": { "type": "string", "enum": ["percent", "count", "hybrid"] },
"percent": { "type": "number", "minimum": 0, "maximum": 100 },
"count": { "type": "integer", "minimum": 0 },
"min_participants": { "type": "integer", "minimum": 0 }
}
},

"foundationalPattern": {
"allOf": [{ "$ref": "#/$defs/enabledBlock" }],
"type": "object",
"additionalProperties": false,
"required": ["enabled", "principles"],
"properties": {
"enabled": { "const": true },
"principles": { "type": "array", "minItems": 3, "items": { "type": "string" } },
"coordination_assumptions": { "type": "array", "items": { "type": "string" } },
"references": { "type": "array", "items": { "$ref": "#/$defs/reference" } }
}
},

"constitutionalCore": {
"allOf": [{ "$ref": "#/$defs/enabledBlock" }],
"type": "object",
"additionalProperties": false,
"required": ["enabled", "purpose", "invariants", "rights_responsibilities", "amendments"],
"properties": {
"enabled": { "const": true },
"purpose": {
"type": "object",
"additionalProperties": false,
"required": ["statement"],
"properties": {
"statement": { "type": "string", "minLength": 10 },
"beneficiaries": { "type": "array", "items": { "type": "string" } }
}
},
"invariants": { "type": "array", "minItems": 3, "items": { "type": "string" } },
"rights_responsibilities": {
"type": "object",
"additionalProperties": false,
"required": ["rights", "responsibilities"],
"properties": {
"rights": { "type": "array", "items": { "type": "string" } },
"responsibilities": { "type": "array", "items": { "type": "string" } }
}
},
"jurisdiction_binding": {
"type": "object",
"additionalProperties": false,
"properties": {
"applies_to": { "type": "string", "enum": ["offchain", "onchain", "hybrid"] },
"legal_reference": { "$ref": "#/$defs/reference" }
}
},
"amendments": {
"type": "object",
"additionalProperties": false,
"required": ["proposal_threshold", "ratification_threshold", "deliberation_days"],
"properties": {
"proposal_threshold": { "$ref": "#/$defs/threshold" },
"ratification_threshold": { "$ref": "#/$defs/threshold" },
"deliberation_days": { "type": "integer", "minimum": 1 },
"protected_clauses": { "type": "array", "items": { "type": "string" } }
}
}
}
},

"governanceAndRoles": {
"allOf": [{ "$ref": "#/$defs/enabledBlock" }],
"type": "object",
"additionalProperties": false,
"required": ["enabled", "roles", "councils", "separation_of_powers"],
"properties": {
"enabled": { "const": true },
"roles": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"additionalProperties": false,
"required": ["role_id", "name", "mandate", "authority_scope", "term", "revocation"],
"properties": {
"role_id": { "type": "string" },
"name": { "type": "string" },
"mandate": { "type": "string" },
"authority_scope": { "type": "array", "items": { "type": "string" } },
"permissions": { "type": "array", "items": { "type": "string" } },
"term": {
"type": "object",
"additionalProperties": false,
"required": ["type"],
"properties": {
"type": {
"type": "string",
"enum": ["fixed_days", "renewable_days", "indefinite"]
},
"days": { "type": "integer", "minimum": 1 }
}
},
"revocation": {
"type": "object",
"additionalProperties": false,
"required": ["method", "threshold"],
"properties": {
"method": { "type": "string", "enum": ["vote", "council", "admin", "hybrid"] },
"threshold": { "$ref": "#/$defs/threshold" }
}
}
}
}
},
"councils": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": ["council_id", "name", "domain", "composition", "powers"],
"properties": {
"council_id": { "type": "string" },
"name": { "type": "string" },
"domain": { "type": "string" },
"composition": {
"type": "object",
"additionalProperties": false,
"required": ["member_roles", "selection_method"],
"properties": {
"member_roles": { "type": "array", "items": { "type": "string" } },
Want to print your doc?
This is not the way.
Try clicking the ··· in the right corner or using a keyboard shortcut (
CtrlP
) instead.