Dokugent Certificate Schema This document defines the structure of a compiled Dokugent certificate (compiled.json) generated by Dokugent. Each section is mapped to a specific command and tagged for compliance, security, or audit purposes.
Use this schema as a reference when authoring or verifying agent configurations.
View Dokugent Certiticate Schema
✖
Dokugent Dokugent Certificate Schema 🧾 Identity Field Example Source Tags agent"summarybot" dokugent agent ISO description"Assists with summarizing input text" dokugent agent ISO roles["summarizer", "formatter"] dokugent agent ISO processableTypes["english", "markdown structure"] dokugent agent — owner"kinderbytes" dokugent agent ISO, GDPR ownerId"kinderbytes.org" dokugent agent ISO, GDPR signer"key-ed25519-01.pem" dokugent certify ISO ecosystem"nvidia" dokugent agent optional
🧠 Behavior & Purpose Field Example Source Tags mainTask"Summarize input as 3 bullet points" dokugent agent ISO, GDPR version"2025-05-17T10:12:04Z" dokugent preview ISO uri"doku:agent/summarybot@2025-05-17.kinderbytes" dokugent compile ISO, GDPR requiresConventionsfalse dokugent agent development
🔧 Tooling & Steps Field Example Source Tags tools["openai-chat", "markdown-cleaner"] dokugent tool-list ISO, GDPR planSteps [ {"id":"summarize_input","goal":"...","tools":["..."],"constraints":["..."]}, {"id":"reformat_output","goal":"...","tools":["..."],"constraints":["..."]} ] dokugent plan ISO, GDPR
✅ Evaluation Field Example Source Tags criteria["must have 3 bullets", "max 200 words"] dokugent criteria ISO conventions[{"llmName": "CLAUDE", "file": "CLAUDE.md"}, {"llmName": "CODEX", "file": "CODEX.md"}] dokugent conventions ISO
📦 I/O & Rules Field Example Source Tags protocols["markdown", "text/plain"] dokugent io GDPR outputs["summary.md"] dokugent io ISO allowExternalFilestrue dokugent io GDPR requireApprovalfalse dokugent io ISO, GDPR denylist["html", "javascript"] dokugent io ISO, GDPR
🛡️ Compliance & Governance Field Example Source Tags contact{ name: "Carmelyne Thompson", email: "owner@kinderbytes.org" } dokugent compliance ISO, GDPR dataRetention"7 days" dokugent compliance GDPR dataSensitivity["location", "personal identifiers"] dokugent compliance ISO, GDPR legalBasis"consent" dokugent compliance GDPR authorizedUsers["station-chief", "fire-investigator"] dokugent compliance ISO auditLogRef".dokugent/audit/iso-trace.md" dokugent audit ISO
🧾 Doku Metadata Field Example Source Tags format"doku-cert" dokugent compile internal version"v1.0.0" dokugent compile schema schema"https://dokugent.org/schema/v1.json" dokugent compile reference generatedAt"2025-05-17T05:36:00Z" dokugent compile provenance generator"dokugent@0.1.12" dokugent compile audit experimentalfalse dokugent compile development fromPreview"happybot@2025-05-24_19-15-55-492.cert.json" dokugent preview internal compiledBy"carmelyne@dokugent.com" dokugent compile internal
🧠 MCP Integration (Experimental) Field Example Source Tags globalByo{"customContextSchema": "v0.2", "defaults": {...}} dokugent byo MCP, experimental
📨 Dokugent MCP Message Format Field Example Source Purpose Tags modelContextRef"mcp://openai/gpt-4o@2025-05" dokugent compile References the LLM model context (MCP standard) audit, MCP intent"summarize" dokugent mcp-schema Declares the agent’s current purpose ISO, MCP sender"agent.summarybot@kinderbytes.org" dokugent mcp-schema Who initiated the request (agent) GDPR, MCP receiver"agent.storage@kinderbytes.org" dokugent mcp-schema Target agent/tool of the request GDPR, MCP payload{ "input": "raw text", "format": "markdown" } dokugent mcp-schema Input being passed into the tool or API internal response{ "summary": "...", "format": "markdown" } dokugent mcp-schema Output from the tool or endpoint internal signature"-----BEGIN SIGNATURE-----abc123..." dokugent mcp-schema Verifiable signature tied to payload+context audit, MCP timestamp"2025-05-21T09:00:00Z" dokugent mcp-schema When this message/step occurred provenance traceId"trace-2025-05-21–001" dokugent trace Unifies logs, plan steps, and signature under one thread observability