Estratégia Cookwala: mensagem, produto, website, docs, experiência do desenvolvedor

Status: revisado 2026-10-04 (v2). Abrange a missão, visão, história, padrão, website, documentação, API e SDK, demos, comunidade e métricas. Baseia-se no plano de ação (ACTION-PLAN.md), na história de fundo e lista de lacunas (research/BACKSTORY.md), na revisão de arquitetura (research/ARCHITECTURE-REVIEW.md), no benchmark de 23 sites (research/WEB-BENCHMARK.md), no design de stakeholders (STAKEHOLDERS.md) e nas regras de mensagens (MESSAGING.md). A tabela da Seção 1 é o estudo de primeira passagem; o benchmark o substitui onde eles diferem.

0. Resumo #

O trabalho da Cookwala. É a maneira aberta de dizer a qualquer cozinha (uma pessoa, um food bank, um forno ou um robô humanoide) o que fazer, quando cada etapa é concluída e o que nunca deve acontecer, e verificar todos os três no dispositivo.

O que muda:

1. Message. Retire "the world's first and largest robot cooking recipes index and CLI" e comece com o problema que todo fabricante de robôs e cozinha possui. Novo slogan: "The open standard for cooking safely: people, kitchens and robots."
2. Story. Robôs estão prestes a cozinhar em casas, mas ninguém escreveu, de uma forma que uma máquina possa verificar, o que "pronto" e "seguro" significam, ou em quais culinárias. A Cookwala começou a partir das receitas egípcias de uma família. Sua missão é ensinar às máquinas cada culinária de forma segura, e garantir que comida boa chegue às pessoas.
3. Proof before promise. Contadores reais e ao vivo. Rótulos now / next / later. Críticas publicadas.
4. One loop everyone understands: Describe → Check → Cook → Learn.
5. Paths by audience: fabricantes de dispositivos, construtores de agentes de IA, cozinhas e food banks, cozinheiros, pesquisadores.
6. Code and a live demo on the first screen. dry run no navegador ("Can this device cook this recipe?"), os simuladores, e comandos de copiar e colar que funcionam hoje.
7. Developer experience at the level of the best AI and robotics docs: um quickstart de 5 minutos, docs organizados como tutoriais, guias de como fazer, referência e explicação, llms.txt, copy-page, um pacote Python e CLI, um SDK JS/TS tipado, um servidor MCP, um hub de referência que você pode rodar localmente, um pacote ROS 2, e uma ponte LeRobot.
8. A contributor network (inspirado no Index da Figure): cozinheiros e cozinhas contribuem com gravações consentidas de receitas reais, para que os robôs aprendam cada culinária, com crédito às pessoas que os ensinaram.

1. O que aprendemos #

Padrões compartilhados pelos melhores:

1. Uma frase sobre para quem é e o que faz.
2. Um loop que o leitor reconhece.
3. Código funcional ou uma demo dentro de uma rolagem.
4. Pontos de entrada de escolha do usuário.
5. Prova (números, usuários, governança).
6. Status honesto (centro de confiança, página de status, now/next).
7. Comunidade que você pode se juntar hoje.
8. Docs construídos tanto para pessoas quanto para leitores de IA (página de cópia, llms.txt, "Ask AI").

2. Cookwala hoje #

Pontos fortes:

• Uma ideia rara e concreta: operation envelopes físicos, sensor ladders, refusal em vez de suposições, segurança aplicada no dispositivo, documentos verificáveis.
• Vetores de conformance que incluem dois resultados de padrões independentes (RFC 8785, RFC 8032).
• Quatro simuladores jogáveis.
• Um perfil humanitário que funciona sem robôs.
• Um corpus de receitas real (fifi.cooking) e uma região com uma identidade (Egito, o mundo árabe).
• Um registro de crítica e resposta excepcionalmente honesto.

Lacunas:

3. Posicionamento e mensagem #

3.1 Categoria e resumo #

• Categoria: um padrão aberto (com ferramentas gratuitas e um índice) para culinária executável e verificável.
• Resumo: Cookwala é o padrão aberto para cozinhar com segurança: pessoas, cozinhas e robôs.
• Triad, usado em todos os lugares:
  • O que fazer. Receitas como etapas que uma máquina pode planejar.
  • Quando está pronto. Condições de término mensuráveis: temperaturas, sinais de estado do alimento, tempos.
  • O que nunca deve acontecer. Limites de segurança que o próprio dispositivo impõe.

3.2 Missão e visão (revisado) #

• Missão: Ajudar todos a comer bem, com segurança, de forma acessível e sem desperdício, quem quer que faça a cozinha.
• Visão: Qualquer cozinha na Terra pode cozinhar qualquer receita com segurança, e a boa comida chega às pessoas em vez do lixo.
• Por que a mudança: "end world hunger" permanece como a razão de longo prazo, relatada com evidências. Cookwala contribui para isso através de menos desperdício, resgate de alimentos e cozinha mais barata, juntamente com os programas, financiamento e políticas que a fome necessita.

3.3 A história #

