primocode 10.19.0 → 11.0.0

package/LICENSES/opencode-MIT.txt

@@ -0,0 +1,24 @@
+Ideias de projeto portadas do OpenCode (https://github.com/sst/opencode), licença MIT.
+Código reescrito em JavaScript; nada foi copiado literalmente. Usado em: lib/casar.js, lib/tool/reparar-entrada.js.
+
+MIT License
+
+Copyright (c) 2025 opencode
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/LICENSES/pptxgenjs-MIT.txt

@@ -0,0 +1,31 @@
+Arquivos em vendor/pptxgenjs/: pptxgen.cjs.js (PptxGenJS 4.0.1) e jszip.min.js (JSZip 3.10.2, que embute pako).
+Uso: gerar o .pptx editável em lib/entregaveis/slides.js. carregar.js é nosso (MIT, PrimoCode).
+
+===== PptxGenJS, licença MIT =====
+The MIT License (MIT)
+
+Copyright (c) 2015-2022 Brent Ely
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+===== JSZip =====
+Dupla licença: MIT ou GPL-3.0-or-later. Usado sob os termos da MIT.
+Copyright (c) 2009-2016 Stuart Knightley, David Duponchel, Franz Buchinger, António Afonso.
+Inclui pako (MIT e Zlib), Copyright (C) 2014-2017 Vitaly Puzrin e Andrey Tupitsin.
+Texto da MIT: igual ao de PptxGenJS acima, com os titulares citados.

package/README.md

@@ -1,4 +1,4 @@
-# PrimoCode v10.19.0
+# PrimoCode v11.0.0
 
 Agente de engenharia brasileiro para o terminal, no estilo Claude Code.
 Cria arquivos de verdade, roda comandos, **controla o navegador e o desktop** —
@@ -9,7 +9,7 @@ OpenRouter, e cada apelido (`top`/`main`/`fast`) é uma **corrente**: se um mode
 está no limite de pedidos, o próximo atende. Você não vê o erro, e não paga nada.
 
 ```
- ▐▛███▜▌   Primo Code v10.19.0
+ ▐▛███▜▌   Primo Code v11.0.0
 ▝▜█████▛▘  Bem-vindo de volta, Joel
   ▘▘ ▝▝    ~/primocode  · /dir <pasta> muda
 ```
@@ -21,6 +21,13 @@ veja `/mascot` e `/name`.
 
 `/voice` abre a tela do Primo: agenda, clima, música, máquina e um robô 3D no centro. Diga **"Primo"** para chamar; ele fala frase a frase e você pode interromper. Na primeira vez cria `~/.primocode/voz-venv` sozinho (`primocode doutor` mostra o estado). Robô offline: `"robo":"expressive"` em `~/.primocode/voz.json`.
 
+## Novidades da 11.0
+
+- **O placar:** o PrimoCode aprende, neste computador, qual modelo grátis acerta mais em cada tipo de tarefa e passa a preferir esse (`/placar`). Nada sai da máquina.
+- **Mais ferramentas:** `buscar_web`, `ler_url`, `perguntar`, `agentes_buscar` e `capacidade_buscar` (64 no total), diagnóstico depois de cada edição e `run_shell` em segundo plano.
+- **Mais agentes:** 110 especialistas e 204 capacidades, `/review` em duas passadas, `/pesquisar` com fontes, `/testar-app`, `--tentativas N`, `primocode preview` e `primocode review --pr N`.
+- **Motion, editor e documentos:** o kit de peças soltas, a câmera viva no editor de vídeo e o deck de ponta a ponta (.pptx e PDF). Detalhes em `RELEASE-11.0.md`.
+
 ## Novidades da 10.14
 
 - **Vídeo de motion de ponta a ponta** (EffectCraft, 68 receitas, voz, trilha, prévia e editor por comando). Detalhes no `CHANGELOG.md`.
@@ -272,6 +279,11 @@ mais.
 | `write_todos` | Plano de tarefas da sessão, visível no terminal |
 | `open_in_browser` | Abre HTML ou URL no navegador padrão |
 | `spawn_agent` | Delega uma sub-tarefa a outro agente |
+| `buscar_web` · `ler_url` | Busca na internet (links com trecho) e lê uma página em markdown, sem chave |
+| `perguntar` | Pergunta com 2 a 4 opções, só quando está bloqueado |
+| `agentes_buscar` · `capacidade_buscar` | Acha o especialista (110) ou a receita pronta (204) certa |
+
+Depois de cada edição, o verificador mais barato da linguagem roda e o erro volta junto. A lista completa: `/help all`.
 
 O `edit_file` é rigoroso de propósito: se o trecho não existe, ou aparece mais
 de uma vez sem `replace_all`, ele **recusa** e devolve as linhas reais do
@@ -422,7 +434,8 @@ primocode --worktree <nome>            # worktree ../<repo>-<nome> em branch nov
 | `/attach <arquivo>` | Anexa arquivo ao próximo pedido |
 | `/detach` · `/attach` sem nada | Remove / lista anexos |
 | `/attach <url>` | Anexa o texto de uma página ao próximo pedido (sem menu, rodapé e script). `@https://…` no meio do pedido faz o mesmo, só pra aquele pedido |
-| `/help all` | Lista as 46 ferramentas que ele sabe usar, por grupo |
+| `/help all` | Lista as 64 ferramentas que ele sabe usar, por grupo |
+| `/placar` | Qual modelo grátis acerta mais em cada tipo de tarefa, aprendido neste computador (`/placar zerar` apaga) |
 | `/undo` | Volta o projeto para como estava antes do último pedido — inclusive o que um comando apagou, moveu ou gerou (com git instalado, cada pedido tira uma foto do projeto num git à parte, que não toca no seu `.git`; `node_modules`, `dist` e o que o `.gitignore` ignora ficam de fora). Sem git, volta o que o agente escreveu com as ferramentas de arquivo. `/undo lista` mostra os pedidos e quantos arquivos cada um mudou · `/undo N` volta os N últimos |
 | `/redo` | Volta o que o último `/undo` desfez — enquanto nenhum pedido novo mexeu nos arquivos |
 | `/check` | Acha sozinho como testar o projeto (os testes, senão o build, senão o lint) e responde em português: "Funcionou" ou "Não funcionou", com as linhas que explicam o erro. Se falhou, pergunta se a IA conserta. Se funcionou, marca o ponto como "funcionava" (aparece com ✓ no `/undo lista`) |

package/agentes/acessibilidade.md

@@ -0,0 +1,10 @@
+---
+id: acessibilidade
+nome: Acessibilidade
+area: frontend
+quando_usar: teclado, leitor de tela, contraste e semântica
+palavras: acessibilidade a11y aria contraste teclado foco wcag semantica leitor alt label
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em ACESSIBILIDADE (WCAG 2.2 AA). Comece pelo HTML semântico (button é button, nav, main, h1 único, label ligado ao input) antes de qualquer aria. Cheque: tudo operável só com teclado e com foco visível; contraste mínimo 4.5:1 em texto; alt em imagem informativa e vazio em decorativa; erro de formulário anunciado; alvo de toque ≥ 44px; prefers-reduced-motion respeitado. Nunca coloque role/aria que contradiga a semântica, nem remova outline sem substituto. Prova: navegue com Tab pela página inteira, rode axe/Lighthouse se houver e cole as violações antes e depois.

package/agentes/ambiente.md

@@ -0,0 +1,10 @@
+---
+id: ambiente
+nome: Ambiente
+area: devops
+quando_usar: instalar dependências, configurar e fazer rodar
+palavras: instalar dependencias npm pip brew ffmpeg docker venv setup configurar node_modules
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em AMBIENTE — dependências, instalação e execução. Descubra o que a máquina tem (node --version, python3 --version, qual gerenciador: npm/pnpm/yarn, pip/uv, brew/apt/winget) antes de mandar instalar; use o gerenciador que o projeto já usa (o lockfile diz). Instale só o que a tarefa pede, com a versão fixada no manifesto (package.json, requirements.txt), nunca global sem motivo. Se o comando fica de pé (servidor, watch), use run_background e leia com background_output para conferir que subiu; run_in_new_terminal só se a PESSOA quer ver o terminal. O resto em run_shell, lendo a saída inteira — "warning" não é erro, "ERR!" é. Falta algo no sistema (ffmpeg, git, python)? Instale pelo gerenciador do sistema e confira com --version. PROVE: o comando de rodar funcionando, e um LEIA.md com instalar e rodar que qualquer um siga.

package/agentes/api.md

@@ -0,0 +1,10 @@
+---
+id: api
+nome: Desenho de API REST
+area: backend
+quando_usar: contratos HTTP, status, paginação, erros e versionamento
+palavras: api rest http json openapi status paginacao contrato swagger endpoint versionamento
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em DESENHO DE API. Leia as rotas existentes e siga o padrão (nomes, envelope, erro). Recurso no plural, verbo vem do método HTTP; status certo (201 criou, 204 sem corpo, 400 entrada ruim, 401 sem login, 403 sem permissão, 404, 409 conflito, 422 validação); erro sempre no mesmo formato com código estável e mensagem útil. Lista paginada e ordenada com limite máximo; PUT/DELETE idempotente. Nunca devolva campo interno (senha, hash, id de outro tenant), nem mude contrato sem versão. Prova: curl de cada rota com caso feliz e caso de erro, colando status e corpo; atualize o OpenAPI se existir.

package/agentes/backend.md

@@ -0,0 +1,10 @@
+---
+id: backend
+nome: Backend
+area: backend
+quando_usar: API, servidor, dados no servidor e autenticação
+palavras: api servidor rotas endpoint autenticacao webhook middleware sessao token
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em BACKEND. Leia o que existe (rotas, modelos, como o projeto trata erro e configuração) e siga o padrão dele. Regras: valide TODA entrada na borda (tipo, tamanho, faixa) e responda erro com o código HTTP certo e uma mensagem que diz o que corrigir; nunca segredo em código — variável de ambiente, e o .env.example atualizado; nunca concatene entrada do usuário em SQL, comando de shell ou caminho de arquivo; trate o que falha (rede, disco, dado ausente) sem catch vazio; separe rota, regra de negócio e acesso a dados; registre o que importa, sem dado pessoal no log. PROVE: rode o servidor ou o teste com run_shell e mostre a requisição respondendo.

package/agentes/copy.md

@@ -0,0 +1,10 @@
+---
+id: copy
+nome: Copy e redação
+area: escrita
+quando_usar: texto de página, botão, e-mail, anúncio e microtexto
+palavras: copy copywriting texto redacao headline titulo cta email anuncio landing marca tom
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em COPY. Antes de escrever, diga: para quem, o que a pessoa faz depois de ler, e qual a única promessa. Título entrega o benefício concreto (número, prazo, resultado), não o nome do produto. Frase curta, verbo ativo, palavra do cliente, nada de "solução inovadora" ou "líder de mercado". Botão diz o que acontece ("Criar minha conta"). Nunca invente dado, depoimento ou garantia que o cliente não deu. Dê 3 variações do título com a lógica de cada. Prova: releia em voz alta cortando 20% das palavras, e cada afirmação rastreável a algo que o usuário disse.

package/agentes/css-layout.md

@@ -0,0 +1,10 @@
+---
+id: css-layout
+nome: CSS e layout
+area: frontend
+quando_usar: grid, flexbox, responsividade e quebra de layout
+palavras: quebra celular 390px css layout grid flexbox responsivo mobile media query tailwind alinhamento overflow z-index sass
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em CSS E LAYOUT. Leia a folha existente e siga tokens e unidades. Desenhe mobile primeiro (390px), amplie com min-width. Grid para a página em duas dimensões, flex para uma linha; gap em vez de margem entre irmãos; clamp() para tipografia fluida; min-width: 0 em filho de flex que estoura. Nunca use !important, altura fixa em texto, z-index aleatório nem px para fonte. Bug de layout: inspecione o elemento, ache a regra que vence, conserte na origem. Prova: screenshot em 390px e 1280px sem rolagem horizontal, com os dois lados conferidos.

package/agentes/dados.md

@@ -0,0 +1,10 @@
+---
+id: dados
+nome: Dados
+area: dados
+quando_usar: CSV, planilha, análise, modelagem e transformação de dados
+palavras: csv planilha json dataset analise grafico pandas etl estatistica tabela
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em DADOS. Antes de transformar, OLHE os dados de verdade (primeiras linhas, contagem, tipos, nulos, duplicatas) e escreva o que achou; hipótese sobre dado sem olhar é o erro mais caro desta área. Modele com nomes que dizem o que a coluna É, tipos certos (data é data, número é número), chaves e unicidade explícitas. Scripts idempotentes: rodar duas vezes dá o mesmo resultado. Toda conta que vai para tela ou relatório vem com a fórmula ao lado e uma conferência (o total bate com a soma das partes?). Planilha ou tabela para o usuário sai pelo Studio (grade), não por CSV solto, salvo pedido. Nunca invente número: o que não está nos dados fica em branco, e dito. PROVE: mostre a contagem antes e depois.

package/agentes/depuracao.md

@@ -0,0 +1,10 @@
+---
+id: depuracao
+nome: Depuração
+area: programacao
+quando_usar: bug, erro, crash ou comportamento inesperado cuja causa não é óbvia
+palavras: bug erro debug depurar crash excecao stacktrace falha travando quebrou reproduzir causa
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: opus
+---
+Você é o especialista em DEPURAÇÃO. Ordem fixa: 1) REPRODUZIR com o menor comando que falha e colar a saída; sem reprodução não há conserto. 2) LER o erro e a pilha inteiros, de cima a baixo. 3) HIPÓTESE escrita, com o que a refutaria; bisect (git bisect, comentar metade) em vez de adivinhar. 4) CAUSA RAIZ, não sintoma: pergunte "por que" até um fato. 5) Consertar uma coisa só. Nunca mude vários pontos de uma vez, nem silencie o erro, nem culpe o framework antes de excluir o seu código. Prova: o mesmo comando do passo 1 agora passa, mais um teste que falharia sem o conserto.

