OKFOpen Knowledge Format
Prendre un RDV

14 - Personas

Personas OKF : quel premier bundle créer selon votre équipe ?

OKF devient concret quand il part d'une équipe, d'une douleur et d'une tâche. Un fondateur, une PME, une équipe data, un support client ou une équipe SEO ne doivent pas créer le même premier bundle. La bonne question est: quel contexte manque le plus souvent à vos agents pour produire une réponse fiable ?

Schéma reliant un profil d'équipe à une douleur visible, un premier bundle naturel, des concepts clés, un test agent et un cas détaillé.
Le bon persona aide à choisir un premier bundle naturel, puis à l'orienter vers un test agent mesurable.

Pourquoi raisonner par persona ?

Un bundle OKF n'a pas la même valeur selon l'équipe qui l'utilise. Pour une équipe data, la valeur vient souvent de métriques mieux définies. Pour le support, elle vient de réponses plus cohérentes. Pour le marketing, elle vient de briefs plus fiables. Pour un fondateur, elle vient d'une mémoire stratégique qui ne reste pas seulement dans sa tête.

Raisonner par persona évite de créer un bundle générique et faible. Chaque profil possède ses sources naturelles, ses douleurs récurrentes, ses concepts prioritaires et ses tests agent. C'est ce qui permet de démarrer petit sans être superficiel.

Cette page ne remplace pas les cas détaillés. Elle sert d'aiguillage: elle aide à choisir où commencer, puis à basculer vers les chapitres data, marketing ou support/sales quand le périmètre devient clair.

Fondateur solo : transformer la mémoire du projet en contexte portable

Le fondateur solo porte souvent une grande partie du contexte dans sa tête: positionnement, décisions pricing, promesses faites aux clients, roadmap, objections, apprentissages marché, choix techniques, ton de marque. Les agents peuvent aider, mais ils repartent trop souvent de zéro.

Le premier bundle naturel n'est pas un wiki complet. C'est un dossier qui stabilise les décisions et les éléments que le fondateur répète sans cesse. Par exemple `strategy/positioning.md`, `decisions/pricing-v1.md`, `offers/core-offer.md`, `personas/early-buyer.md` et `proofs/customer-signals.md`.

Le test agent peut être simple: préparer une page de vente, rédiger une relance, comparer deux décisions produit ou expliquer pourquoi une fonctionnalité est prioritaire, sans trahir le positionnement.

PME : stabiliser le savoir commercial, support et opérationnel

Dans une PME, le contexte est souvent réparti entre quelques personnes clés. Les règles commerciales, réponses support, procédures d'onboarding et décisions opérationnelles vivent dans des conversations, des documents et des habitudes tacites.

Le premier bundle doit viser la réduction des dépendances aux experts internes. Des fichiers comme `sales/objections.md`, `support/refund-policy.md`, `ops/onboarding.md`, `templates/follow-up-email.md` et `decisions/service-level.md` peuvent déjà rendre les réponses plus cohérentes.

Le test agent consiste à traiter un cas réel: répondre à un client, préparer une proposition, guider un nouvel arrivant ou rappeler une règle opérationnelle avec source et limite.

Équipe data : rendre les métriques et tables explicables

Une équipe data souffre rarement d'un manque total de documentation. Elle souffre plutôt de définitions dispersées: métriques dans un dashboard, logique SQL dans un notebook, ownership dans un catalog, décision métier dans une réunion, exceptions dans Slack.

Le premier bundle naturel documente une famille de métriques ou un domaine analytique précis. Par exemple `metrics/mrr.md`, `tables/orders.md`, `dashboards/revenue.md`, `decisions/pricing-v2.md` et `owners/revenue-analytics.md`.

Le test agent doit vérifier la compréhension: expliquer la formule, citer la table source, lister les exclusions, pointer vers le dashboard officiel et signaler les ambiguïtés restantes.

Équipe produit : relier décisions, specs et contexte utilisateur

