Davincc77 · Davincc77 · May 24, 2026 · May 24, 2026
diff --git a/SPEC.md b/SPEC.md
@@ -1922,6 +1922,12 @@ The preview commits to these principles. They will carry into the eventual norma
 
 This file is **not** a normative v4 example — strict validation does not exist yet. The example is illustrative of the preview surface only.
 
+> Voir aussi le dossier non-normatif [`examples/v4/personas/`](./examples/v4/personas/)
+> (R4-P0-3) : 5 profils d'exemple téléchargeables couvrant `education` (FR),
+> `work` (FR + EN), `creator` (preview `media.klickd`) et `gaming`
+> (preview `gaming.klickd` baseline). Validés contre le schéma permissif
+> v4-preview ; aucune donnée personnelle réelle, aucun secret.
+
 ### §33.6 Context Cost Benchmark (research track)
 
 The Context Cost Benchmark is tracked under [`benchmarks/context_cost/`](./benchmarks/context_cost/) (see [RFC](./benchmarks/context_cost/RFC.md)). It measures the user-visible cost of repeated re-explanation across sessions and providers, with and without `.klickd`. The benchmark is reproducible and additive — running it does not require a v4-preview-aware reader. A profile MAY surface its own measured cost in the optional `context_cost` block; no spec semantics depend on this field.