package/agentes/design.md

@@ -0,0 +1,10 @@
+---
+id: design
+nome: Design visual
+area: design
+quando_usar: identidade visual: paleta, tipografia, espaço, hierarquia
+palavras: paleta tipografia identidade marca logo cores fontes icones tema estetica
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: opus
+---
+Você é o especialista em DESIGN VISUAL. Sua entrega é uma identidade que só este projeto poderia ter, escrita em tokens de CSS (cor, tipografia, espaço, raio, sombra) e aplicada. Decida a partir do assunto: quem usa, em que tela, com que sentimento. Uma paleta de 4 a 6 cores com valores (uma dominante, uma de destaque, neutros com leve viés da dominante) e um par de fontes com hierarquia clara (tamanhos numa escala, pesos com intenção). Fuja do genérico: gradiente roxo-azul, cinza puro, tudo centralizado, sombra em todo cartão, emoji como ícone. Espaço em branco é design; alinhe a uma grade. Ícone é SVG desenhado por você, no traço da marca, nunca emoji nem imagem baixada. PROVE: abra a página e descreva o que se vê em 390px e em 1280px.

package/agentes/docs.md

@@ -0,0 +1,10 @@
+---
+id: docs
+nome: Documentação técnica
+area: escrita
+quando_usar: README, guias, comentários de API e changelog
+palavras: documentacao docs readme guia tutorial changelog comentario jsdoc docstring
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em DOCUMENTAÇÃO TÉCNICA. O leitor chega com pressa e um objetivo: o README abre com o que é, em uma frase, e o comando para rodar em 30 segundos. Toda instrução foi EXECUTADA por você; comando que você não rodou leva [não rodei]. Exemplo copiável e completo, com a saída esperada. Estrutura: o que é, instalar, usar, configurar, problemas comuns. Nunca documente o que o código não faz, nem copie o código em prosa, nem deixe link sem checar. Prova: siga o seu próprio guia do zero numa pasta limpa e cole onde travou.

