v1.9.0

CLI 1.6.0: telemetria anônima dos comandos, para saber o que as pessoas mais usam.

Vindo da 1.8:

• Para ter o CLI novo, use npx create-rubrica@latest. Projetos existentes podem atualizar com npx create-rubrica@latest update: só documentação mudou no template, nada para publicar no Convex.
• Não quer mandar nada? npx create-rubrica telemetria desligar na pasta do projeto, ou RUBRICA_TELEMETRIA=0.

CLI

• Telemetria anônima: quando create, setup, publicar, update e config terminam bem, o CLI manda as escolhas feitas (layout, esquema, modo de cor, textura, fontes, pacote de plugins, integrações ligadas, versões). Nada de nome, e-mail, endereço do site, conteúdo, chaves ou IP. O projeto ganha um id aleatório no rubrica.json, e o CLI avisa na primeira vez.
• Comando telemetria: npx create-rubrica telemetria mostra se está ligada; ligar e desligar gravam a escolha no projeto. --sem-telemetria desliga numa execução (no create, o projeto já nasce desligado). DO_NOT_TRACK=1 também vale, e em CI o CLI nunca manda nada.
• O envio dura no máximo 2 segundos e nunca quebra o comando.

Documentação

• Página nova Telemetria do CLI: o que vai, o que não vai e como desligar.

v1.8.1

Correção: textos novos de uma atualização apareciam como chave crua no site.

Vindo da 1.8:

• Atualize com npx create-rubrica@latest update. Não precisa de versão nova do CLI nem de publicar nada no Convex.

Correções

• Depois de atualizar o Rubrica, textos que chegaram na versão nova (como o aviso de tradução do depoimento e o botão "Ver original", da 1.8.0) apareciam como portfolio.showOriginal no lugar do texto. Agora o site usa o texto padrão enquanto a chave não existe no banco. Os textos que você editou no admin continuam valendo.

v1.8.0

Os cards de métricas e o depoimento do case passam a ter versão em inglês.

Vindo da 1.7:

• Atualize com npx create-rubrica@latest update. Não precisa de versão nova do CLI.
• O backend mudou (convex/): publique no Convex do computador com npx convex dev --once e, no site no ar, com npx create-rubrica publicar. Os campos novos são opcionais: os cases existentes continuam iguais.
• Os cases já salvos continuam em português em /en/ até você abrir cada projeto em /admin/projects e salvar de novo. A tradução é feita nesse momento.

Cases

• Métricas em inglês: ao salvar o projeto, o rótulo e o valor de cada card são traduzidos. Números ("365", "7 GB → 400 MB") ficam iguais; texto ("Entrada + saída") é traduzido. A métrica do cartão na home e no portfólio também aparece traduzida.
• Depoimento com idioma original: escolha em que língua a pessoa escreveu o depoimento (Português ou Inglês). Na outra língua, o site mostra a tradução com o aviso "Tradução automática do original" e um botão para ver o original.
• O prompt de importação de case por JSON pede as métricas e o depoimento traduzidos.

Skills

• As skills rubrica e rubrica-case sabem traduzir as métricas e marcar o idioma original do depoimento.

v1.7.0

Propostas com preço por item, desconto e brinde. As skills passam a abrir issue quando o Rubrica não faz o que foi pedido, e os projetos ganham instruções para agentes de IA.

Vindo da 1.6:

• Atualize com npx create-rubrica@latest update. Não precisa de versão nova do CLI.
• O backend mudou (convex/): publique no Convex do computador com npx convex dev --once e, no site no ar, com npx create-rubrica publicar. Os campos novos são opcionais: as propostas existentes continuam iguais.
• Para o desconto aparecer em contratos de modelos já salvos, acrescente {{discount}} ao modelo em /admin/contracts.

Propostas

• Preço por item: cada item do escopo pode ter preço, mostrado ao lado dele na proposta e no contrato.
• Desconto: campo opcional de valor original (antes do desconto). A proposta mostra o original riscado, o desconto em R$ e % e o valor final. O admin sugere o valor original pela soma dos itens e avisa quando a soma não fecha.
• Brinde: marque um item com preço como brinde. Na proposta, ele aparece com o badge "Brinde", o preço riscado e R$ 0,00.
• O valor do projeto continua sendo o valor final, usado no contrato e nas formas de pagamento. O contrato cita o desconto e os brindes, e os modelos de contrato ganham as variáveis {{original_value}} e {{discount}}.