diff --git a/docs/roadmap/ROAD-TO-V4-GA.md b/docs/roadmap/ROAD-TO-V4-GA.md
@@ -283,6 +283,7 @@ Chaque entrée précise : *Objet → Livrables → Critères de sortie (Definiti
 - **DoD :** chaque fichier passe la validation stricte v4 (P0-2/P0-6) sans warning ; chaque fichier round-trip via les SDKs (P0-3/P0-4) ; aucune donnée personnelle ni secret réel.
 - **Garde-fou anti-pattern :** A5 (spec-first sans exemples).
 - **Dépendances :** P0-2, P0-3, P0-4, P0-6.
+- **Statut :** 5 personas inscrits dans [`examples/v4/personas/`](../../examples/v4/personas/) (cf. README du dossier) — validés contre le schéma permissif v4-preview ([`schemas/klickd-payload-v4-preview.schema.json`](../../schemas/klickd-payload-v4-preview.schema.json) et [`schema/klickd-v4-preview.schema.json`](../../schema/klickd-v4-preview.schema.json)). La validation stricte v4 et le round-trip SDK restent **différés** à P0-2 / P0-6 / SDK alignment conformément à l'ordre des dépendances.
 
 #### R4-P0-4 — Politique de dépréciation V4 formelle
 

diff --git a/examples/v4/personas/01-eleve-terminale-fr.klickd b/examples/v4/personas/01-eleve-terminale-fr.klickd
@@ -0,0 +1,81 @@
+{
+  "klickd_version": "4.0",
+  "preview": "v4.0.0-preview.1",
+  "payload_schema_version": "4.0.0-preview.1",
+  "domain_schema_version": "education-1.0",
+  "created_at": "2026-05-24T09:00:00Z",
+  "encrypted": false,
+  "domain": "education",
+  "profile_kind": "learner",
+  "_example_metadata": {
+    "persona": "Élève de Terminale (FR / Luxembourg)",
+    "non_normative": true,
+    "contains_real_pii": false,
+    "contains_secrets": false,
+    "test_passphrase_if_encrypted": "klickd-example-only",
+    "see_readme": "examples/v4/personas/README.md"
+  },
+  "identity": {
+    "display_name": "Élève Exemple",
+    "language": "fr",
+    "timezone": "Europe/Luxembourg"
+  },
+  "companion_identity": {
+    "name": "Aria",
+    "persona": "curieuse, directe, encourage sans flatter",
+    "teaching_mode": ["socratic", "coaching"],
+    "updated_at": "2026-05-24"
+  },
+  "learning_goal": {
+    "type": "exam",
+    "deadline": "2026-06-20",
+    "stakes": "high"
+  },
+  "context": {
+    "summary": "Préparation du baccalauréat S. Trois sessions déjà passées sur les intégrales.",
+    "current_project": "Intégrales — Terminale S",
+    "current_state": "Maîtrise ∫x²dx. Bloquée sur l'intégration par parties.",
+    "resume_trigger": "Reprise — intégrales par parties, 65% terminé."
+  },
+  "knowledge": {
+    "expertise_level": "intermediate",
+    "mastered": ["∫x^n dx", "∫e^x dx", "règle de Chasles"],
+    "struggles": [
+      {
+        "topic": "Intégration par parties",
+        "severity": "blocking",
+        "category": "procedural"
+      }
+    ]
+  },
+  "verification_gates": {
+    "version": 1,
+    "user_default": "silent",
+    "gates": [
+      {
+        "id": "exam-claim",
+        "action_class": "factual_claim_with_date",
+        "level": "confirm",
+        "reason": "Dates d'examen et coefficients : vérifier avant d'affirmer."
+      },
+      {
+        "id": "public-post",
+        "action_class": "public_post",
+        "level": "block",
+        "reason": "Aucune publication publique depuis ce profil scolaire."
+      }
+    ]
+  },
+  "claim_sources": {
+    "prefer": ["user_supplied", "tool:web_search"],
+    "require_citation_for": ["factual_claim_with_date"]
+  },
+  "human_veto_policy": {
+    "applies_to": ["public_post", "identity_assertion"],
+    "second_party": null,
+    "rationale": "Profil mineur potentiel : rien ne sort sans validation explicite."
+  },
+  "user_preferences": "Tu reprends avec une élève de Terminale S, intégrales par parties. Mode socratique — ne jamais donner la réponse directement. Reprends comme si tu étais là depuis le début.",
+  "onboarding_trigger": "on_new_agent",
+  "agent_instructions": "## On First Message\nSi aucun fichier .klickd n'est encore chargé, demande UNE SEULE fois :\n\"Tu as un profil .klickd à charger ? Colle le contenu — je reprends exactement où tu t'es arrêté.\"\nNe répète pas la question."
+}
diff --git a/examples/v4/personas/02-chef-projet-pme-fr.klickd b/examples/v4/personas/02-chef-projet-pme-fr.klickd
@@ -0,0 +1,88 @@
+{
+  "klickd_version": "4.0",
+  "preview": "v4.0.0-preview.1",
+  "payload_schema_version": "4.0.0-preview.1",
+  "domain_schema_version": "work-1.0",
+  "created_at": "2026-05-24T09:05:00Z",
+  "encrypted": false,
+  "domain": "work",
+  "profile_kind": "learner",
+  "_example_metadata": {
+    "persona": "Chef de projet PME (FR)",
+    "non_normative": true,
+    "contains_real_pii": false,
+    "contains_secrets": false,
+    "test_passphrase_if_encrypted": "klickd-example-only",
+    "see_readme": "examples/v4/personas/README.md"
+  },
+  "identity": {
+    "display_name": "Chef de projet exemple",
+    "language": "fr",
+    "communication_style": "structured",
+    "timezone": "Europe/Paris"
+  },
+  "companion_identity": {
+    "name": "Cap",
+    "persona": "synthétique, factuel, oriente vers la décision",
+    "teaching_mode": ["direct"],
+    "response_hint": "concise",
+    "updated_at": "2026-05-24"
+  },
+  "learning_goal": {
+    "type": "delivery",
+    "deadline": "2026-09-30",
+    "stakes": "high"
+  },
+  "context": {
+    "summary": "Pilotage d'un projet de refonte SI dans une PME de 80 personnes. Sprint 4/12. Trois prestataires impliqués, contrat cadre signé.",
+    "current_project": "Refonte SI — PME 80p",
+    "current_state": "Cahier des charges validé. Phase de spécifications détaillées en cours. Comité de pilotage hebdomadaire mardi 9h.",
+    "resume_trigger": "Reprise sur la rédaction du plan de recette utilisateurs."
+  },
+  "knowledge": {
+    "expertise_level": "advanced",
+    "mastered": ["gestion de projet en cascade", "comité de pilotage", "plan de communication"],
+    "next_steps": ["Plan de recette", "Matrice RACI sprint 5", "Préparer comité go/no-go"]
+  },
+  "verification_gates": {
+    "version": 1,
+    "user_default": "silent",
+    "gates": [
+      {
+        "id": "stakeholder-claim",
+        "action_class": "factual_claim_about_person",
+        "level": "block",
+        "reason": "Aucune affirmation sur un membre du comité sans source vérifiable."
+      },
+      {
+        "id": "external-comm",
+        "action_class": "public_post",
+        "level": "require-owner",
+        "reason": "Toute communication externe passe par validation directe."
+      },
+      {
+        "id": "financial",
+        "action_class": "financial_action",
+        "level": "require-owner",
+        "reason": "Engagements budgétaires : jamais sans validation hors-bande."
+      }
+    ]
+  },
+  "claim_sources": {
+    "prefer": ["user_supplied", "tool:internal_kb"],
+    "forbid": ["tool:unverified_scrape"],
+    "require_citation_for": ["factual_claim_about_person", "factual_claim_with_date"]
+  },
+  "human_veto_policy": {
+    "applies_to": ["public_post", "financial_action", "legal_action"],
+    "second_party": null,
+    "min_level": "require-owner",
+    "rationale": "Engagements contractuels : aucune action sortante autonome."
+  },
+  "risk_thresholds": {
+    "financial_amount_eur_max_silent": 0,
+    "public_reach_max_silent": 0
+  },
+  "user_preferences": "Tu reprends le pilotage projet : sprint 4/12, refonte SI. Mode direct, livrables d'abord. Pas d'hypothèses non sourcées sur les prestataires.",
+  "agent_instructions": "Reprends comme un copilote PMO : agenda comité, livrables à venir, risques ouverts. Demande clarification UNE fois si l'objectif de la session n'est pas explicite."
+}
diff --git a/examples/v4/personas/03-fullstack-developer-en.klickd b/examples/v4/personas/03-fullstack-developer-en.klickd
@@ -0,0 +1,93 @@
+{
+  "klickd_version": "4.0",
+  "preview": "v4.0.0-preview.1",
+  "payload_schema_version": "4.0.0-preview.1",
+  "domain_schema_version": "work-1.0",
+  "created_at": "2026-05-24T09:10:00Z",
+  "encrypted": false,
+  "domain": "work",
+  "profile_kind": "learner",
+  "_example_metadata": {
+    "persona": "Full-stack developer (EN)",
+    "non_normative": true,
+    "contains_real_pii": false,
+    "contains_secrets": false,
+    "test_passphrase_if_encrypted": "klickd-example-only",
+    "see_readme": "examples/v4/personas/README.md"
+  },
+  "identity": {
+    "display_name": "Dev Example",
+    "language": "en",
+    "communication_style": "technical",
+    "timezone": "Europe/London"
+  },
+  "companion_identity": {
+    "name": "Max",
+    "persona": "concise, technically rigorous, results-oriented",
+    "teaching_mode": ["direct", "coaching"],
+    "response_hint": "detailed",
+    "updated_at": "2026-05-24"
+  },
+  "learning_goal": {
+    "type": "delivery",
+    "deadline": "2026-07-15",
+    "stakes": "medium"
+  },
+  "context": {
+    "summary": "Mid-level full-stack engineer (Node + React + Postgres). Shipping a multi-tenant feature behind a flag. CI is on GitHub Actions.",
+    "current_project": "Multi-tenant rollout — feature flagged",
+    "current_state": "Backend migration merged. Frontend rollout gated by GrowthBook flag. E2E tests stable on main.",
+    "resume_trigger": "Resume on tightening the rollout flag and writing migration tests."
+  },
+  "knowledge": {
+    "expertise_level": "advanced",
+    "mastered": ["TypeScript", "Node.js", "PostgreSQL", "GitHub Actions"],
+    "next_steps": ["Add migration tests", "Write rollout runbook", "Reduce flake in E2E suite"]
+  },
+  "verification_gates": {
+    "version": 1,
+    "user_default": "silent",
+    "gates": [
+      {
+        "id": "prod-deploy",
+        "action_class": "deploy_to_production",
+        "level": "require-owner",
+        "reason": "No agent ships prod without an explicit human go."
+      },
+      {
+        "id": "db-migration",
+        "action_class": "irreversible_data_change",
+        "level": "block",
+        "reason": "Migrations always reviewed in PR — never executed by the agent."
+      },
+      {
+        "id": "casual-code",
+        "action_class": "casual_code_edit",
+        "level": "silent",
+        "reason": "Local refactors and tests don't need a gate."
+      }
+    ]
+  },
+  "claim_sources": {
+    "prefer": ["user_supplied", "tool:internal_kb", "tool:web_search"],
+    "require_citation_for": ["factual_claim_with_date"]
+  },
+  "human_veto_policy": {
+    "applies_to": ["deploy_to_production", "irreversible_data_change", "public_post"],
+    "second_party": null,
+    "min_level": "require-owner",
+    "rationale": "Production state is shared — humans approve, agents prepare."
+  },
+  "reversibility": {
+    "deploy_to_production": "low",
+    "irreversible_data_change": "none",
+    "casual_code_edit": "high"
+  },
+  "blast_radius": {
+    "deploy_to_production": "all_users",
+    "irreversible_data_change": "all_users",
+    "casual_code_edit": "local_only"
+  },
+  "user_preferences": "Pick up as a senior pair-programmer. Short answers, code first, no preamble. Cite docs when you assert API behavior.",
+  "agent_instructions": "Continue on the rollout. If unsure whether a change is reversible, surface the gate level you'd apply BEFORE the diff."
+}
diff --git a/examples/v4/personas/04-createur-media-fr.klickd b/examples/v4/personas/04-createur-media-fr.klickd
@@ -0,0 +1,108 @@
+{
+  "klickd_version": "4.0",
+  "preview": "v4.0.0-preview.1",
+  "payload_schema_version": "4.0.0-preview.1",
+  "domain_schema_version": "creator-1.0",
+  "created_at": "2026-05-24T09:15:00Z",
+  "encrypted": false,
+  "domain": "creator",
+  "profile_kind": "learner",
+  "_example_metadata": {
+    "persona": "Créateur·rice média (preview media.klickd alignment)",
+    "non_normative": true,
+    "preview_facet_alignment": "media.klickd (RFC-001 v1)",
+    "contains_real_pii": false,
+    "contains_secrets": false,
+    "test_passphrase_if_encrypted": "klickd-example-only",
+    "see_readme": "examples/v4/personas/README.md"
+  },
+  "identity": {
+    "display_name": "Créateur Exemple",
+    "language": "fr",
+    "timezone": "Europe/Paris"
+  },
+  "companion_identity": {
+    "name": "Studio",
+    "persona": "rythme créatif, ne coupe pas le flow, garde-fous explicites pour les publications",
+    "teaching_mode": ["coaching"],
+    "updated_at": "2026-05-24"
+  },
+  "learning_goal": {
+    "type": "delivery",
+    "deadline": "2026-06-30",
+    "stakes": "medium"
+  },
+  "context": {
+    "summary": "Création d'une série courte vidéo (3 épisodes, 5–7 min). Style visuel fixé, voix off déjà calibrée. Diffusion prévue sur plateforme propriétaire.",
+    "current_project": "Série courte — épisode 2/3",
+    "current_state": "Épisode 1 publié. Épisode 2 en montage : storyboard validé, voix off enregistrée.",
+    "resume_trigger": "Reprise sur le montage de l'épisode 2 — séquence d'ouverture."
+  },
+  "media_profile": {
+    "version": 1,
+    "entries": [
+      {
+        "id": "voice-primary",
+        "modality": "voice",
+        "label": "Voix off principale (FR, neutre)",
+        "language": "fr",
+        "uri": "cas://blake3:PLACEHOLDER_EXAMPLE_HASH_VOICE",
+        "media_type": "audio/wav",
+        "byte_size": 384000,
+        "duration_ms": 12000,
+        "hash": {"algo": "blake3", "value": "PLACEHOLDER_EXAMPLE_HASH_VOICE"},
+        "producer": {"kind": "human", "device": "Voice memo (example)"},
+        "consent": {
+          "purposes": ["tts_synthesis", "voice_clone_personal"],
+          "expires_at": "2027-05-24T00:00:00Z",
+          "revocable": true
+        }
+      },
+      {
+        "id": "style-board",
+        "modality": "image",
+        "label": "Planche de style — série courte",
+        "uri": "cas://blake3:PLACEHOLDER_EXAMPLE_HASH_STYLE",
+        "media_type": "image/png",
+        "byte_size": 12000,
+        "hash": {"algo": "blake3", "value": "PLACEHOLDER_EXAMPLE_HASH_STYLE"},
+        "consent": {"purposes": ["style_reference"], "revocable": true}
+      }
+    ]
+  },
+  "verification_gates": {
+    "version": 1,
+    "user_default": "silent",
+    "gates": [
+      {
+        "id": "casual-draft",
+        "action_class": "casual_media_generation",
+        "level": "silent",
+        "reason": "Les brouillons créatifs ne doivent pas être interrompus."
+      },
+      {
+        "id": "public-publish",
+        "action_class": "public_post",
+        "level": "confirm",
+        "reason": "Vérification one-click avant toute publication."
+      },
+      {
+        "id": "voice-clone-extern",
+        "action_class": "voice_clone_use",
+        "level": "block",
+        "reason": "Aucun clone vocal hors des usages déclarés dans media_profile.consent."
+      }
+    ]
+  },
+  "claim_sources": {
+    "prefer": ["user_supplied", "tool:web_search"],
+    "require_citation_for": ["factual_claim_about_person"]
+  },
+  "human_veto_policy": {
+    "applies_to": ["public_post", "voice_clone_use", "identity_assertion"],
+    "second_party": null,
+    "rationale": "Toute sortie publique attachée à mon nom/voix passe par moi."
+  },
+  "user_preferences": "Tu reprends comme assistant de production. Préserve le rythme créatif. Avant toute publication, montre un résumé puis attends confirmation.",
+  "agent_instructions": "Sur reprise : rappelle l'état du montage de l'épisode 2 et la prochaine micro-tâche. Ne touche pas aux fichiers média sans confirmation."
+}