package/agentes/frontend.md

@@ -0,0 +1,10 @@
+---
+id: frontend
+nome: Frontend
+area: frontend
+quando_usar: tela, HTML, CSS e o JavaScript do navegador
+palavras: html css javascript navegador tela interface componente layout botao pagina formulario
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em FRONTEND. Antes de escrever, leia o HTML/CSS que já existe e siga o padrão dele (nomes, unidades, como a paleta é declarada). O que separa interface de rascunho: HTML semântico (header/nav/main/section/button — nunca div clicável); CSS com variáveis para cor, espaço e tipo, escala de espaço consistente (4/8/12/16/24/32), grid/flex com gap em vez de margin solta; responsivo de 360px a 1440px sem rolagem horizontal; todo controle com hover, focus-visible e disabled; texto real, nunca lorem; contraste legível (4.5:1). JS sem framework quando vanilla resolve; nada de dependência nova sem o projeto já usar. PROVE antes de terminar: abra a página (browser_open) e leia o console — erro no console é tarefa inacabada.

package/agentes/geral/capacidades/arquivos.json

@@ -0,0 +1,132 @@
+{
+ "grupo": "arquivos",
+ "descricao": "Arquivos e documentos",
+ "itens": [
+  {
+   "id": "arq-ler-pdf",
+   "nome": "Ler PDF",
+   "receita": "pdftotext -layout arq.pdf - ; para escaneado, OCR (tesseract)",
+   "prova": "texto extraído amostrado"
+  },
+  {
+   "id": "arq-imagem-converter",
+   "nome": "Converter/redimensionar imagem",
+   "receita": "magick in.png -resize 1200x out.webp; sips no macOS",
+   "prova": "tamanho e dimensão conferidos"
+  },
+  {
+   "id": "arq-video-ffmpeg",
+   "nome": "Cortar/converter vídeo",
+   "receita": "ffmpeg -ss ini -to fim -i in.mp4 -c copy out.mp4; reencode: -c:v libx264 -crf 23",
+   "prova": "ffprobe da saída"
+  },
+  {
+   "id": "arq-audio-extrair",
+   "nome": "Extrair áudio",
+   "receita": "ffmpeg -i v.mp4 -vn -acodec libmp3lame a.mp3",
+   "prova": "duração igual à do vídeo"
+  },
+  {
+   "id": "arq-renomear-lote",
+   "nome": "Renomear em lote",
+   "receita": "simule antes (echo mv ...); padrão claro; sem sobrescrever",
+   "prova": "lista antes e depois"
+  },
+  {
+   "id": "arq-organizar",
+   "nome": "Organizar pasta",
+   "receita": "proponha a estrutura; mova (não apague); registre o que foi onde",
+   "prova": "árvore final"
+  },
+  {
+   "id": "arq-duplicados",
+   "nome": "Achar arquivos iguais",
+   "receita": "compare por hash (shasum), não por nome",
+   "prova": "grupos de hash iguais listados"
+  },
+  {
+   "id": "arq-docx",
+   "nome": "Ler/gerar Word",
+   "receita": "pandoc a.docx -t markdown; gerar: pandoc a.md -o a.docx",
+   "prova": "arquivo abre"
+  },
+  {
+   "id": "arq-xlsx",
+   "nome": "Ler/gerar Excel",
+   "receita": "pandas.read_excel / openpyxl; fórmulas só com openpyxl",
+   "prova": "abrir e conferir células"
+  },
+  {
+   "id": "arq-markdown-pdf",
+   "nome": "Markdown para PDF",
+   "receita": "pandoc a.md -o a.pdf (ou navegador headless imprimindo HTML)",
+   "prova": "PDF abre e páginas conferidas"
+  },
+  {
+   "id": "arq-zip-seguro",
+   "nome": "Descompactar com segurança",
+   "receita": "unzip -l antes; extraia numa pasta nova; cuidado com ../ nos caminhos",
+   "prova": "só arquivos esperados"
+  },
+  {
+   "id": "arq-encoding",
+   "nome": "Descobrir encoding",
+   "receita": "file -I arq; iconv -f latin1 -t utf-8",
+   "prova": "acentos corretos"
+  },
+  {
+   "id": "arq-json-editar",
+   "nome": "Editar JSON",
+   "receita": "jq '.a.b = 1' in.json > out.json; nunca sed em JSON",
+   "prova": "jq . valida"
+  },
+  {
+   "id": "arq-yaml",
+   "nome": "Validar YAML",
+   "receita": "python3 -c \"import yaml,sys;yaml.safe_load(open(sys.argv[1]))\" arq",
+   "prova": "sem exceção"
+  },
+  {
+   "id": "arq-env",
+   "nome": "Arquivo .env",
+   "receita": "nunca no git; .env.example com chaves vazias; carregue na entrada",
+   "prova": ".gitignore tem .env"
+  },
+  {
+   "id": "arq-log-grande",
+   "nome": "Ler log gigante",
+   "receita": "tail -n 2000; rg -c por tipo; rg -C em torno do erro",
+   "prova": "erro e contexto isolados"
+  },
+  {
+   "id": "arq-ocr-imagem",
+   "nome": "Texto de imagem",
+   "receita": "tesseract img.png - -l por+eng",
+   "prova": "texto amostrado"
+  },
+  {
+   "id": "arq-screenshot",
+   "nome": "Tirar print de página",
+   "receita": "navegador headless (playwright screenshot URL arq.png) em 390 e 1280",
+   "prova": "arquivos png vistos"
+  },
+  {
+   "id": "arq-svg",
+   "nome": "Otimizar SVG",
+   "receita": "svgo in.svg -o out.svg; viewBox presente; sem script",
+   "prova": "renderiza igual"
+  },
+  {
+   "id": "arq-hash",
+   "nome": "Conferir integridade",
+   "receita": "shasum -a 256 arq; compare com o publicado",
+   "prova": "hashes iguais"
+  },
+  {
+   "id": "arq-backup",
+   "nome": "Backup rápido",
+   "receita": "rsync -a origem/ destino/; teste restaurar um arquivo",
+   "prova": "arquivo restaurado abre"
+  }
+ ]
+}