Skills e agentes

• Abrir issue: quando a pessoa pede algo que o Rubrica não suporta, ou algo quebra, as skills decidem se é bug ou pedido, procuram uma issue parecida e, com o "ok" da pessoa, abrem no GitHub do Rubrica (pelo gh ou por um link preenchido), sem dados privados.
• A skill rubrica sabe mexer em preços, desconto e brinde das propostas.
• AGENTS.md e CLAUDE.md na raiz do projeto: ensinam agentes como Claude Code, Codex e Cursor a atualizar o Rubrica (incluindo os arquivos .rubrica-new), o que eles podem rodar no CLI e o que fica com você. Veja "Com um agente de IA" em Comandos do CLI.

v1.6.0

O site do Rubrica ganha versão em inglês, a página de novidades e a documentação, com três guias novos: começar, comandos do CLI e publicar.

Vindo da 1.5:

• Atualize com npx create-rubrica@latest update para receber a skill rubrica-voz que entende a entrevista em inglês. Não precisa de versão nova do CLI nem de publicar nada no Convex.

Site do Rubrica

• Em inglês, em userubrica.vercel.app/en, com seletor de idioma no topo. Combinador, "Crie o seu", layouts e esquemas, tudo traduzido. A página avisa que o CLI e o painel são em português.
• Novidades em /novidades (e /en/changelog): este changelog no próprio site, com índice de versões.
• Documentação em /docs (e /en/docs): o guia dos templates, os 13 layouts, os esquemas de cores, criar um layout e atualizar viram páginas do site, com navegação e índice. Os links do site deixam de mandar para o GitHub.

Guias novos

• Começando: do zero ao site rodando no computador, e o que preencher em cada tela do painel.
• Comandos do CLI: todas as perguntas, opções e arquivos do create, e os outros comandos.
• Publicar o site: a primeira publicação, o botão Publicar do painel, outro computador, domínio próprio e problemas comuns.
• O README e o README do CLI ficaram mais curtos e apontam para esses guias.

Entrevista de voz em inglês

• Em /en/voice, com o ditado em inglês e as respostas salvas à parte das em português. A skill rubrica-voz reconhece a entrevista em inglês e observa a voz no idioma das respostas.

Rubrica 1.5 — botão Publicar sem GitHub e agente no site publicado

O botão Publicar do painel passa a funcionar sem GitHub, o agente de IA entra no site publicado, e o publicar fica seguro em outro computador.

Vindo da 1.4:

• Atualize com npx create-rubrica@latest update e rode npx create-rubrica@latest publicar. Ele anota no rubrica.json o endereço do site publicado e oferece ligar o botão Publicar do painel (você cria um token na Vercel e cola no terminal, uma vez só).
• Versione o rubrica.json junto com o projeto: é por ele que o setup e o publicar reconhecem, num outro computador, que o site já está no ar.

Botão Publicar do painel

• Sem GitHub. A Vercel só cria Deploy Hook em projeto ligado ao GitHub, e o publicar envia pelo terminal. Agora o painel usa um token da Vercel para refazer o último deploy de produção: o build roda de novo e busca o conteúdo atualizado. Quem tem Deploy Hook continua usando o hook.
• O publicar abre a página de tokens da Vercel, explica o que preencher, recebe o token sem mostrá-lo na tela, confere se ele acessa o projeto e grava no banco de produção.
• O painel mostra o motivo quando a publicação não sai (botão não configurado, token vencido). Antes dizia "Deploy iniciado com sucesso!" mesmo com erro.

Agente de IA no site publicado

• A skill rubrica ganha --producao (ou RUBRICA_AMBIENTE=producao) para mexer no site no ar. O padrão continua sendo o site do computador.
• Num projeto já publicado, o login pergunta se você quer entrar no site publicado ou no do computador. O status mostra os dois endereços.

publicar e setup em outro computador

