Pular para o conteúdo
Voltar ao portfólio

Rubrica: portfólio de código aberto operado por agentes de IA

  • Astro
  • React
  • TypeScript
  • Convex
  • MCP
  • Claude Code
  • pnpm
  • Changesets
  • GitHub Actions
  • Vercel
  • TailwindCSS
  • Asaas

Meu papel

Autor e mantenedor do projeto, open source sob a GPL-3.0.

Começar um portfólio do zero dá trabalho demais, e os construtores prontos deixam todo mundo com a mesma cara. O Rubrica fica no meio do caminho: a estrutura técnica inteira já está resolvida (home, portfólio, blog, currículo, propostas comerciais, painel admin e pagamentos), e um agente de IA ajuda a escrever e manter o conteúdo.

Do teste ao site no ar: no site do Rubrica, a pessoa testa layouts, cores e fontes no app funcionando e copia um comando. O create-rubrica cria o projeto, o banco e o admin pedindo só a senha, e o publicar põe na Vercel.
13 layouts × 15 esquemas de cores, cada um com modo claro e escuro, texturas e fontes.
Operado por IA: a skill rubrica edita o site em linguagem comum, e as skills estrategistas escrevem apresentação, cases, currículo e posts com a voz do dono, a partir de uma entrevista de voz. Funciona com Claude Code, Codex e OpenCode.
Propostas comerciais: link com senha, aceite eletrônico, assinatura manuscrita e contrato em PDF, com aviso no Telegram.
Admin completo: tudo se edita pela interface, inclusive cores, fontes e textos fixos, e 15 plugins ligam e desligam cada recurso.
Pagamentos opcionais: PIX, boleto e cartão via Asaas. IA opcional para tradução pt-BR/en-US e currículo adaptado a cada vaga.

Por baixo: React + Vite no front, Convex como backend, deploy contínuo na Vercel, site público em Astro, 150 arquivos de teste com Vitest e mutation testing com Stryker. Licença GPL-3.0.

Antes

A v1 era um template: cada site recebia uma cópia do código inteiro. Atualizar era mesclar, arquivo por arquivo, as mudanças do Rubrica com as da pessoa. O site público era uma SPA em Vite, montada no navegador, e as skills de IA editavam o conteúdo por um script Python.

O problema

Esse modelo tinha três limites. Primeiro, toda correção de SEO, acessibilidade ou segurança precisava chegar a cada cópia do código, uma por uma. Segundo, uma SPA entrega a página vazia e monta o conteúdo no navegador, e para um portfólio, que vive de ser encontrado, isso pesa. Terceiro, a v1 tinha três falhas de segurança nas propostas: a pior deixava ler pela API o texto de uma proposta protegida por senha, sem digitar a senha.

E o agente de IA editava o site por um script que não sabia o que cada site aceitava, sem a mesma checagem do painel.

A solução

Na v2, o Rubrica virou um núcleo em pacote (@rubrica/core) com temas separados (@rubrica/theme-*), num monorepo com pnpm. Atualizar passou a ser subir a versão de um pacote, e uma correção feita uma vez no núcleo vale para todos os temas.

O site público sai em HTML estático com Astro, com sitemap, RSS, hreflang e dados estruturados, e quase nenhum JavaScript: só o que é interativo (contato, filtros, busca) vira ilha de React. O painel continua em React e o backend no Convex. As páginas são montadas com blocos, 21 no catálogo, com prévia ao vivo no painel, e há duas linhas de site: pessoal e empresa.

Para os agentes, troquei o script Python por um servidor MCP local. O Claude Code ou o Codex entram com o login de um usuário do painel, valem as permissões do papel dele e toda gravação começa numa prévia. O MCP lê o catálogo de blocos do próprio projeto e as variações do tema instalado, então o agente só monta o que o site aceita.

Para quem já tinha site na v1, o comando migrar cria uma branch, troca o código, converte os dados num arquivo de import e lista o que a pessoa personalizou, sem gravar em banco nenhum.

Decisões e trade-offs

Pacote em vez de template. A pessoa perde a liberdade de mexer em qualquer arquivo do núcleo. Para compensar, dá para ejetar um componente para o projeto ou criar um tema próprio, com guia.

Astro estático em vez de SPA. O site fica rápido e legível para o Google, mas conteúdo novo só aparece no próximo build. Por isso o painel tem prévia ao vivo e o publicar dispara o deploy.

MCP local em vez de servidor hospedado. Ele roda na máquina da pessoa e fecha junto com o agente: nenhum serviço a mais para manter, e a senha fica só no terminal dela.

Migração que não grava. O migrar importa num Convex de desenvolvimento novo, e a produção só muda com o ok da pessoa.

Publicação sem token. As versões saem com Changesets e são publicadas pelo GitHub Actions com o trusted publishing do npm (OIDC): nenhum token guardado e procedência em cada pacote.

Os resultados

A 2.0.0 saiu em 8 de novembro de 2026 com 18 pacotes no npm: o núcleo, o CLI, o MCP, o testador de temas e os 14 temas, todos aprovados na mesma bateria (axe, h1, <head>, JavaScript por página e Lighthouse). As três falhas de segurança das propostas estão corrigidas.

Migrei este site, o mmlo.com.br, da v1 para a v2 com o próprio migrar: os dados foram para um Convex novo, conferi a paridade com a v1 página por página e a troca em produção entrou numa PR, no ar em 11 de novembro. Hoje edito o conteúdo dele pelo MCP, de dentro do Claude Code. As versões seguintes já saem pelo GitHub Actions, sem token.

Resultados em números

  • 18Pacotes publicados no npm
  • 70Ferramentas no MCP para agentes de IA
  • 14Temas na mesma bateria de testes
  • 3Falhas de segurança da v1 corrigidas
  • 115Arquivos de teste