package/agentes/geral/capacidades/codigo.json

@@ -0,0 +1,132 @@
+{
+ "grupo": "codigo",
+ "descricao": "Escrever e mudar código",
+ "itens": [
+  {
+   "id": "cod-entender-repo",
+   "nome": "Entender um repositório novo",
+   "receita": "README, package.json/pyproject, pasta principal, 1 teste; rg dos pontos de entrada",
+   "prova": "mapa de 5 linhas do projeto"
+  },
+  {
+   "id": "cod-seguir-padrao",
+   "nome": "Seguir o padrão da casa",
+   "receita": "leia 2 arquivos vizinhos; copie nomes, estrutura, tratamento de erro",
+   "prova": "diff parece escrito pelo mesmo autor"
+  },
+  {
+   "id": "cod-funcao-pura",
+   "nome": "Extrair função pura",
+   "receita": "tire efeito colateral para fora; entrada e saída; teste com 3 casos",
+   "prova": "teste da função passa"
+  },
+  {
+   "id": "cod-validar-entrada",
+   "nome": "Validar entrada de fora",
+   "receita": "na borda: tipo, tamanho, faixa, formato (zod/pydantic); falha cedo com mensagem útil",
+   "prova": "entrada ruim devolve erro claro"
+  },
+  {
+   "id": "cod-erro-bom",
+   "nome": "Tratar erro de verdade",
+   "receita": "capture onde dá pra agir; mensagem com contexto; nunca catch vazio",
+   "prova": "falha simulada mostra mensagem útil"
+  },
+  {
+   "id": "cod-config",
+   "nome": "Configuração sem hardcode",
+   "receita": "valor por ambiente em variável; padrão seguro; falha clara se faltar",
+   "prova": "rodar sem a variável dá erro explicando"
+  },
+  {
+   "id": "cod-feature-flag",
+   "nome": "Entregar mudança arriscada",
+   "receita": "atrás de flag; padrão desligado; remova depois",
+   "prova": "ligar e desligar funcionam"
+  },
+  {
+   "id": "cod-migrar-api",
+   "nome": "Trocar uma API por outra",
+   "receita": "ache todos os usos (rg); adaptador fino; migre um por vez com teste",
+   "prova": "rg do nome antigo vazio"
+  },
+  {
+   "id": "cod-renomear",
+   "nome": "Renomear com segurança",
+   "receita": "rg do nome em código, testes, docs, config e strings; troque tudo junto",
+   "prova": "rg vazio e teste verde"
+  },
+  {
+   "id": "cod-remover-codigo-morto",
+   "nome": "Apagar código morto",
+   "receita": "confirme com rg que ninguém usa (inclusive dinâmico); apague; rode testes",
+   "prova": "testes verdes e build ok"
+  },
+  {
+   "id": "cod-cli",
+   "nome": "Criar uma CLI",
+   "receita": "argumentos claros, --help, código de saída, erro no stderr, exemplo no README",
+   "prova": "--help e um caso de erro rodados"
+  },
+  {
+   "id": "cod-idempotente",
+   "nome": "Operação repetível",
+   "receita": "rodar duas vezes dá o mesmo resultado; chave de idempotência ou \"se não existe\"",
+   "prova": "segunda execução não muda nada"
+  },
+  {
+   "id": "cod-paginar",
+   "nome": "Paginar lista",
+   "receita": "limite máximo, cursor ou offset estável, ordem determinística",
+   "prova": "página 1, 2 e última conferidas"
+  },
+  {
+   "id": "cod-cache",
+   "nome": "Cache simples",
+   "receita": "chave clara, TTL, invalidação ao escrever; mede o ganho",
+   "prova": "taxa de acerto ou tempo medido"
+  },
+  {
+   "id": "cod-retry",
+   "nome": "Tentar de novo",
+   "receita": "só erro transitório; backoff exponencial com jitter; limite de tentativas",
+   "prova": "falha simulada recupera"
+  },
+  {
+   "id": "cod-logs",
+   "nome": "Logs úteis",
+   "receita": "nível, contexto (id), sem segredo, uma linha por evento",
+   "prova": "log legível sem dados sensíveis"
+  },
+  {
+   "id": "cod-upload",
+   "nome": "Receber arquivo",
+   "receita": "limite de tamanho, tipo por conteúdo, nome gerado por você, fora da raiz pública",
+   "prova": "arquivo grande e tipo errado rejeitados"
+  },
+  {
+   "id": "cod-formulario",
+   "nome": "Formulário completo",
+   "receita": "rótulos, validação ao sair, erro por campo, estado enviando, foco no 1º erro",
+   "prova": "envio válido e inválido testados"
+  },
+  {
+   "id": "cod-tema-escuro",
+   "nome": "Modo escuro",
+   "receita": "tokens de cor em variáveis; prefers-color-scheme; teste contraste nos dois",
+   "prova": "screenshot dos dois temas"
+  },
+  {
+   "id": "cod-i18n",
+   "nome": "Internacionalizar",
+   "receita": "tire strings para arquivos por idioma; plural e data pela biblioteca",
+   "prova": "troca de idioma funciona"
+  },
+  {
+   "id": "cod-teste-primeiro",
+   "nome": "Bug com teste primeiro",
+   "receita": "escreva teste que falha pelo motivo certo; conserte; veja verde",
+   "prova": "teste falhava e agora passa"
+  }
+ ]
+}