• O publicar grava em producao no rubrica.json o endereço do banco e do site publicados (projetos da 1.4 ganham isso ao publicar de novo).
• Sem a pasta .vercel (clone novo, outro computador), o publicar percebe que o site já está publicado, liga a pasta ao mesmo projeto da Vercel e só publica. Antes ele refazia a primeira vez: gerava chaves de login novas (todo mundo saía do painel) e regravava os dados do painel.
• Se o computador estiver ligado a outro projeto do Convex, o publicar para antes de gravar qualquer coisa, para não trocar o banco do site no ar por um vazio. O setup, num clone de site publicado, liga a um projeto existente do Convex em vez de criar um novo.
• Publicando de novo, o Telegram e o OpenRouter ligados no computador depois da primeira vez vão para a produção (só os que faltam lá).

create

• O git começa na branch main, com um primeiro commit do projeto montado. Antes, o nome da branch dependia do computador (em geral master) e ela só passava a existir no primeiro commit da pessoa.

Rubrica 1.4.1 — layouts em telas largas

Layouts ajustados para telas largas (monitores de 1920px para cima). Nada muda em telas de até 1600px.

Vindo da 1.4:

• Atualize com npx create-rubrica@latest update. Não precisa de versão nova do CLI nem de publicar nada no Convex. Se o site já está publicado, publique de novo depois de atualizar.

Telas largas

• Jardim Digital: o conteúdo ficava colado na barra lateral, com um espaço vazio enorme à direita. Agora a coluna fica centralizada.
• Bento: o grid parava só na borda da tela, e os cards ficavam enormes. Agora para em 1600px e fica centralizado.
• Suíço: menu e conteúdo param juntos em 1600px e, acima disso, ganham bordas laterais no traço do layout, como uma folha centralizada.

Rubrica 1.4 — publicar na Vercel pelo terminal

npx create-rubrica publicar coloca o site no ar na Vercel sem copiar nada à mão, e o template passa a funcionar quando publicado a partir de um projeto do CLI.

Vindo da 1.3:

• Atualize com npx create-rubrica@latest update. Ele traz a pasta domain/ (sem ela o npm run build falha), o public/color-mode.js e o build:i18n corrigido.

Publicar

• npx create-rubrica publicar: entra na Vercel (login pelo navegador), cria o projeto, prepara o banco de produção do Convex (chave, backend, chaves de login, integrações do Telegram e do OpenRouter, profissão), cria o admin do site publicado e os dados iniciais, grava as variáveis na Vercel e publica. Rodar de novo só publica.
• O setup termina dizendo como colocar o site no ar.

Correções para o site publicado

• Projetos criados pelo CLI falhavam no npm run build: a pasta domain/, usada pelo gerador de RSS, ficava fora do pacote da release.
• O build da Vercel apagava as traduções do site quando o plugin de tradução estava desligado (o menu aparecia como navigation.home). Agora os textos do banco são mesclados sobre as traduções do repositório.
• O script do modo claro/escuro era bloqueado pela política de segurança (CSP) do site publicado. Ele passou para public/color-mode.js.

---

Novo projeto: monte o seu no site e copie o comando em Crie o seu, ou rode npx create-rubrica@latest meu-portfolio. Para colocar no ar: npx create-rubrica publicar. Detalhes no README do CLI.

v1.3.0

Skills para o agente de IA escrever o conteúdo do site com método e com a voz do dono, e a entrevista de voz no site. Nada muda no site nem no painel de quem está na 1.2.

Vindo da 1.2:

• Atualize com npx create-rubrica@latest update. Ele traz as pastas .agents/skills/rubrica-* (e os atalhos em .claude/skills/) e a linha .rubrica/ no .gitignore. Nada precisa ser publicado no Convex.
• Na primeira vez que pedir ao agente um texto do site (apresentação, case, currículo, post), ele vai te mandar para a entrevista de voz em https://userubrica.vercel.app/voz. Leva uns 20 minutos.

Skills de conteúdo

