Ressources OKF : sources officielles, samples, vidéos et glossaire pour aller plus loin

Comment utiliser cette page ressources ?

Toutes les ressources ne jouent pas le même rôle. Une spec officielle sert à vérifier une règle. Un sample bundle sert à voir une structure réelle. Une vidéo sert à comprendre plus vite, mais ne doit pas devenir la source d'autorité pour une affirmation technique.

La règle de lecture est donc simple: commencez par les sources primaires, utilisez les samples pour apprendre par imitation, puis gardez les contenus secondaires pour enrichir votre intuition.

Si vous devez trancher une question de conformité, revenez à `SPEC.md`. Si vous voulez comprendre l'intention du format, lisez l'annonce Google Cloud. Si vous voulez passer à l'action, ouvrez les samples et comparez-les à votre futur premier bundle.

Les sources primaires à lire en premier

Les sources primaires sont celles à privilégier pour expliquer OKF publiquement. Elles fixent le vocabulaire, le niveau de maturité du format et les règles minimales à respecter.

Pour une première lecture, commencez par l'article Google Cloud pour comprendre le problème du contexte fragmenté, puis passez à `SPEC.md` pour vérifier la définition formelle des bundles, concept files, liens, citations et règles de conformité.

Le README et le repo complètent cette lecture: ils montrent les outils disponibles, les samples, le reference agent et le visualizer. Ils rappellent aussi que les outils sont des preuves de concept utiles, pas des dépendances obligatoires du format.

Le repo officiel : spec, README, samples et visualizer

Le repo officiel est le meilleur endroit pour passer de la théorie au concret. Il permet de voir comment OKF est organisé dans un projet réel: dossier `okf`, spec, README, samples, bundles, visualizer et éléments d'outillage.

Pour un builder, le bon réflexe consiste à ouvrir un sample bundle, inspecter `index.md`, regarder quelques concept files, puis observer comment les liens construisent une carte de connaissance.

Le visualizer est particulièrement utile pour comprendre la promesse pédagogique d'OKF: les fichiers restent du Markdown, mais leurs liens peuvent être explorés comme un graphe.

Les sample bundles : apprendre par l'exemple

Les samples sont essentiels parce qu'ils montrent la forme réelle d'un bundle. Ils aident à comprendre comment découper les dossiers, nommer les fichiers, structurer `index.md` et faire cohabiter datasets, tables, références et visualisation.

Il ne faut pas copier leur architecture telle quelle. Un bundle data, support ou marketing doit rester adapté à son domaine. Les samples servent à observer les patterns: granularité, liens, citations, fichiers de référence et progressive disclosure.

Le bon exercice consiste à ouvrir un sample, puis à écrire la même structure pour votre cas: quelles seraient vos tables, vos métriques, vos policies, vos sources, vos playbooks et vos décisions ?

Les ressources connexes : LLM-wiki, AGENTS.md et CLAUDE.md

OKF n'arrive pas dans le vide. Il formalise un mouvement plus large: donner aux agents une mémoire structurée, lisible, maintenable et versionnable.

Le pattern LLM-wiki d'Andrej Karpathy aide à comprendre l'idée de wiki maintenu avec l'aide d'agents. `AGENTS.md` et `CLAUDE.md` montrent un autre angle: des fichiers de contexte qui orientent le comportement d'un agent dans un projet.

La différence à garder en tête: ces ressources expliquent des pratiques proches, mais OKF vise un format de connaissances portable. Elles doivent donc être lues comme contexte historique et pratique, pas comme des règles OKF.

ARD et visibilité agentique : à lire sans confondre avec OKF

ARD est une ressource importante, mais elle ne décrit pas le même objet que OKF. OKF structure la connaissance. ARD décrit une couche de découverte pour des ressources agentiques: APIs, agents, MCP servers, workflows ou autres capacités appelables.

Le lien entre les deux est prospectif et architectural: un bundle OKF peut documenter le contexte qu'une capacité utilise, tandis qu'un catalogue ARD peut rendre cette capacité découvrable via `ai-catalog.json` et des mécanismes de confiance.

Cette distinction évite une confusion fréquente: OKF ne remplace pas ARD, et ARD ne remplace pas OKF. Ils peuvent devenir complémentaires dans une architecture agent-ready.

SEO et contenu utile : garder les fondamentaux

OKF ne doit pas être présenté comme un signal SEO direct confirmé. Les ressources SEO officielles restent indispensables pour garder une base saine: pages indexables, contenu utile, maillage, structure claire et données structurées quand elles sont pertinentes.

La bonne lecture est indirecte: OKF peut aider à structurer les entités, les preuves, les sources et les relations qu'une équipe marketing ou un agent de contenu utilise pour produire un contenu plus cohérent.

Pour tout ce qui concerne Google Search, privilégiez les sources Google Search Central. Les vidéos sur entity maps et OKF sont utiles pour explorer des pistes, mais elles restent secondaires.

Vidéos utiles : bonnes portes d'entrée, mais sources secondaires

Les vidéos sont utiles pour accélérer la compréhension, surtout quand elles illustrent un schéma mental: second brain, LLM-wiki, OKF vs RAG, entity maps ou visibilité agentique.

Elles doivent cependant rester des sources secondaires. Si une vidéo affirme quelque chose sur la spec, la règle à suivre est simple: vérifier dans `SPEC.md`, le README ou l'annonce Google Cloud.

Leur meilleur usage est pédagogique: aider un lecteur à comprendre pourquoi OKF mérite attention, puis le ramener vers les sources primaires pour passer à l'action.

Ordre de lecture recommandé selon votre profil

Tout le monde n'a pas besoin de lire les ressources dans le même ordre. Un décideur doit comprendre l'enjeu stratégique. Un builder doit ouvrir la spec. Une équipe data doit regarder les samples. Une équipe marketing doit croiser OKF avec les fondamentaux SEO.

Le meilleur parcours est celui qui mène rapidement à une action: choisir un premier périmètre, ouvrir un sample, écrire un concept, ou tester une question agent.

Glossaire OKF

Ce glossaire donne des définitions courtes pour relire le guide plus vite. Il ne remplace pas la spec, mais aide à stabiliser le vocabulaire.

Lire ensuite

Après avoir identifié les bonnes ressources, revenez aux pages pratiques: définition, bundle, concept, exemples, outils, checklist ou prochaines étapes selon votre niveau d'avancement.