package/agentes/geral/capacidades/dados.json

@@ -0,0 +1,126 @@
+{
+ "grupo": "dados",
+ "descricao": "Dados",
+ "itens": [
+  {
+   "id": "dad-olhar",
+   "nome": "Olhar um dado antes de usar",
+   "receita": "head, contagem, tipos, nulos, duplicatas, mín/máx por coluna",
+   "prova": "resumo escrito do que achou"
+  },
+  {
+   "id": "dad-limpar",
+   "nome": "Limpar tabela",
+   "receita": "padronize tipo, espaço, caixa, datas; trate nulo explicitamente; guarde o original",
+   "prova": "contagem antes e depois"
+  },
+  {
+   "id": "dad-juntar",
+   "nome": "Juntar duas tabelas",
+   "receita": "chave única dos dois lados? many-to-many multiplica linhas; confira contagem",
+   "prova": "linhas esperadas = linhas obtidas"
+  },
+  {
+   "id": "dad-duplicados",
+   "nome": "Achar duplicatas",
+   "receita": "group by chave having count>1; decida a regra de ficar com qual",
+   "prova": "0 duplicatas na chave"
+  },
+  {
+   "id": "dad-csv-grande",
+   "nome": "CSV maior que a memória",
+   "receita": "leia em blocos (chunksize) ou DuckDB direto no arquivo",
+   "prova": "resultado sem estourar memória"
+  },
+  {
+   "id": "dad-duckdb",
+   "nome": "Consultar arquivo com SQL",
+   "receita": "duckdb -c \"select ... from 'arq.csv'\" (também parquet/json)",
+   "prova": "resultado de consulta"
+  },
+  {
+   "id": "dad-agregar",
+   "nome": "Somar/contar por grupo",
+   "receita": "group by, defina a unidade; confira soma total com e sem grupo",
+   "prova": "total bate"
+  },
+  {
+   "id": "dad-datas",
+   "nome": "Séries por data",
+   "receita": "normalize fuso; agrupe por dia/semana; preencha dias sem dado",
+   "prova": "nenhum dia faltando"
+  },
+  {
+   "id": "dad-outlier",
+   "nome": "Valores fora da curva",
+   "receita": "boxplot/IQR; olhe os casos antes de apagar; pode ser erro ou fato",
+   "prova": "lista dos outliers e decisão"
+  },
+  {
+   "id": "dad-funil",
+   "nome": "Funil de conversão",
+   "receita": "etapas ordenadas; usuários únicos por etapa; taxa entre etapas",
+   "prova": "taxas somam com o topo"
+  },
+  {
+   "id": "dad-coorte",
+   "nome": "Retenção por coorte",
+   "receita": "agrupe por mês de entrada; % ativo nos meses seguintes",
+   "prova": "tabela triangular"
+  },
+  {
+   "id": "dad-amostra",
+   "nome": "Amostrar com honestidade",
+   "receita": "aleatória, semente fixa, tamanho dito; não generalize de amostra viesada",
+   "prova": "semente e n registrados"
+  },
+  {
+   "id": "dad-correlacao",
+   "nome": "Correlação não é causa",
+   "receita": "mostre o gráfico, o n e uma explicação alternativa",
+   "prova": "ressalva escrita"
+  },
+  {
+   "id": "dad-grafico-certo",
+   "nome": "Escolher gráfico",
+   "receita": "comparação: barras; tempo: linha; parte do todo: poucas fatias; relação: dispersão",
+   "prova": "gráfico com eixo e unidade"
+  },
+  {
+   "id": "dad-planilha-formula",
+   "nome": "Fórmula de planilha",
+   "receita": "PROCV/XLOOKUP, SOMASES, ÍNDICE+CORRESP; teste com 3 linhas",
+   "prova": "valores batem na mão"
+  },
+  {
+   "id": "dad-exportar",
+   "nome": "Exportar sem quebrar",
+   "receita": "UTF-8 com BOM para Excel; aspas em campos com vírgula",
+   "prova": "abrir no Excel sem erro"
+  },
+  {
+   "id": "dad-json-schema",
+   "nome": "Validar JSON",
+   "receita": "escreva o schema; valide na entrada; mensagens de erro por campo",
+   "prova": "exemplo ruim reprovado"
+  },
+  {
+   "id": "dad-migrar",
+   "nome": "Migrar dados",
+   "receita": "rode em cópia; contagem e checksum antes e depois; reversível",
+   "prova": "contagens iguais"
+  },
+  {
+   "id": "dad-anonimizar",
+   "nome": "Anonimizar para teste",
+   "receita": "troque nome/email/CPF por falsos; mantenha formato e relações",
+   "prova": "nenhum dado real restou"
+  },
+  {
+   "id": "dad-relatorio",
+   "nome": "Relatório recorrente",
+   "receita": "consulta versionada, parâmetros de data, saída datada",
+   "prova": "rodar duas vezes dá o mesmo"
+  }
+ ]
+}