• Seis skills novas para o agente de IA escrever o conteúdo do site com método e com a voz do dono: rubrica-voz, rubrica-apresentacao, rubrica-case, rubrica-curriculo, rubrica-blog e rubrica-pilar. As técnicas de apresentação, case e currículo vêm de pesquisa com fontes (que acompanham cada skill em references/pesquisa.md).
• A voz vem primeiro. Sem perfil de voz, as skills mandam a pessoa para a entrevista de voz no site (/voz, fora dos buscadores): 21 perguntas, respondidas falando (ditado do navegador) ou digitando, com um botão que copia tudo em Markdown para o agente. A rubrica-voz mede o estilo com um script, monta o perfil com trechos literais, calibra às cegas com a pessoa e propõe o lado pessoal da página Sobre.
• As estrategistas não gravam nada: entregam um plano em .rubrica/planos/, revisado pela rubrica-pilar, que a skill rubrica aplica.
• Novo comando aplicar-plano no script da skill rubrica: valida o plano antes de gravar (estrutura, arquivos, chaves de texto, slug repetido, contraste, inglês faltando, funções que não existem), mostra o antes → depois (--verificar), recusa planos feitos para outro Convex e retoma de onde parou se algo falhar (--retomar).

Rubrica 1.2 — CLI mais simples, do site direto para o terminal

CLI pensado para quem não é da área técnica: menos perguntas, nada repetido, do site direto para o terminal e troca de senha do painel pelo terminal. Nada quebra em quem está na 1.1.

Vindo da 1.1:

• Atualize com npx create-rubrica@latest update. É o que traz a função usada pelo npx create-rubrica senha. Se o site já está publicado, publique de novo depois de atualizar.
• A senha do painel passa a seguir as mesmas regras em todo lugar: 12 ou mais caracteres, com maiúscula, minúscula e número. Senhas antigas continuam valendo; a regra vale para as próximas trocas.

Do site direto para o terminal

• A seção Crie o seu do site, abaixo do combinador, monta um comando com --receita. Ele leva o visual escolhido, os plugins, a identidade, a profissão e as especialidades. Nada sai do navegador.
• Com a receita, o CLI mostra um resumo, confirma e só pergunta o que faltar. O projeto é criado no Convex sem as perguntas dele, e o terminal pede só a senha do painel. Telegram e Vercel ficam para um setup posterior.
• Opções legíveis para quem prefere: --layout, --esquema, --modo, --textura, --fonte, --mono, --plugins, --alternancia.

Menos perguntas no create

• Começa perguntando Rápido ou Personalizado. No rápido, as cores, a textura e as fontes vêm do layout, e o idioma fica em português.
• Plugins em pacotes prontos (Completo, Para vender serviços, Só o portfólio), com a lista um por um como opção. Nomes e descrições em linguagem comum, também no config.
• Endereço do site sem precisar digitar https://: meusite.com/ vira https://meusite.com. O @ e o link do perfil do X também são aceitos. Quem não tem domínio pode deixar o <projeto>.vercel.app sugerido.
• Git e instalação das dependências sem perguntas: com pnpm se o create veio do pnpm create, com npm nos outros casos.
• Oferece configurar o painel na hora: conecta o Convex e roda o setup no mesmo fluxo, sem segundo terminal.

setup, config e senha

• O setup conecta o Convex sozinho quando falta o .env.local, não pergunta de novo o endereço do site e já preenche o e-mail do admin. Telegram e Vercel ficam atrás de um sim/não, e as perguntas não mostram mais nomes de variável de ambiente.
• A profissão informada no setup passa a aparecer abaixo do nome no site. Antes ela era gravada por uma função que exigia login e falhava em silêncio.
• Rodar o setup de novo não pede mais a senha quando o painel já tem admin.
• npx create-rubrica senha: troca a senha do painel pelo terminal, no site publicado ou no do computador, e libera o login bloqueado por tentativas erradas.
• config → Identidade abre as perguntas com os valores salvos, em vez de pedir tudo de novo.
• Guia de manutenção do CLI: o que mudar no CLI quando entra layout, esquema, fonte ou plugin novo, e as regras da receita.

---

Novo projeto: monte o seu no combinador do site e copie o comando em Crie o seu, ou rode npx create-rubrica@latest meu-portfolio. Opções do CLI e o comando senha: README do CLI.