Robôs domésticos estão chegando: Figure 03, 1X NEO e robôs de cozinha estão sendo enviados ou aceitando pedidos. Eles estão aprendendo a se mover, mas ninguém escreveu, de uma forma que uma máquina possa verificar, o que "simmer" significa, quando o frango está seguro, ou como se faz a molokhia de uma avó. Cada fabricante escreve suas próprias receitas fechadas, principalmente de algumas culinárias.

Cookwala começou a partir das receitas caseiras egípcias de uma família no fifi.cooking e fez uma pergunta simples: como você entrega uma receita para uma máquina e sabe que ela irá cozinhá-la com segurança?

A resposta é um padrão aberto. Ele diz o que fazer, quando cada etapa é concluída e o que nunca deve acontecer. O dispositivo verifica isso antes de aquecer qualquer coisa e apresenta refusal before heat em vez de tentar adivinhar. As mesmas receitas funcionam para pessoas e food banks hoje, e permitirão que robôs aprendam cada culinária na Terra amanhã, com crédito aos cozinheiros que os ensinaram.

(O fundador deve confirmar e personalizar a frase de origem. O autêntico supera o polido.)

3.4 Message house #

3.5 Regras de linguagem #

• Use: recipe, step, done, safe, check, refuse, kitchen, cook, open, verify, consent.
• Evite: "revolutionary", "first and largest" (até que seja verdade), "end hunger" (como manchete), "AI-powered" (vago).
• Rotule cada número como measured, modelled ou assumed.
• Diga "now / next / later" em vez de implicar que algo existe quando não existe.

4. Públicos e seu primeiro sucesso #

5. Arquitetura do produto: o que o Cookwala oferece #

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 Página inicial, de cima para baixo #

6.3 Direção de design #

• Sensação: calma, precisa, calorosa. Um instrumento profissional com alma de cozinha.
• Tipo: uma grotesque precisa para UI e uma mono face para dados e código. Tipo de exibição grande e leve para o hero (emprestando a confiança da Figure), sem copiar sua escuridão cinematográfica.
• Cor: papel e tinta neutros com um destaque de calor (ember orange) que também marca os dados de temperatura. A paleta é validada para leitores daltônicos, e tanto os temas claros quanto os escuros são projetados.
• Imagens: mãos reais e cozinhas domésticas reais assim que as tivermos, nunca robôs de banco de imagens. Até lá, diagramas e a live demo conduzem a página.
• Movimento: um momento, o dry run passo a passo. Todo o resto é estático.
• Bilíngue desde o início: Inglês e Árabe (layout da direita para a esquerda), depois outros.
• Acessibilidade: WCAG 2.2 AA; teclado; movimento reduzido; sem informação apenas por cor.

6.4 Interatividade #

1. dry run no navegador (receita × dispositivo).
2. Explorador de envelope: arraste um traçado de temperatura e veja quando ele sai de "simmer".
3. Simuladores, com o protocolo ligado e desligado.
4. Visualizador de etapa de receita: a frase de uma etapa, seu JSON e seu envelope lado a lado.
5. Later: um editor de receitas que valida enquanto você digita.

7. Documentação #

Organizado pelo framework Diátaxis, de modo que cada página tem um objetivo:

Ergonomia de Docs:

• navegação à esquerda, busca, "Copy page", "Edit on GitHub", links previous/next;
• abas de linguagem (Python / JavaScript / cURL / CLI);
• llms.txt e markdown por página para leitores de IA;
• uma cheat sheet e uma página de common-problems;
• um changelog com datas.

8. API e SDK #

9. Demos #

10. Comunidade e crescimento #

• Rede de colaboradores (inspirada no Figure's Index):
  • Cozinheiros registram sessões consentidas de receitas que conhecem, com crédito em cada receita e dataset card.
  • Cozinhas e food banks em piloto.
  • Makers implementam dispositivos.
  • Revisores revisam rule packs e envelopes.
  • Tradutores traduzem passos e vocabulário.
  • Contribuições pagas vêm later, financiadas por subsídios. Nunca pague por dados sem consentimento informado e termos justos.
• Rituais: chamada comunitária mensal; "estado do Cookwala" trimestral com números reais; threads de revisão pública.
• Sequência de parceria: os dez primeiros do stakeholder tracker (food bank, WFP Innovation Accelerator, Home Assistant, uma startup de dispositivos, um laboratório universitário, um certifier, World Central Kitchen, uma fundação, um lar neutro, um criador).
• Canais: GitHub Discussions, uma newsletter, palestras em conferências (ROSCon, workshops de IROS/ICRA, eventos de food-tech), canais em língua árabe.

11. Métricas #

• Métrica North-star: verified cooks, o número de execuções que rodaram uma receita Cookwala assinada de ponta a ponta com um log consentido e em conformance. Enquanto isso for zero, acompanhe os leading indicators.

12. Roadmap #

O roadmap mantido com um status por item é [ROADMAP.md](ROADMAP.md). A tabela abaixo é o plano original de 180 dias, mantido para registro.

13. Riscos para esta estratégia #