primocode 10.17.1 → 11.0.0

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"
+  }
+ ]
+}

package/agentes/geral/capacidades/depuracao.json

@@ -0,0 +1,126 @@
+{
+ "grupo": "depuracao",
+ "descricao": "Depuração",
+ "itens": [
+  {
+   "id": "dep-reproduzir",
+   "nome": "Reproduzir o bug",
+   "receita": "ache o menor comando/entrada que falha; copie a saída exata",
+   "prova": "comando que falha 3 de 3 vezes"
+  },
+  {
+   "id": "dep-ler-erro",
+   "nome": "Ler uma pilha de erro",
+   "receita": "comece pela última linha (o erro), depois o primeiro frame no SEU código",
+   "prova": "frase: \"falha em X porque Y\""
+  },
+  {
+   "id": "dep-bisect-comentar",
+   "nome": "Isolar por eliminação",
+   "receita": "comente metade do código/entrada; o bug sumiu? está na metade tirada; repita",
+   "prova": "trecho de até 10 linhas"
+  },
+  {
+   "id": "dep-print-certo",
+   "nome": "Logar com método",
+   "receita": "log antes e depois da suspeita com valores reais (JSON.stringify), não \"chegou aqui\"",
+   "prova": "valor inesperado visto"
+  },
+  {
+   "id": "dep-undefined",
+   "nome": "undefined / null inesperado",
+   "receita": "ache onde o valor nasce, não onde quebra; confira nome, caminho e forma do dado",
+   "prova": "valor aparece no log com o formato certo"
+  },
+  {
+   "id": "dep-async",
+   "nome": "Ordem errada de async",
+   "receita": "procure await esquecido, promessa solta, callback chamado duas vezes; log com timestamp",
+   "prova": "ordem dos logs confere"
+  },
+  {
+   "id": "dep-so-na-minha",
+   "nome": "Funciona aqui e não lá",
+   "receita": "compare versão, SO, variáveis, dados e rede; liste a 1ª diferença real",
+   "prova": "diferença nomeada e igualada"
+  },
+  {
+   "id": "dep-flaky",
+   "nome": "Teste intermitente",
+   "receita": "rode 20x em laço; procure tempo, ordem, estado compartilhado, rede real",
+   "prova": "20 de 20 verdes"
+  },
+  {
+   "id": "dep-memoria",
+   "nome": "Vazamento de memória",
+   "receita": "meça RSS ao longo do tempo; heap snapshot antes/depois; procure listeners e caches sem limite",
+   "prova": "curva de memória estável"
+  },
+  {
+   "id": "dep-loop-infinito",
+   "nome": "Programa travado",
+   "receita": "kill -QUIT (Node/Java mostra pilha) ou py-spy dump; veja onde está parado",
+   "prova": "linha onde trava identificada"
+  },
+  {
+   "id": "dep-regressao",
+   "nome": "Quebrou depois de uma mudança",
+   "receita": "git diff da última boa; git bisect",
+   "prova": "commit culpado"
+  },
+  {
+   "id": "dep-http-erro",
+   "nome": "Erro de HTTP",
+   "receita": "curl -v: status, headers, corpo; compare com a documentação; token expirado?",
+   "prova": "resposta 2xx"
+  },
+  {
+   "id": "dep-cors",
+   "nome": "Erro de CORS",
+   "receita": "CORS é do SERVIDOR: header Access-Control-Allow-Origin certo e resposta ao OPTIONS",
+   "prova": "chamada do navegador passa"
+  },
+  {
+   "id": "dep-import",
+   "nome": "Módulo não encontrado",
+   "receita": "confira nome, caminho relativo, extensão, ESM x CJS e se o pacote está no package.json",
+   "prova": "import resolve"
+  },
+  {
+   "id": "dep-build",
+   "nome": "Build falha",
+   "receita": "leia o PRIMEIRO erro, não os 50 seguintes; limpe cache só depois de entender",
+   "prova": "build termina com código 0"
+  },
+  {
+   "id": "dep-porta",
+   "nome": "Servidor não sobe",
+   "receita": "erro EADDRINUSE: porta ocupada; EACCES: permissão; veja o log inteiro",
+   "prova": "curl na porta responde"
+  },
+  {
+   "id": "dep-lento",
+   "nome": "Algo ficou lento",
+   "receita": "meça com profiler/time; ache o gargalo antes de mexer",
+   "prova": "número antes e depois"
+  },
+  {
+   "id": "dep-encoding",
+   "nome": "Acento quebrado",
+   "receita": "confira UTF-8 da origem ao destino (arquivo, banco, header Content-Type)",
+   "prova": "texto com acento ida e volta"
+  },
+  {
+   "id": "dep-fuso",
+   "nome": "Data/hora errada",
+   "receita": "tudo em UTC no banco; converta só na borda; confira Date vs timezone",
+   "prova": "mesma data em duas zonas"
+  },
+  {
+   "id": "dep-numero",
+   "nome": "Conta com decimal errada",
+   "receita": "nunca float para dinheiro: inteiro em centavos ou decimal",
+   "prova": "0.1+0.2 não aparece no resultado"
+  }
+ ]
+}