Une équipe produit accumule des specs, recherches utilisateur, arbitrages roadmap, tickets, retours sales et décisions d'architecture. Le problème n'est pas seulement de retrouver un document, mais de comprendre pourquoi une décision a été prise.

Un premier bundle produit peut relier `decisions/roadmap-q3.md`, `personas/admin-user.md`, `specs/import-flow.md`, `research/import-pain-points.md` et `tickets/import-failures.md`.

Le test agent peut consister à résumer une décision, préparer un brief de fonctionnalité, expliquer un tradeoff ou identifier les sources utilisateur qui justifient une priorité.

Sales et marketing : industrialiser les offres, preuves et objections

Les équipes sales et marketing produisent beaucoup de contexte réutilisable: personas, offres, objections, preuves, cas clients, templates de relance, messages, pages, briefs et comparatifs. Pourtant, ce contexte reste souvent dispersé entre CRM, Notion, decks et documents de campagne.

Le premier bundle peut viser une offre ou un segment. Par exemple `offers/enterprise.md`, `personas/cfo.md`, `objections/security.md`, `proofs/customer-case-study.md`, `templates/follow-up-after-demo.md` et `pages/enterprise-landing.md`.

Le test agent consiste à produire une relance, un brief de page, une réponse à objection ou une synthèse de persona en citant les preuves et en respectant le positionnement.

Support client : rendre les réponses cohérentes et vérifiables

Le support client est souvent le meilleur terrain de test pour OKF, parce que les erreurs de contexte se voient vite: réponse incohérente, promesse impossible, mauvaise règle, escalade oubliée, politique obsolète.

Un premier bundle support peut contenir `playbooks/refund-request.md`, `faqs/account-access.md`, `apis/create-ticket.md`, `policies/refund-policy.md`, `sources/help-center-refunds.md` et `decisions/refund-window-2026.md`.

Le test agent doit être précis: répondre à quelques tickets réels, citer la règle utilisée, indiquer les cas qui nécessitent une validation humaine et proposer l'action suivante.

Ops / SRE : documenter les runbooks et incidents critiques

Les équipes ops et SRE ont besoin d'un contexte fiable sous pression. Un agent mal guidé peut perdre du temps, suivre un runbook obsolète ou ignorer une limite de sécurité.

Le premier bundle doit être petit et orienté incident: `runbooks/api-latency.md`, `sources/prometheus-alerts.md`, `apis/create-incident-ticket.md`, `decisions/on-call-escalation.md` et `templates/postmortem.md`.

Le test agent peut simuler un incident: retrouver le runbook, citer la source de l'alerte, proposer une séquence d'investigation, créer un ticket ou générer un brouillon de postmortem.

SEO / content : produire des briefs et entités agent-ready

Pour une équipe SEO ou contenu, OKF peut structurer les éléments que les agents réutilisent pour produire sans halluciner: entités, preuves, pages cibles, intentions, maillage, offres, personas et sources officielles.

Un premier bundle peut contenir `entities/open-knowledge-format.md`, `briefs/guide-okf.md`, `proofs/google-cloud-okf.md`, `pages/guide-open-knowledge-format.md`, `internal-links/okf-cluster.md` et `sources/official-spec.md`.

Le test agent peut produire un brief, proposer un plan d'article, vérifier les preuves à citer ou maintenir la cohérence entre plusieurs pages d'un cluster.

Matrice de choix : quel bundle créer en premier ?

La bonne décision dépend moins du métier que de la douleur observable. Si plusieurs personas semblent pertinents, choisissez celui où l'agent échoue déjà, où les sources existent et où le test peut être fait rapidement.

PersonaDouleur typiquePremier bundle recommandéTest agent
Fondateur solo

Décisions et positionnement restent dans la tête du fondateur.

Positionnement, offre, pricing, personas, preuves.

Rédiger une page ou relance sans trahir la stratégie.

PME

Savoir commercial et support dépend de quelques personnes clés.

Objections, politiques support, onboarding, templates.

Répondre à un client ou guider un nouvel arrivant.

Équipe data

Métriques et sources interprétées différemment selon les équipes.

