Cookwala-Strategie: Nachricht, Produkt, Website, Dokumentation, Developer Experience

Status: überarbeitet 2026-10-04 (v2). Deckt die Mission, Vision, Story, den Standard, die Website, Dokumentation, API und SDK, Demos, Community und Metriken ab. Es baut auf dem Aktionsplan (ACTION-PLAN.md), der Hintergrundgeschichte und der Gap-Liste (research/BACKSTORY.md), dem Architektur-Review (research/ARCHITECTURE-REVIEW.md), dem 23-Seiten-Benchmark (research/WEB-BENCHMARK.md), dem Stakeholder-Design (STAKEHOLDERS.md) und den Messaging-Regeln (MESSAGING.md) auf. Die Tabelle in Abschnitt 1 ist die Erstprüfung; der Benchmark ersetzt sie, sofern sie voneinander abweichen.

0. Zusammenfassung #

Cookwalas Aufgabe. Es ist der offene Weg, um jeder Küche (einer Person, einer food bank, einem Ofen oder einem humanoiden Roboter) mitzuteilen, was zubereitet werden soll, wann jeder Schritt abgeschlossen ist und was niemals passieren darf, und alle drei auf dem Gerät zu überprüfen.

Was sich ändert:

1. Message. Ersetzen Sie „the world's first and largest robot cooking recipes index and CLI“ und führen Sie mit dem Problem an, das jeder Roboterhersteller und jede Küche hat. Neuer One-Liner: "The open standard for cooking safely: people, kitchens and robots."
2. Story. Roboter werden bald in Haushalten kochen, aber niemand hat in einer Form, die eine Maschine prüfen kann, aufgeschrieben, was „fertig“ und „sicher“ bedeuten oder für welche Küchen. Cookwala begann mit den ägyptischen Rezepten einer Familie. Seine Mission ist es, Maschinen jede Küche sicher beizubringen und sicherzustellen, dass gutes Essen die Menschen erreicht.
3. Proof before promise. Live, echte Zähler. Now / next / later Labels. Veröffentlichte Kritiken.
4. Ein Kreislauf, den jeder versteht: Describe → Check → Cook → Learn.
5. Pfade nach Zielgruppe: Gerätehersteller, KI-Agent-Entwickler, Küchen und food banks, Köche, Forscher.
6. Code und eine Live-Demo auf dem ersten Bildschirm. In-Browser dry run („Kann dieses Gerät dieses Rezept kochen?“), die Simulatoren und Copy-Paste-Befehle, die heute funktionieren.
7. Developer Experience auf dem Niveau der besten KI- und Robotik-Dokumentationen: ein 5-Minuten- Quickstart, Dokumentationen organisiert als Tutorials, How-to-Guides, Referenz und Erklärungen, llms.txt, Copy-Page, ein Python-Paket und CLI, ein typed JS/TS SDK, ein MCP-Server, ein Reference hub, den man lokal ausführen kann, ein ROS 2 Paket und eine LeRobot Bridge.
8. Ein Contributor-Netzwerk (inspiriert von Figure's Index): Köche und Küchen tragen eingewilligte Aufnahmen echter Rezepte bei, damit Roboter jede Küche lernen, mit Anerkennung für die Menschen, die sie unterrichtet haben.

1. Was wir gelernt haben #

Muster, die die Besten teilen:

1. Ein Satz darüber, für wen es ist und was es tut.
2. Eine Schleife, die der Leser wiederkennt.
3. Funktionsfähiger Code oder eine Demo innerhalb eines Scrollvorgangs.
4. Einstiegspunkte nach Wahl (Pick-your-path).
5. Beweis (Zahlen, Nutzer, Governance).
6. Ehrlicher Status (Trust Center, Status-Seite, now/next).
7. Eine Community, der man heute beitreten kann.
8. Dokumentation, die sowohl für Menschen als auch für KI-Leser erstellt wurde (Copy-Seite, llms.txt, „Ask AI“).

2. Cookwala heute #

Stärken:

• Eine seltene, konkrete Idee: physische operation envelopes, sensor ladders, refusal statt Raten, auf dem Gerät erzwungene Sicherheit, verifizierbare Dokumente.
• Conformance-Vektoren, die zwei unabhängige Standardergebnisse einschließen (RFC 8785, RFC 8032).
• Vier spielbare Simulatoren.
• Ein humanitäres Profil, das ohne Roboter funktioniert.
• Ein echtes Rezept-Korpus (fifi.cooking) und eine Region mit einer Identität (Ägypten, die arabische Welt).
• Ein ungewöhnlich ehrlicher Kritik-und-Antwort-Verlauf.

Lücken:

3. Positionierung und Nachricht #

3.1 Kategorie und One-liner #

• Kategorie: ein offener Standard (mit kostenlosen Tools und einem Index) für ausführbares, verifizierbares Kochen.
• One-liner: Cookwala ist der offene Standard für sicheres Kochen: Menschen, Küchen und Roboter.
• Triad, überall verwendet:
  • Was zubereitet werden soll. Rezepte als Schritte, die eine Maschine planen kann.
  • Wann es fertig ist. Messbare Endbedingungen: Temperaturen, Hinweise zum Lebensmittelzustand, Zeiten.
  • Was niemals passieren darf. Sicherheitsgrenzwerte, die das Gerät selbst erzwingt.

3.2 Mission und Vision (überarbeitet) #

• Mission: Helfen Sie jedem, gut, sicher, erschwinglich und ohne Verschwendung zu essen, wer auch immer das Kochen übernimmt.
• Vision: Jede Küche auf der Erde kann jedes Rezept sicher kochen, und gutes Essen erreicht die Menschen, anstatt im Müll zu landen.
• Warum die Änderung: "end world hunger" bleibt als langfristiger Grund bestehen, untermauert durch Belege. Cookwala trägt dazu durch weniger Verschwendung, Food Rescue und günstigeres Kochen bei, neben den Programmen, der Finanzierung und der Politik, die Hunger bekämpfen.

3.3 Die Geschichte #

Heimroboter kommen an: Figure 03, 1X NEO und Küchenroboter werden ausgeliefert oder nehmen Bestellungen entgegen. Sie lernen sich zu bewegen, aber niemand hat auf eine Weise aufgeschrieben, die eine Maschine prüfen kann, was „simmer“ bedeutet, wann Hähnchen sicher ist oder wie die Molokhia einer Großmutter zubereitet wird. Jeder Hersteller schreibt seine eigenen geschlossenen Rezepte, meist aus nur wenigen Küchen.

Cookwala begann mit den ägyptischen Hausrezepten einer Familie auf fifi.cooking und stellte eine einfache Frage: Wie übergibt man einer Maschine ein Rezept und weiß, dass sie es sicher zubereiten wird?

Die Antwort ist ein offener Standard. Er besagt, was zubereitet werden soll, wann jeder Schritt abgeschlossen ist und was niemals passieren darf. Das Gerät prüft dies, bevor es etwas aufheizt, und verweigert die Ausführung, anstatt zu raten. Die gleichen Rezepte funktionieren heute für Menschen und food banks, und sie werden es Robotern morgen ermöglichen, jede Küche der Erde zu erlernen, mit Anerkennung für die Köche, die sie unterrichtet haben.

(Der Gründer sollte den Ursprungssatz bestätigen und personalisieren. Authentizität schlägt Perfektion.)

3.4 Message house #

3.5 Sprachregeln #

• Verwenden: recipe, step, done, safe, check, refuse, kitchen, cook, open, verify, consent.
• Vermeiden: "revolutionary", "first and largest" (bis es wahr ist), "end hunger" (als Schlagzeile), "AI-powered" (vage).
• Beschriften Sie jede Zahl als measured, modelled oder assumed.
• Sagen Sie "now / next / later", anstatt zu implizieren, dass etwas existiert, wenn es das nicht tut.

4. Zielgruppen und ihr erster Erfolg #

5. Produktarchitektur: was Cookwala bietet #

6. Website #

6.1 Sitemap #

/                 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 Startseite, von oben nach unten #

6.3 Designrichtung #

• Gefühl: ruhig, präzise, warm. Ein professionelles Instrument mit einer Küchenseele.
• Typografie: eine präzise Grotesk für das UI und eine Mono-Schrift für Daten und Code. Große, leichte Display-Schrift für den Hero (angelehnt an die Souveränität von Figure), ohne dessen filmische Dunkelheit zu kopieren.
• Farbe: neutrales Papier und Tinte mit einem Hitze-Akzent (Glut-Orange), der auch Temperaturdaten markiert. Die Palette ist für farbenblinde Leser validiert, und sowohl helle als auch dunkle Themes sind konzipiert.
• Bildsprache: echte Hände und echte heimische Küchen, sobald wir diese haben, niemals Stock-Roboter. Bis dahin tragen Diagramme und die Live-Demo die Seite.
• Bewegung: ein Moment, der schrittweise dry run. Alles andere ist statisch.
• Von Beginn an zweisprachig: Englisch und Arabisch (Rechts-nach-Links-Layout), dann weitere.
• Barrierefreiheit: WCAG 2.2 AA; Tastatur; reduzierte Bewegung; keine Informationen allein durch Farbe.

6.4 Interaktivität #

1. In-Browser dry run (Rezept × Gerät).
2. Envelope explorer: ziehen Sie eine Temperaturkurve und sehen Sie, wann sie „simmer“ verlässt.
3. Simulatoren, mit aktiviertem oder deaktiviertem Protokoll.
4. Rezeptschritt-Viewer: der Satz eines Schritts, sein JSON und seine envelope nebeneinander.
5. Later: ein Rezepteditor, der während der Eingabe validiert.

7. Dokumentation #

Organisiert nach dem Diátaxis-Framework, sodass jede Seite eine Aufgabe hat:

Docs-Ergonomie:

• linke Navigation, Suche, „Seite kopieren“, „Auf GitHub bearbeiten“, Vorherige/Nächste-Links;
• Sprach-Tabs (Python / JavaScript / cURL / CLI);
• llms.txt und pro Seite Markdown für KI-Reader;
• ein Cheat Sheet und eine Seite für häufige Probleme;
• ein Changelog mit Daten.

8. API und SDK #

9. Demos #

10. Community und Wachstum #

• Contributor-Netzwerk (inspiriert von Figure's Index):
  • Köche protokollieren eingewilligte Sessions von Rezepten, die sie kennen, mit Nennung auf jeder Rezept- und Dataset-Card.
  • Küchen und food banks Pilotprojekt.
  • Maker implementieren Geräte.
  • Reviewer prüfen rule packs und envelopes.
  • Übersetzer übersetzen Schritte und Vokabular.
  • Bezahlte Beiträge kommen later, finanziert durch Zuschüsse. Bezahlen Sie niemals für Daten ohne informierte Einwilligung und faire Bedingungen.
• Rituale: monatlicher Community-Call; vierteljährlicher „State of Cookwala“ mit realen Zahlen; öffentliche Review-Threads.
• Partnerschaftssequenz: die ersten zehn aus dem Stakeholder-Tracker (food bank, WFP Innovation Accelerator, Home Assistant, ein Geräte-Startup, ein Universitätslabor, ein Certifier, World Central Kitchen, eine Stiftung, ein neutrales Zuhause, ein Creator).
• Kanäle: GitHub Discussions, ein Newsletter, Konferenzvorträge (ROSCon, IROS/ICRA Workshops, Food-Tech-Events), arabischsprachige Kanäle.

11. Metriken #

• North-star metric: verified cooks, die Anzahl der executions, die ein signiertes Cookwala-Rezept end-to-end mit einem consented, conforming log ausgeführt haben. Solange dies null ist, tracke leading indicators.

12. Roadmap #

Die gepflegte Roadmap mit einem Status pro Element ist [ROADMAP.md](ROADMAP.md). Die folgende Tabelle ist der ursprüngliche 180-Tage-Plan, der zur Dokumentation aufbewahrt wird.

13. Risiken für diese Strategie #