package/agentes/geral/capacidades/escrita.json

@@ -0,0 +1,126 @@
+{
+ "grupo": "escrita",
+ "descricao": "Escrita e comunicação",
+ "itens": [
+  {
+   "id": "esc-readme",
+   "nome": "README que funciona",
+   "receita": "o que é; instalar; usar; exemplo copiável; problemas comuns",
+   "prova": "guia seguido do zero"
+  },
+  {
+   "id": "esc-commit",
+   "nome": "Mensagem de commit",
+   "receita": "tipo(escopo): o que muda, no imperativo; corpo diz o porquê",
+   "prova": "git log legível"
+  },
+  {
+   "id": "esc-email",
+   "nome": "E-mail profissional",
+   "receita": "assunto com a ação; 1º parágrafo com o pedido; prazo; 5 linhas",
+   "prova": "resposta possível em 1 linha"
+  },
+  {
+   "id": "esc-resumo",
+   "nome": "Resumo executivo",
+   "receita": "conclusão primeiro; 3 pontos; decisão pedida; próximo passo",
+   "prova": "leitura de 30 segundos"
+  },
+  {
+   "id": "esc-changelog",
+   "nome": "Changelog",
+   "receita": "por versão: Adicionado, Mudado, Corrigido; link do PR",
+   "prova": "versão e data certas"
+  },
+  {
+   "id": "esc-titulo",
+   "nome": "Título que vende",
+   "receita": "benefício concreto, número ou prazo; 3 variações",
+   "prova": "escolha com motivo"
+  },
+  {
+   "id": "esc-cta",
+   "nome": "Botão e chamada",
+   "receita": "verbo e o que acontece (\"Criar minha conta\"); sem \"Enviar\"",
+   "prova": "texto do botão testado em 390px"
+  },
+  {
+   "id": "esc-erro-msg",
+   "nome": "Mensagem de erro",
+   "receita": "o que houve; por quê; o que fazer agora; sem culpar a pessoa",
+   "prova": "leitura sem jargão"
+  },
+  {
+   "id": "esc-vazio",
+   "nome": "Texto de estado vazio",
+   "receita": "diga o benefício e a primeira ação; um botão",
+   "prova": "tela vazia útil"
+  },
+  {
+   "id": "esc-pitch",
+   "nome": "Pitch de 1 minuto",
+   "receita": "problema, solução, prova, pedido",
+   "prova": "cabe em 150 palavras"
+  },
+  {
+   "id": "esc-post",
+   "nome": "Post para rede social",
+   "receita": "gancho na 1ª linha; 1 ideia; fecho com pergunta; formato da rede",
+   "prova": "gancho em até 12 palavras"
+  },
+  {
+   "id": "esc-roteiro-video",
+   "nome": "Roteiro curto",
+   "receita": "gancho 3s; promessa; 3 beats; fecho; marcação de imagem",
+   "prova": "duração estimada por palavra"
+  },
+  {
+   "id": "esc-tom",
+   "nome": "Ajustar tom",
+   "receita": "defina 3 adjetivos da marca; reescreva com exemplo antes e depois",
+   "prova": "texto antes e depois"
+  },
+  {
+   "id": "esc-cortar",
+   "nome": "Cortar 30% do texto",
+   "receita": "tire advérbios, repetições e introdução; mantenha números e nomes",
+   "prova": "contagem de palavras antes e depois"
+  },
+  {
+   "id": "esc-traduzir",
+   "nome": "Traduzir sem perder sentido",
+   "receita": "traduza ideia, não palavra; mantenha termos técnicos; glossário",
+   "prova": "reler no idioma de destino"
+  },
+  {
+   "id": "esc-ata",
+   "nome": "Ata de reunião",
+   "receita": "decisões, responsáveis, prazos, pendências, nessa ordem",
+   "prova": "cada decisão com dono e data"
+  },
+  {
+   "id": "esc-faq",
+   "nome": "FAQ",
+   "receita": "as 7 perguntas reais (do suporte), resposta curta primeiro",
+   "prova": "cada resposta com até 3 linhas"
+  },
+  {
+   "id": "esc-proposta",
+   "nome": "Proposta comercial",
+   "receita": "problema do cliente; entrega; prazo; preço; próximos passos",
+   "prova": "cliente entende o que compra"
+  },
+  {
+   "id": "esc-doc-api",
+   "nome": "Documentar endpoint",
+   "receita": "método, URL, parâmetros, exemplo de pedido e resposta, erros",
+   "prova": "curl do exemplo funciona"
+  },
+  {
+   "id": "esc-licoes",
+   "nome": "Lições aprendidas",
+   "receita": "o que aconteceu; por que; o que muda; dono",
+   "prova": "3 ações concretas"
+  }
+ ]
+}

package/agentes/geral/capacidades/git.json