Métriques, tables, dashboards, décisions, owners.

Expliquer une métrique avec formule et citations.

Équipe produit

Specs, décisions et retours utilisateur sont dispersés.

Décisions roadmap, personas, specs, research, tickets.

Préparer un brief produit avec sources et tradeoffs.

Sales / marketing

Offres, preuves et objections sont réécrites à chaque fois.

Offres, personas, objections, preuves, templates.

Produire une relance ou réponse à objection sourcée.

Support client

Réponses incohérentes ou règles mal appliquées.

FAQ, policies, playbooks, APIs, sources help center.

Répondre à des tickets réels avec limites et escalade.

Ops / SRE

Runbooks et escalades critiques vivent dans plusieurs outils.

Runbooks, alertes, APIs, décisions d'escalade, postmortems.

Diagnostiquer un incident simulé avec étapes sourcées.

SEO / content

Briefs, preuves et entités sont reconstruits à chaque contenu.

Entités, briefs, preuves, pages, maillage, sources.

Produire un brief sans inventer de preuve.

Comment éviter le mauvais premier persona

Le mauvais premier persona est souvent celui qui paraît stratégique mais dont le test est trop flou. Si vous ne pouvez pas formuler une tâche agent concrète, le bundle risque de devenir une documentation générale sans usage immédiat.

Évitez aussi les personas où les sources de vérité sont inexistantes ou politiquement contestées. OKF peut révéler les trous de contexte, mais il ne peut pas arbitrer seul une règle métier ou une décision de gouvernance.

Le meilleur premier persona combine trois choses: douleur visible, sources accessibles, test agent simple. C'est cette combinaison qui permet de prouver la valeur avant d'élargir.

Lire ensuite

Après avoir identifié le persona le plus pertinent, passez au cas détaillé correspondant ou revenez à la méthode de premier bundle pour cadrer le périmètre.

Premier bundle

Revenir à la méthode pour choisir un périmètre réduit à ROI visible.

Workflow

Produire, tester et améliorer le bundle après le choix du persona.

Cas data

Approfondir le bundle data: métriques, tables, dashboards et ownership.

Cas marketing SEO

Structurer offres, preuves, entités, pages et briefs agent-ready.

Cas support sales

Relier FAQ, objections, policies, templates et règles d'escalade.

Anatomie d'un bundle

Comprendre la structure du dossier produit par chaque persona.

Anatomie d'un concept

Écrire les fichiers Markdown qui composent le premier bundle.

Exemples de fichiers

Adapter des modèles concrets de concepts OKF.

Outils officiels

Explorer les samples et outils disponibles dans le repo officiel.

Sources officielles et lectures utiles

Google Cloud - Introducing OKF

Annonce officielle d'OKF et du besoin de contexte portable pour les agents.

OKF SPEC.md

Spécification primaire sur les bundles, concepts, liens et citations.

OKF README.md

Présentation officielle du repo, des samples et des outils OKF.

Knowledge Catalog repo

Repo officiel contenant la spec, les bundles d'exemple et les outils de référence.

Anthropic - Effective context engineering

Référence sur la curation et la maintenance du contexte utile pour les agents.

Anthropic - Building effective agents

Référence sur les workflows et agents efficaces en production.

OpenAI Codex - AGENTS.md

Documentation officielle sur les instructions persistantes pour agents de code.

À retenir

Les points à retenir

Le bon persona n'est pas celui qui paraît le plus stratégique sur le papier. C'est celui où la douleur de contexte est visible, les sources existent et le test agent est simple. Commencez par le bundle naturel de l'équipe, créez 5 à 10 concepts utiles, puis orientez la suite vers le cas détaillé le plus proche: data, marketing, support, sales, produit ou ops.

Portrait de Milan Boisgard, auteur du guide Open Knowledge Format

Auteur du guide

Milan BOISGARD

Product Builder IA & Context Engineer

Product Builder IA & Context Engineer, je vous aide à structurer le contexte de vos process dans votre entreprise pour améliorer l'efficacité de vos agents IA.