webmcpify — torne qualquer aplicativo web pronto para agentes, de forma verificável

Você está executando o pipeline webmcpify. Ele pega um aplicativo web existente e expõe sua funcionalidade voltada para o usuário como ferramentas WebMCP (document.modelContext — um padrão web proposto incubado no W3C Web Machine Learning Community Group, atualmente em um teste de origem do Chrome), para que agentes de IA do navegador possam operar o aplicativo por meio de chamadas de ferramentas estruturadas em vez de adivinhar o DOM.

DETECT ──▶ INVENTORY ──▶ [HUMAN GATE: manifest approval] ──▶ INTEGRATE ──▶ VERIFY ──▶ HEAL ──▶ AUDIT
              ▲  loop            per-area batches on big apps    ▲  loop      ▲ loop    ▲ loop
              └── per area                                       └── per manifest entry ──┘

Tudo o que você precisa está incluído neste diretório de skill: guias de fase em references/, e código distribuível em templates/ (runtime, tipos ambientais, variante JS, tipagens React JSX, especificação de verificação). Nunca assuma que arquivos existem fora do diretório da skill.

Fora do escopo (pare e diga isso): servidores MCP apenas de backend (isso é MCP clássico, não WebMCP), automação de sites de terceiros que você não controla e trabalho genérico de SEO.

Modos de Invocação

O usuário pode passar um argumento (/webmcpify <mode> ou palavras simples):

Qualquer outro texto é orientação de escopo (por exemplo, "apenas a área de checkout", "ferramentas somente leitura").

Regras Fundamentais (não negociáveis, aplique em todas as fases)

1. Zero alterações não relacionadas. Cada "diff hunk" que você produzir deve ser rastreado até uma entrada do manifesto ou a configuração única registrada. Nunca refatore, reformate, renomeie ou "melhore" qualquer outra coisa — anote problemas no relatório em vez disso. Arquivos que já estavam sujos na linha de base (registrados no manifesto) são intocáveis: nunca modifique ou reverta-os.
2. Ferramentas somente leitura primeiro. Mutações são tri-estado: mutating: false, "client" (apenas local do navegador: preferências, localStorage), ou "server" (dados saem do navegador). Ferramentas que modificam o servidor requerem aprovação humana por ferramenta explícita registrada no manifesto; ferramentas que modificam o cliente podem ser aprovadas em lote no portão. Nunca exponha ações destrutivas, irreversíveis ou de pagamento em uma primeira integração.
3. O servidor é o único limite de confiança. A execute() de uma ferramenta só pode chamar caminhos de código que a UI já usa (mesmos endpoints, mesmas validações, mesma autenticação). Nunca crie novos endpoints, nunca ignore verificações existentes, nunca coloque segredos em ferramentas.
4. Formato de especificação e sem dependências. Registre via document.modelContext.registerTool() com ciclo de vida AbortSignal (detecte recursos para o fallback obsoleto navigator.modelContext ). Sem dependências de runtime WebMCP de terceiros. Tudo detectado por recursos: o aplicativo se comporta de forma idêntica em navegadores sem WebMCP.
5. Nunca toolautosubmit em formulários que alteram estado — nem mutating: "client" nem "server". Apenas em formulários de leitura pura (pesquisa, filtro, disponibilidade).
6. O estado vive em arquivos, não no seu contexto. Leia/escreva .webmcpify/ constantemente; assuma que seu contexto pode ser limpo entre quaisquer duas etapas. Escreva o manifesto atomicamente (escreva manifest.json.tmp, depois renomeie sobre manifest.json).
7. Commits são opt-in. Nunca faça commit, a menos que o humano tenha escolhido uma política de commit no portão (veja abaixo). Sem git ou sem permissão, deixe as alterações na árvore de trabalho e registre o progresso apenas no manifesto.

Orientação fresca e autoritativa

WebMCP é uma API de teste de origem em evolução — a superfície já mudou durante o teste (API de teste removida em 2026-07; navigator → document). Antes da Fase 2, se a rede estiver disponível, baixe os guias oficiais atuais do Google em vez de confiar na memória:

npx -y modern-web-guidance@latest retrieve "webmcp,agentic-forms,agentic-javascript-tools"

Se estiver offline, use references/integrate.md — mas prefira os guias ao vivo quando eles entrarem em conflito.

…