Stratégie Cookwala : message, produit, site web, docs, expérience développeur

Status : révisé 2026-10-04 (v2). Couvre la mission, la vision, l'histoire, la norme, le site web, la documentation, l'API et le SDK, les démos, la communauté et les métriques. Il s'appuie sur le plan d'action (ACTION-PLAN.md), l'histoire et la liste des lacunes (research/BACKSTORY.md), la revue d'architecture (research/ARCHITECTURE-REVIEW.md), le benchmark de 23 sites (research/WEB-BENCHMARK.md), la conception des parties prenantes (STAKEHOLDERS.md) et les règles de messagerie (MESSAGING.md). Le tableau de la section 1 est l'étude de première passe ; le benchmark le remplace lorsqu'ils diffèrent.

0. Résumé #

Le travail de Cookwala. C'est la méthode ouverte pour dire à n'importe quelle cuisine (une personne, un food bank, un four ou un robot humanoïde) quoi préparer, quand chaque étape est terminée, et ce qui ne doit jamais arriver, et pour vérifier ces trois éléments sur l'appareil.

Ce qui change :

1. Message. Retirez "the world's first and largest robot cooking recipes index and CLI" et commencez par le problème auquel chaque fabricant de robots et chaque cuisine est confronté. Nouveau slogan : "L'étalon ouvert pour cuisiner en toute sécurité : les personnes, les cuisines et les robots."
2. Story. Les robots sont sur le point de cuisiner dans les foyers, mais personne n'a consigné, sous une forme qu'une machine peut vérifier, ce que signifient "cuit" et "sûr", ou dans quelles cuisines. Cookwala est parti des recettes égyptiennes d'une seule famille. Sa mission est d'enseigner aux machines chaque cuisine en toute sécurité, et de s'assurer que de la bonne nourriture parvienne aux gens.
3. Proof before promise. Des compteurs réels et en direct. Étiquettes now / next / later. Critiques publiées.
4. Une boucle que tout le monde comprend : Describe → Check → Cook → Learn.
5. Paths par audience : fabricants d'appareils, constructeurs d'agents IA, cuisines et food banks, cuisiniers, chercheurs.
6. Code et une démo en direct sur le premier écran. dry run dans le navigateur ("Cet appareil peut-il cuisiner cette recette ?"), les simulateurs, et des commandes à copier-coller qui fonctionnent aujourd'hui.
7. Expérience développeur au niveau des meilleures docs d'IA et de robotique : un quickstart de 5 minutes, des docs organisées en tutoriels, guides pratiques, référence et explication, llms.txt, copy-page, un package Python et CLI, un SDK JS/TS typé, un serveur MCP, un hub de référence que vous pouvez exécuter localement, un package ROS 2, et un pont LeRobot.
8. Un réseau de contributeurs (inspiré par l'Index de Figure) : les cuisiniers et les cuisines contribuent avec des enregistrements consentis de vraies recettes, afin que les robots apprennent chaque cuisine, avec crédit aux personnes qui leur ont enseigné.

1. Ce que nous avons appris #

Modèles partagés par les meilleurs :

1. Une phrase sur qui cela s'adresse et ce que cela fait.
2. Une boucle que le lecteur reconnaît.
3. Du code fonctionnel ou une démo en un seul défilement.
4. Des points d'entrée au choix.
5. Des preuves (chiffres, utilisateurs, gouvernance).
6. Un statut honnête (centre de confiance, page de statut, now/next).
7. Une communauté que l'on peut rejoindre dès aujourd'hui.
8. Des docs conçus pour les humains et les lecteurs IA (page de copie, llms.txt, "Ask AI").

2. Cookwala aujourd'hui #

Forces :

• Une idée rare et concrète : operation envelopes physiques, sensor ladders, refusal au lieu de deviner, sécurité appliquée sur l'appareil, documents vérifiables.
• Des vecteurs de conformance qui incluent deux résultats de standards indépendants (RFC 8785, RFC 8032).
• Quatre simulateurs jouables.
• Un profil humanitaire qui fonctionne sans robots.
• Un véritable corpus de recettes (fifi.cooking) et une région avec une identité (l'Égypte, le monde arabe).
• Un historique de critique-et-réponse inhabituellement honnête.

Lacunes :

3. Positionnement et message #

3.1 Catégorie et résumé #

• Catégorie : un standard ouvert (avec des outils gratuits et un index) pour une cuisine exécutable et vérifiable.
• Résumé : Cookwala est le standard ouvert pour cuisiner en toute sécurité : les personnes, les cuisines et les robots.
• Triade, utilisée partout :
  • Ce qu'il faut préparer. Des recettes sous forme d'étapes qu'une machine peut planifier.
  • Quand c'est prêt. Des conditions de fin mesurables : températures, indices d'état de l'aliment, durées.
  • Ce qui ne doit jamais arriver. Des limites de sécurité que l'appareil applique lui-même.

3.2 Mission et vision (révisé) #

• Mission : Aider tout le monde à bien manger, en toute sécurité, à moindre coût et sans gaspillage, peu importe qui fait la cuisine.
• Vision : N'importe quelle cuisine sur Terre peut cuisiner n'importe quelle recette en toute sécurité, et la bonne nourriture atteint les gens au lieu de la poubelle.
• Pourquoi le changement : "end world hunger" reste la raison à long terme, étayée par des preuves. Cookwala y contribue par moins de gaspillage, le sauvetage alimentaire et une cuisine moins chère, aux côtés des programmes, du financement et des politiques dont la faim a besoin.

3.3 L'histoire #

Les robots domestiques arrivent : Figure 03, 1X NEO et les robots de cuisine sont en cours d'expédition ou prennent des commandes. Ils apprennent à se déplacer, mais personne n'a écrit, d'une manière qu'une machine puisse vérifier, ce que signifie « simmer », quand le poulet est sûr, ou comment se prépare la molokhia d'une grand-mère. Chaque fabricant écrit ses propres recettes fermées, provenant principalement de quelques cuisines.

Cookwala est parti des recettes maison égyptiennes d'une famille sur fifi.cooking et a posé une question simple : comment transmettre une recette à une machine, et savoir qu'elle la cuira en toute sécurité ?

La réponse est un standard ouvert. Il indique quoi préparer, quand chaque étape est terminée, et ce qui ne doit jamais arriver. L'appareil le vérifie avant de chauffer quoi que ce soit, et refuse plutôt que de deviner. Les mêmes recettes fonctionnent pour les gens et les food banks aujourd'hui, et elles permettront aux robots d'apprendre chaque cuisine sur Terre demain, en rendant crédit aux cuisiniers qui les ont enseignées.

(Le fondateur doit confirmer et personnaliser la phrase d'origine. L'authentique l'emporte sur le poli.)

3.4 Message house #

3.5 Règles de langage #

• Utiliser : recette, étape, terminé, sûr, vérifier, refuser, cuisine, cuisiner, ouvrir, vérifier, consentement.
• Éviter : « révolutionnaire », « premier et le plus grand » (jusqu'à ce que ce soit vrai), « mettre fin à la faim » (en tant que titre), « propulsé par l'IA » (vague).
• Étiqueter chaque nombre comme measured, modelled ou assumed.
• Dire « now / next / later » au lieu d'impliquer que quelque chose existe quand ce n'est pas le cas.

4. Audiences et leur premier succès #

5. Architecture du produit : ce que Cookwala offre #

6. Site Web #

6.1 Plan du site #

/                 Home: one sentence, triad, live dry run, pathfinder, loop, proof, now/next/later
/why/             Why Cookwala: the problem, the story, the three goals told honestly
/impact/          Hunger, health, environment, economy, culture; every number labelled; what we don't know
/for/<group>/     One page per stakeholder group (developers, companies, providers, food, humanitarian,
                  health, education, government, capital, thought, everyone): message, options, first
                  success, flow, how it advances their work and society
/developers/      Quickstart, docs, API reference, SDKs, CLI, conformance, bindings, evals
/docs/            Documentation (rendered pages; /docs/?p=NAME keeps working)
/playground/      Live dry run with a device builder and shareable results, envelope explorer, simulators explained
/sim/...          Home, city, country, world simulators (unchanged URLs)
/registry/        Browse recipes, devices, rule packs, extensions, benchmarks; publish flow; directory of organizations (empty-state ready)
/humanitarian/    Food banks and kitchens: profile, SMS walkthrough, four flows, pilot protocol, concept note
/farmers/         Surplus by SMS; fair signals (next, after counsel review)
/education/       Lesson kit, research topics, open problems
/policy/          Brief and model language
/investors/       Opportunity, timing, business model, roadmap, risks, governance; no financial promises
/whitepaper/      Web and PDF
/deck/            12 to 15 slides, keyboard-navigable, shareable
/ideas/           Essays for thinkers
/trust/           Safety, privacy, security, governance, critiques, conformance, status
/roadmap/         Now / next / later with a status on every item
/contribute/      RFCs, translation, vectors, recipes, reviews; community; contact
/ar/...           Every page above in Arabic, right-to-left
/.well-known/     cookwala.json, security.txt · /llms.txt · /v1/...

6.2 Page d'accueil, de haut en bas #

6.3 Direction de conception #

• Ressenti : calme, précis, chaleureux. Un instrument professionnel avec une âme de cuisine.
• Type : une grotesque précise pour l'UI et une mono face pour les données et le code. Une typographie d'affichage large et légère pour le hero (empruntant l'assurance de Figure), sans copier son obscurité cinématographique.
• Couleur : papier et encre neutres avec un accent thermique (orange braise) qui marque également les données de température. La palette est validée pour les lecteurs daltoniens, et les thèmes clair et sombre sont tous deux conçus.
• Imagerie : de vraies mains et de vraies cuisines domestiques une fois que nous les aurons, jamais de robots de banque d'images. D'ici là, les diagrammes et la démo en direct portent la page.
• Mouvement : un moment, le dry run étape par étape. Tout le reste est immobile.
• Bilingue dès le départ : anglais et arabe (mise en page de droite à gauche), puis d'autres.
• Accessibilité : WCAG 2.2 AA ; clavier ; mouvement réduit ; aucune information par la seule couleur.

6.4 Interactivité #

1. dry run dans le navigateur (recette × appareil).
2. Explorateur d'enveloppe : faites glisser une trace de température et voyez quand elle quitte "simmer".
3. Simulateurs, avec le protocole activé ou désactivé.
4. Visionneuse d'étape de recette : la phrase d'une étape, son JSON et son enveloppe côte à côte.
5. Later : un éditeur de recette qui valide au fur et à mesure de la saisie.

7. Documentation #

Organisé selon le framework Diátaxis, de sorte que chaque page a une mission unique :

Ergonomie des docs :

• navigation à gauche, recherche, « Copy page », « Edit on GitHub », liens précédent/suivant ;
• onglets de langue (Python / JavaScript / cURL / CLI) ;
• llms.txt et markdown par page pour les lecteurs IA ;
• un aide-mémoire et une page sur les problèmes courants ;
• un changelog avec dates.

8. API et SDK #

9. Démos #

10. Communauté et croissance #

• Réseau de contributeurs (inspiré par Figure's Index) :
  • Les Cooks enregistrent des sessions consenties de recettes qu'ils connaissent, avec un crédit sur chaque recette et dataset card.
  • Pilote de Kitchens and food banks.
  • Les Makers implémentent les appareils.
  • Les Reviewers révisent les rule packs et les envelopes.
  • Les Translators traduisent les étapes et le vocabulaire.
  • Les contributions rémunérées arrivent later, financées par des subventions. Ne payez jamais pour des données sans consentement éclairé et des conditions équitables.
• Rituels : appel communautaire mensuel ; « état de Cookwala » trimestriel avec des chiffres réels ; fils de discussion publics.
• Séquence de partenariat : les dix premiers du stakeholder tracker (food bank, WFP Innovation Accelerator, Home Assistant, une startup d'appareils, un laboratoire universitaire, un certifier, World Central Kitchen, une fondation, un home neutre, un creator).
• Canaux : GitHub Discussions, une newsletter, des conférences (ROSCon, ateliers IROS/ICRA, événements food-tech), des canaux en langue arabe.

11. Métriques #

• North-star metric : verified cooks, le nombre d'executions ayant exécuté une recette Cookwala signée de bout en bout avec un log consenti et conforme. Tant que celui-ci est à zéro, suivez les indicateurs avancés.

12. Feuille de route #

La feuille de route maintenue avec un statut par élément est [ROADMAP.md](ROADMAP.md). Le tableau ci-dessous est le plan original de 180 jours, conservé pour archive.

13. Risques pour cette stratégie #