@@ -0,0 +1,126 @@
+{
+ "grupo": "git",
+ "descricao": "Git e versionamento",
+ "itens": [
+  {
+   "id": "git-desfazer-commit",
+   "nome": "Desfazer o último commit sem perder o trabalho",
+   "receita": "git reset --soft HEAD~1 (mantém staged); --mixed tira do stage; nunca --hard sem git stash antes",
+   "prova": "git status mostra as mudanças ainda lá"
+  },
+  {
+   "id": "git-corrigir-mensagem",
+   "nome": "Corrigir a mensagem do último commit",
+   "receita": "git commit --amend -m \"nova\" (só se ainda não foi enviado)",
+   "prova": "git log -1 mostra a nova mensagem"
+  },
+  {
+   "id": "git-guardar-trabalho",
+   "nome": "Guardar trabalho em andamento",
+   "receita": "git stash push -u -m \"nome\"; voltar com git stash pop",
+   "prova": "git status limpo e stash list com o item"
+  },
+  {
+   "id": "git-nova-branch",
+   "nome": "Criar branch a partir da main atualizada",
+   "receita": "git switch main && git pull --rebase && git switch -c tipo/assunto",
+   "prova": "git branch --show-current"
+  },
+  {
+   "id": "git-conflito",
+   "nome": "Resolver conflito de merge",
+   "receita": "git status lista; abra cada arquivo, ache <<<<<<<, decida a intenção dos dois lados, git add, continue",
+   "prova": "grep -r '<<<<<<<' vazio e teste verde"
+  },
+  {
+   "id": "git-rebase-limpo",
+   "nome": "Atualizar branch com rebase",
+   "receita": "git fetch && git rebase origin/main; em conflito, resolva e git rebase --continue",
+   "prova": "git log --oneline --graph curto e linear"
+  },
+  {
+   "id": "git-achar-bug",
+   "nome": "Achar o commit que quebrou (bisect)",
+   "receita": "git bisect start; bisect bad; bisect good <sha>; rode o teste a cada passo; git bisect reset",
+   "prova": "SHA culpado e o diff dele"
+  },
+  {
+   "id": "git-quem-mudou",
+   "nome": "Ver quem mudou uma linha e por quê",
+   "receita": "git blame -L a,b arquivo; git log -S\"texto\" -- arquivo",
+   "prova": "SHA e mensagem do commit"
+  },
+  {
+   "id": "git-trazer-commit",
+   "nome": "Levar um commit para outra branch",
+   "receita": "git cherry-pick <sha>; conflito: resolva e --continue",
+   "prova": "git log mostra o commit novo"
+  },
+  {
+   "id": "git-limpar-branches",
+   "nome": "Apagar branches já mescladas",
+   "receita": "git branch --merged main ",
+   "prova": " grep -v main "
+  },
+  {
+   "id": "git-voltar-arquivo",
+   "nome": "Restaurar um arquivo de outro commit",
+   "receita": "git restore --source=<sha> -- caminho",
+   "prova": "git diff mostra só o arquivo esperado"
+  },
+  {
+   "id": "git-remover-segredo",
+   "nome": "Segredo foi commitado",
+   "receita": "REVOGUE a chave agora; depois git filter-repo ou BFG; force-push só com o aval do dono",
+   "prova": "rg pela chave em todo o histórico vazio"
+  },
+  {
+   "id": "git-gitignore",
+   "nome": "Parar de rastrear arquivo",
+   "receita": "adicione ao .gitignore e git rm --cached caminho",
+   "prova": "git status não lista mais o arquivo"
+  },
+  {
+   "id": "git-diff-util",
+   "nome": "Ler o diff antes de commitar",
+   "receita": "git diff --stat, depois git diff --staged; confira se não há .env, log ou debug esquecido",
+   "prova": "resumo do diff lido e sem sobras"
+  },
+  {
+   "id": "git-tag-release",
+   "nome": "Marcar versão",
+   "receita": "git tag -a v1.2.0 -m \"nota\"; git push origin v1.2.0 (só com pedido)",
+   "prova": "git tag -l mostra"
+  },
+  {
+   "id": "git-worktree",
+   "nome": "Trabalhar em duas branches ao mesmo tempo",
+   "receita": "git worktree add ../pasta branch",
+   "prova": "git worktree list"
+  },
+  {
+   "id": "git-descrever-pr",
+   "nome": "Escrever descrição de PR",
+   "receita": "título curto; o que mudou; por que; como testar; risco; screenshot se UI",
+   "prova": "um revisor entende sem abrir o chat"
+  },
+  {
+   "id": "git-historico-arquivo",
+   "nome": "Ver a história de um arquivo",
+   "receita": "git log --follow -p -- caminho",
+   "prova": "commits listados com o diff"
+  },
+  {
+   "id": "git-submodulo",
+   "nome": "Atualizar submódulo",
+   "receita": "git submodule update --init --recursive",
+   "prova": "git submodule status sem '-'"
+  },
+  {
+   "id": "git-reflog",
+   "nome": "Recuperar commit perdido",
+   "receita": "git reflog; git switch -c recuperada <sha>",
+   "prova": "branch nova com o commit"
+  }
+ ]
+}