wendy-lite

Visão geral da skill wendy-lite

Para que serve o wendy-lite

wendy-lite é uma skill para criar apps WebAssembly que rodam no firmware Wendy Lite para ESP32-C6. Ela é mais útil quando você quer sair de uma ideia embarcada ainda crua e chegar a um módulo WASM funcional que consiga conversar com o hardware por meio dos host imports do Wendy Lite.

Quem deve usar

Use a skill wendy-lite se você está desenvolvendo apps próximos ao firmware em C, Rust, Swift, Zig, TypeScript ou WAT e precisa de acesso ao dispositivo, carregamento na inicialização ou comportamento orientado por callbacks. Ela é especialmente relevante para wendy-lite for Backend Development só quando “backend” significa lógica do lado do dispositivo, integração com o runtime ou orquestração de app no MCU.

O que a torna diferente

Ao contrário de um prompt genérico de WASM, wendy-lite é moldada em torno do modelo real de runtime: WAMR no ESP32-C6, imports do módulo wendy, binários armazenados em flash e callbacks assíncronos como interrupções de GPIO, timers e eventos BLE. Isso torna a skill mais útil quando o problema não é “como escrevo WASM?”, e sim “como faço este app caber no contrato do firmware?”.

Como usar a skill wendy-lite

Instale e inspecione os arquivos certos

Execute o fluxo wendy-lite install para o seu diretório e, em seguida, leia SKILL.md primeiro. Se você estiver estendendo o repositório, inspecione também os arquivos de referência vinculados no frontmatter, especialmente wasm-api.md, firmware-config.md e swift-sdk.md. É nesses arquivos que normalmente ficam os detalhes práticos da interface.

Dê à skill um briefing com cara de dispositivo

A melhor entrada não é “crie um app WASM para mim”, e sim uma tarefa de dispositivo com restrições: linguagem alvo, entradas e saídas de hardware, comportamento na inicialização e se o app precisa lidar com callbacks. Por exemplo: “Crie um módulo WASM em Rust para ESP32-C6 que leia um botão no GPIO, alterne um NeoPixel e sobreviva a reconexões.” Isso é muito melhor do que um prompt vago de wendy-lite usage, porque fornece à skill a forma de runtime de que ela precisa.

Comece pelo contrato de runtime

Ao usar wendy-lite usage, pense nesta ordem: o que o módulo exporta, o que ele importa de wendy, como os callbacks são tratados e como o binário é empacotado para flash. Se houver dúvida, peça primeiro um esqueleto mínimo e só depois acrescente acesso a hardware e tratamento de erros, quando o caminho do runtime já estiver claro.

Fluxo prático que reduz retrabalho

1. Informe a linguagem e a placa-alvo.
2. Especifique os recursos de hardware de que você precisa: GPIO, I2C, SPI, UART, BLE, rede ou controle de LEDs.
3. Diga se você quer um ponto de partida mínimo, um app completo ou uma porta a partir de código existente.
4. Peça as notas de build necessárias, especialmente se estiver usando Swift ou uma toolchain não padrão.
   Esse é o jeito mais rápido de obter um resultado útil de wendy-lite guide em vez de um exemplo genérico de WASM.

FAQ da skill wendy-lite

O wendy-lite é indicado para iniciantes?

Sim, se o seu objetivo é um app de dispositivo com escopo restrito e você estiver disposto a seguir um fluxo específico de runtime. Ele é menos amigável para iniciantes se você precisar primeiro de um tutorial amplo de WASM, porque wendy-lite parte do pressuposto de que você se importa com integração de firmware, e não só com a sintaxe da linguagem.

Quando o wendy-lite é uma má escolha?

Evite a wendy-lite skill se você não estiver mirando o ESP32-C6, não precisar de acesso ao hardware ou quiser apenas um app WASM web convencional. Ela também é uma opção fraca se o seu projeto não puder armazenar um binário WASM em flash ou não puder usar o modelo de execução baseado em WAMR.

Em que ele difere de um prompt comum?

Um prompt comum muitas vezes não pega o contrato entre o seu código e o firmware. wendy-lite é melhor quando você precisa de formatos corretos de import/export, tratamento de callbacks ou orientação de ciclo de vida do dispositivo, coisas que um prompting genérico costuma passar por cima.

O que devo verificar antes de confiar na saída?

Confira se o código proposto bate com a API real do host, os pontos de entrada dos callbacks e o target de build no repositório. Se a resposta não mencionar esses pontos, ela pode até parecer tecnicamente plausível, mas ainda assim estar errada para o Wendy Lite.

Como melhorar a skill wendy-lite

Forneça os detalhes de hardware que estão faltando

O maior salto de qualidade vem de dizer à skill exatamente qual caminho de hardware você precisa. Mencione o sensor ou atuador, os números de pino se souber, se o evento é dirigido por interrupção e se o app precisa persistir estado entre reinicializações. Isso ajuda wendy-lite a evitar a geração de um demo genérico que não corresponde à sua placa.

Peça o formato certo de saída

Se você quer entregar mais rápido, peça um de três tipos de saída: um módulo mínimo funcional, um exemplo compilável com notas ou um plano de migração a partir de um projeto C/Rust/Swift/Zig existente. Ter clareza sobre o formato da saída importa mais do que um prompt longo, especialmente quando você precisa de resultados de wendy-lite install que possam ser testados imediatamente.

Fique atento aos modos de falha mais comuns

Os erros mais frequentes são assumir APIs padrão de WASM para navegador, pular a camada de host imports de wendy ou ignorar a ligação de callbacks para eventos assíncronos. Se a primeira resposta parecer abstrata demais, peça para a skill reescrevê-la com base no ciclo de vida real do firmware e para apontar quaisquer pressupostos não suportados.

Itere com feedback baseado em compilação

Depois da primeira passada, devolva exatamente a falha: import ausente, target triple errado, nome de callback incorreto ou divergência na etapa de build. Uma boa iteração de wendy-lite guide geralmente vem de um erro concreto mais um objetivo mais estreito, e não de pedir “mais detalhes”.