Estrategia de Cookwala: mensaje, producto, sitio web, docs, experiencia del desarrollador

Status: revisado 2026-10-04 (v2). Cubre la misión, visión, historia, estándar, sitio web, documentación, API y SDK, demostraciones, comunidad y métricas. Se basa en el plan de acción (ACTION-PLAN.md), la historia de fondo y la lista de brechas (research/BACKSTORY.md), la revisión de arquitectura (research/ARCHITECTURE-REVIEW.md), el benchmark de 23 sitios (research/WEB-BENCHMARK.md), el diseño de partes interesadas (STAKEHOLDERS.md) y las reglas de mensajería (MESSAGING.md). La tabla de la Sección 1 es el estudio de primera pasada; el benchmark lo reemplaza donde difieren.

0. Resumen #

El trabajo de Cookwala. Es la forma abierta de decirle a cualquier cocina (una persona, un food bank, un horno o un robot humanoide) qué hacer, cuándo se completa cada paso y qué es lo que nunca debe suceder, y verificar las tres cosas en el dispositivo.

Qué cambios:

1. Message. Retire "the world's first and largest robot cooking recipes index and CLI" y lidere con el problema que tiene cada fabricante de robots y cada cocina. Nuevo eslogan: "The open standard for cooking safely: people, kitchens and robots."
2. Story. Los robots están a punto de cocinar en los hogares, pero nadie ha escrito, en una forma que una máquina pueda verificar, lo que significan "listo" y "seguro", o en qué cocinas. Cookwala comenzó a partir de las recetas egipcias de una familia. Su misión es enseñar a las máquinas cada cocina de forma segura, y asegurar que la buena comida llegue a las personas.
3. Proof before promise. Contadores reales y en vivo. Etiquetas now / next / later. Críticas publicadas.
4. One loop everyone understands: Describe → Check → Cook → Learn.
5. Paths by audience: fabricantes de dispositivos, constructores de agentes de IA, cocinas y food banks, cocineros, investigadores.
6. Code and a live demo on the first screen. dry run en el navegador ("¿Puede este dispositivo cocinar esta receta?"), los simuladores, y comandos de copiar y pegar que funcionan hoy.
7. Developer experience at the level of the best AI and robotics docs: un quickstart de 5 minutos, docs organizadas como tutoriales, guías de cómo hacerlo, referencia y explicación, llms.txt, copy-page, un paquete de Python y CLI, un SDK de JS/TS tipado, un servidor MCP, un reference hub que puedes ejecutar localmente, un paquete de ROS 2, y un puente LeRobot.
8. A contributor network (inspirado en el Index de Figure): cocineros y cocinas contribuyen con grabaciones consentidas de recetas reales, para que los robots aprendan cada cocina, con crédito para las personas que les enseñaron.

1. Lo que aprendimos #

Patrones compartidos por los mejores:

1. Una oración sobre para quién es y qué hace.
2. Un bucle que el lector reconoce.
3. Código funcional o una demo dentro de un solo scroll.
4. Puntos de entrada de elección de ruta.
5. Prueba (números, usuarios, gobernanza).
6. Estado honesto (centro de confianza, página de estado, now/next).
7. Comunidad a la que puedes unirte hoy.
8. Docs construidos tanto para personas como para lectores de IA (página de copia, llms.txt, "Ask AI").

2. Cookwala hoy #

Fortalezas:

• Una idea rara y concreta: operation envelopes físicos, sensor ladders, refusal en lugar de conjeturas, seguridad aplicada en el dispositivo, documentos verificables.
• Vectores de conformance que incluyen dos resultados de estándares independientes (RFC 8785, RFC 8032).
• Cuatro simuladores jugables.
• Un perfil humanitario que funciona sin robots.
• Un corpus de recetas real (fifi.cooking) y una región con identidad (Egipto, el mundo árabe).
• Un registro de crítica y respuesta inusualmente honesto.

Gaps:

3. Posicionamiento y mensaje #

3.1 Categoría y descripción breve #

• Categoría: un estándar abierto (con herramientas gratuitas y un índice) para una cocina ejecutable y verificable.
• Descripción breve: Cookwala es el estándar abierto para cocinar de forma segura: personas, cocinas y robots.
• Triada, utilizada en todas partes:
  • Qué hacer. Recetas como pasos que una máquina puede planificar.
  • Cuándo está listo. Condiciones finales medibles: temperaturas, señales del estado de los alimentos, tiempos.
  • Qué nunca debe suceder. Límites de seguridad que el dispositivo impone por sí mismo.

3.2 Misión y visión (revisado) #

• Misión: Ayudar a que todos coman bien, de forma segura, asequible y sin desperdicios, sea quien sea que cocine.
• Visión: Cualquier cocina en la Tierra puede cocinar cualquier receta de forma segura, y la buena comida llega a las personas en lugar del cubo de basura.
• Por qué el cambio: "end world hunger" se mantiene como la razón a largo plazo, explicada con evidencia. Cookwala contribuye a ello mediante menos desperdicios, rescate de alimentos y cocina más barata, junto con los programas, la financiación y las políticas que el hambre necesita.

3.3 La historia #

