Sobre o projeto

O B2C App Builder é um projeto de código aberto com licença MIT da Clueless Creations que estrutura a construção de negócios de aplicativos de consumo como um conjunto de primitivas reutilizáveis para agentes de IA. O README utiliza a metáfora de uma cozinha de restaurante: as estações são as responsabilidades que todo negócio de app de consumo compartilha e que não mudam com o app; as capacidades definem o que cada estação deve produzir; os provedores as implementam; as receitas organizam o trabalho em loops de criação e operação; e o conhecimento selecionado é o mise en place que ajuda o agente a decidir bem. O usuário é descrito como o chef executivo, escolhendo a oportunidade e o produto e definindo o nível de qualidade. O projeto afirma que habilidades e conhecimento obtido sozinhos deixam em aberto qual trabalho vem a seguir, o que o último trabalho decidiu, qual provedor o executa, se o resultado se sustenta e o que acontece em caso de falha. Capacidades, receitas, planejamento, execução delimitada, evidências e recuperação são apresentados como as respostas, mantendo vários agentes e provedores especializados trabalhando em um único negócio, em vez de peças desconectadas. Os usuários fornecem seu próprio agente e modelo, infraestrutura, contas e credenciais de provedores e ambiente de execução; o método em si é entregue integralmente sob a licença MIT. As áreas cobertas, mapeadas para estações, incluem pesquisa de oportunidade (usuários, concorrentes, demanda, hipótese de produto defensável), definição de produto (promessa, primeiro valor, loop principal, escopo, medidas de sucesso), experiência (identidade, onboarding, interação, movimento, estados acessíveis), engenharia (superfícies nativas e web com contratos explícitos e verificação de runtime), receita e crescimento (assinaturas, aquisição, funis, atribuição, ciclo de vida) e aprendizado e operações (inspeção de evidências, planejamento de melhorias, suporte ao usuário, manutenção do negócio). Cinco primitivas são descritas: uma Capability (Capacidade) é uma responsabilidade de negócio com semântica de operação e critérios de aceitação; um Provider (Provedor) é uma implementação de operações específicas com suporte e limites declarados; uma Recipe (Receita) é um loop de criação ou operação configurável; Knowledge (Conhecimento) é orientação de fonte carregada em quantidades delimitadas; Evidence (Evidência) são observações vinculadas a uma reivindicação, artefato e ambiente. O README enfatiza que a troca de um provedor não redefine o que significa um direito ou ativação, que uma nova receita reutiliza a mesma maquinaria de execução e evidência, e que os construtores mantêm o controle do produto, marca, modelo de negócio e loop operacional. Para começar, é necessário o Node.js 24. `npm install -g b2c-app-builder` seguido de `b2c setup` cria o registro do workspace local e imprime o comando de registro MCP para Claude Code, Cursor e Codex. Uma forma portátil não requer instalação (`claude mcp add --scope user b2c-app-builder -- npx -y -p b2c-app-builder b2c-app-builder-mcp`). A partir do código-fonte, o repositório é clonado e executado com `npm ci` e `npm run setup`, que executa `npm link`. Os comandos iniciais incluem `b2c catalog --json` para listar capacidades, provedores e receitas públicas, e `b2c compose --config contracts/public-api/examples/subscription-app.json --json` para visualizar uma composição sem alterar nada; a prévia resolve cada operação para um provedor e lista bloqueios, e a prévia da declaração reporta `canApply: false`. A ativação de uma receita de pacote instalado usa comandos separados de plano de composição e ativação com verificação de revisão. Para um novo negócio, `b2c business-create` registra um workspace de planejamento com um nome de workspace, diretório absoluto, nome do produto, hipótese e mandato; o destino deve estar vazio ou ausente, e workspaces existentes podem ser adotados com `b2c workspaces register`. Comandos de status e plano seguem-se. O ciclo de vida descrito cria um workspace de planejamento, inicializa o produto aceito com uma receita de negócio completo de 99-workflows, planeja o trabalho elegível e executa sessões delimitadas através do executor, com relatórios de evidências separando a aceitação atual de provas ausentes ou obsoletas e solicitações interrompidas fechando através de recuperação com verificação de revisão. As composições vinculam uma receita a um destino e podem substituir o provedor para uma única operação via YAML (`apiVersion: b2c/v1`, id/versão da receita, plataforma e runtime de destino, e bindings mapeando uma operação para uma versão de provedor e conexão). Os valores de conexão são nomes de conexões gerenciadas separadamente, nunca credenciais. A operação de aplicativos móveis é tratada como sua própria capacidade: agentes percorrem jornadas de clientes, reproduzem bugs, revisam design e capturam screenshots ou filmagens de demonstração, com as ferramentas de simulador nativo do host do agente como provedor padrão e alternativas como MobAI selecionáveis. Um exemplo do Tuck é citado para mostrar capturas reais de app e web, incluindo planejamento de viagem, embalagem e uma landing page, com links de galeria para a procedência da captura e limites de verificação. Uma tabela de status distingue o suporte declarado da implementação funcional. Os itens implementados incluem conhecimento baseado em fonte, o catálogo de workflow, o CLI e MCP local; criação de workspace, planejamento, execução delimitada, revisão e evidência; descoberta `b2c/v1`, prévia de composição e status do negócio com esquemas CLI/MCP compartilhados e testes de contrato; e importação de pacotes locais e ativação de composição com pins de conteúdo, verificações de prévia e recuperação. As rotas de execução de provedores são adaptadores de host explícitos, e declarações sozinhas nunca executam. Um único negócio de consumo completo e com qualidade de benchmark é listado como o próximo marco, enquanto relatórios de mercado comparáveis estão implementados, mas o marco de múltiplos negócios observados permanece não comprovado. Sobre contribuições, o projeto convida a melhores referências de apps de consumo, contratos de operação, provedores e receitas, observando que a maioria das contribuições adiciona uma maneira de executar uma estação, em vez de uma nova estação, e que extensões de primeira parte e da comunidade passam pela mesma suíte de conformidade. Um arquivo AGENTS.md direciona o trabalho do agente por escopo para as skills `b2c-app-builder`, `b2c-contributor` ou `b2c-maintainer`. Créditos de terceiros e avisos legais são renderizados de manifestos upstream em `catalog/upstreams`.