JDON stands for JSONFIRST Domain Object Notation. It is the executable intent format produced by the JSONFIRST protocol. JDON transforms a human instruction into a structured, validated, machine-readable JSON object with explicit action, object, domain, constraints, and execution metadata — ready to be executed by any AI agent or automation pipeline.

What is the difference between JDON and JSON?

Regular JSON is a data format — it stores arbitrary key-value pairs. JDON is a structured intent format — it specifically encodes a human intent as an executable AI action with defined fields: action, object, domain, constraints, and execution rules. JDON is not just data; it is a structured AI command that can be validated, governed, and executed deterministically.

How is JDON generated?

JDON is generated by JSONFIRST's intent parsing engine. When a user sends a human instruction (text), JSONFIRST parses the intent and produces a JDON object with explicit fields. The JDON is then validated against the governance mode and Action Registry before being passed to the LLM or execution engine.

What is structured AI commands?

Structured AI commands are machine-readable instructions that explicitly encode what an AI agent should do, on what object, with what constraints, and under what governance rules. JDON is JSONFIRST's implementation of structured AI commands — replacing fragile prompt engineering with deterministic, validatable intent.

JSONFIRST · FORMAT CENTRAL

Qu'est-ce que JDON?

JDON est le format d'intent exécutable produit par JSONFIRST.

JSONFIRST = le protocole. JDON = l'objet central du protocole.

JDON signifie JSONFIRST Domain Object Notation. C'est un format JSON structuré qui représente une intention humaine transformée en commande IA validée, gouvernable et exécutable.

Ce que signifie JDON

JSONFIRST

Le protocole source

Domain

Le domaine de l'agent

Object

L'objet structuré

Notation

Le format de représentation

JDON n'est pas un simple JSON. C'est un format d'intent structuré — chaque JDON encode une action spécifique, son objet, son domaine, ses contraintes d'exécution et ses règles de gouvernance. C'est la différence entre "données" et "commande IA exécutable".

Comment JDON est généré

Instruction Utilisateur"Analyse ce bilan comptable"

↓

JSONFIRSTIntent parsing engine

↓

★JDONStructured intent — validé, gouverné

↓

Action RegistrySélection et validation de l'action

↓

Policy ContractRègles de gouvernance et contraintes

↓

ExécutionLLM · Tools · APIs · Workflows

JDON GÉNÉRÉ

output.jdon.json

{
  "spec": "JSONFIRST",
  "version": "2.0",
  "input": {
    "raw_text": "Analyse ce bilan comptable",
    "language": "fr"
  },
  "jdons": [
    {
      "jdon_id": "jdon_a1b2c3d4",
      "confidence": 0.97,
      "action": {
        "raw": "analyze",
        "normalized": "analyze"
      },
      "object": {
        "type": "financial_report",
        "raw": "balance_sheet"
      },
      "domain": {
        "primary": "finance"
      },
      "constraints": {
        "require_validation": true,
        "governance_mode": "FINANCE_ALGO"
      }
    }
  ],
  "execution": {
    "parsable": true,
    "executable": true,
    "mode": "strict",
    "state": "VALIDATED"
  }
}

ValidéGouvernéExécutable

JDON vs JSON

JDON représente une action structurée — pas seulement des données.

JSON classique

{
  "message": "analyse ce bilan"
}

Intention ambiguë
Pas d'action définie
Non validable
Le LLM doit deviner

JDON

{
  "intent": {
    "action": "analyze_financial_report",
    "object": "balance_sheet",
    "domain": "finance",
    "constraints": {
      "require_validation": true
    }
  }
}

Action explicite
Objet défini
Validable programmatiquement
Exécution déterministe

JSON vs JDON

JSON = format de données générique

Stocke des paires clé-valeur arbitraires. Aucune sémantique, aucune gouvernance, aucune traçabilité.

JDON = JSON-Defined Object Notation

→structuré selon le protocole JSONFIRST
→certifié par le pipeline v4.1
→traçable, versionné, auditable
→pas juste des données — une décision gouvernée

JDON dans le pipeline JSONFIRST

InstructionJSONFIRST★ JDONAction RegistryPolicy ContractExecution

JDON est produit par

JSONFIRST

JSONFIRST parse l'instruction et génère un JDON validé avec tous les champs requis.

JDON est consommé par

Action Registry

L'Action Registry lit le JDON, sélectionne l'action appropriée et valide les contraintes.

JDON est exécuté par

LLM · Tools · APIs

Le LLM ou les outils reçoivent un JDON structuré — pas un prompt ambigu.

Exemples de JDON

INSTRUCTION UTILISATEUR

"Analyse ce bilan comptable"

JSONFIRST parse

MODE ACTIF :FINANCE_EXPERT

JDON PRODUIT

intent.jdon.json

{
  "action": "analyze_financial_report",
  "object": "balance_sheet",
  "domain": "finance",
  "constraints": {
    "require_validation": true
  }
}

COMMENCEZ À GÉNÉRER DES JDON

Transformez vos intentions en JDON.

Chaque instruction devient un JDON validé, gouverné et exécutable.