Los robots domésticos están llegando: Figure 03, 1X NEO y los robots de cocina se están enviando o aceptando pedidos. Están aprendiendo a moverse, pero nadie ha escrito, de una manera que una máquina pueda verificar, qué significa "simmer", cuándo el pollo es seguro, o cómo se hace la molokhia de una abuela. Cada fabricante escribe sus propias recetas cerradas, principalmente de unas pocas cocinas.

Cookwala comenzó con las recetas caseras egipcias de una familia en fifi.cooking y planteó una pregunta sencilla: ¿cómo se le entrega una receta a una máquina y se sabe que la cocinará de forma segura?

La respuesta es un estándar abierto. Indica qué hacer, cuándo se completa cada paso y qué es lo que nunca debe suceder. El dispositivo lo comprueba antes de calentar nada, y aplica un refusal before heat en lugar de adivinar. Las mismas recetas funcionan para las personas y los food banks hoy, y permitirán que los robots aprendan cada cocina de la Tierra mañana, dando crédito a los cocineros que les enseñaron.

(El fundador debe confirmar y personalizar la oración de origen. Lo auténtico supera a lo pulido.)

3.4 Casa de mensajes #

3.5 Reglas de lenguaje #

• Usar: recipe, step, done, safe, check, refuse, kitchen, cook, open, verify, consent.
• Evitar: "revolutionary", "first and largest" (hasta que sea cierto), "end hunger" (como titular), "AI-powered" (vago).
• Etiquetar cada número como measured, modelled o assumed.
• Decir "now / next / later" en lugar de implicar que algo existe cuando no es así.

4. Audiencias y su primer éxito #

5. Arquitectura del producto: lo que ofrece Cookwala #

6. Sitio web #

6.1 Mapa del sitio #

/                 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 Página de inicio, de arriba a abajo #

6.3 Dirección de diseño #

• Sensación: calmada, precisa, cálida. Un instrumento profesional con alma de cocina.
• Tipo: una grotesque precisa para la UI y una mono face para datos y código. Tipo de letra de visualización grande y ligera para el hero (tomando prestada la confianza de Figure), sin copiar su oscuridad cinematográfica.
• Color: papel y tinta neutros con un acento de calor (naranja brasa) que también marca los datos de temperatura. La paleta está validada para lectores con daltonismo, y se diseñan tanto temas claros como oscuros.
• Imaginería: manos reales y cocinas domésticas reales una vez que las tengamos, nunca robots de stock. Hasta entonces, los diagramas y la demo en vivo sostienen la página.
• Movimiento: un momento, el dry run paso a paso. Todo lo demás está estático.
• Bilingüe desde el principio: inglés y árabe (diseño de derecha a izquierda), luego otros.
• Accesibilidad: WCAG 2.2 AA; teclado; movimiento reducido; sin información solo por color.

6.4 Interactividad #

1. dry run en el navegador (receta × dispositivo).
2. Explorador de la operation envelope: arrastra un trazo de temperatura y observa cuándo sale de "simmer".
3. Simuladores, con el protocolo encendido y apagado.
4. Visor de pasos de la receta: la oración de un paso, su JSON y su envelope lado a lado.
5. Later: un editor de recetas que valida mientras escribes.

7. Documentación #

Organizado por el marco de trabajo Diátaxis, de modo que cada página tiene un solo trabajo:

Ergonomía de la documentación:

• navegación izquierda, búsqueda, "Copy page", "Edit on GitHub", enlaces previous/next;
• pestañas de lenguaje (Python / JavaScript / cURL / CLI);
• llms.txt y markdown por página para lectores de IA;
• una cheat sheet y una página de problemas comunes;
• un changelog con fechas.

8. API y SDK #

9. Demos #

10. Comunidad y crecimiento #

• Red de contribuyentes (inspirada en el Index de Figure):
  • Los cocineros registran sesiones consentidas de recetas que conocen, con crédito en cada receta y tarjeta de conjunto de datos.
  • Piloto de cocinas y food banks.
  • Los fabricantes implementan dispositivos.
  • Los revisores revisan rule packs y envelopes.
  • Los traductores traducen pasos y vocabulario.
  • Las contribuciones pagadas llegan later, financiadas por subvenciones. Nunca pague por datos sin consentimiento informado y términos justos.
• Rituales: llamada comunitaria mensual; "estado de Cookwala" trimestral con números reales; hilos de revisión pública.
• Secuencia de asociación: los primeros diez del rastreador de partes interesadas (food bank, WFP Innovation Accelerator, Home Assistant, una startup de dispositivos, un laboratorio universitario, un certificador, World Central Kitchen, una fundación, un hogar neutral, un creador).
• Canales: GitHub Discussions, un boletín informativo, charlas en conferencias (ROSCon, talleres de IROS/ICRA, eventos de food-tech), canales en lengua árabe.

11. Métricas #

• Métrica North-star: verified cooks, el número de ejecuciones que ejecutaron una receta Cookwala firmada de principio a fin con un log conforme y consentido. Mientras eso sea cero, rastrear indicadores adelantados.

12. Hoja de ruta #

La hoja de ruta mantenida con un estado por elemento es [ROADMAP.md](ROADMAP.md). La tabla de abajo es el plan original de 180 días, conservado para el registro.

13. Riesgos para esta estrategia #