primocode 10.19.0 → 11.0.0

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

package/agentes/geral/capacidades/pesquisa.json

@@ -0,0 +1,126 @@
+{
+ "grupo": "pesquisa",
+ "descricao": "Pesquisa e investigação",
+ "itens": [
+  {
+   "id": "pes-pergunta",
+   "nome": "Afinar a pergunta",
+   "receita": "escreva o que muda a decisão; o que já se sabe; o prazo da informação",
+   "prova": "pergunta em 1 frase"
+  },
+  {
+   "id": "pes-fonte-primaria",
+   "nome": "Achar fonte primária",
+   "receita": "doc oficial, repo, changelog, norma, paper; cite URL e data",
+   "prova": "link aberto e lido"
+  },
+  {
+   "id": "pes-comparar",
+   "nome": "Comparar 2 a 4 opções",
+   "receita": "critérios antes; tabela; dado e fonte por célula; recomendação com motivo",
+   "prova": "tabela e 1 recomendação"
+  },
+  {
+   "id": "pes-versao",
+   "nome": "Versão atual de uma ferramenta",
+   "receita": "changelog/releases oficiais, data do último release; confira no terminal (--version)",
+   "prova": "versão e data citadas"
+  },
+  {
+   "id": "pes-licenca",
+   "nome": "Licença de um repo",
+   "receita": "arquivo LICENSE do repo (não o README); MIT/Apache/BSD ok para copiar; GPL/AGPL só ideia",
+   "prova": "nome da licença e link do arquivo"
+  },
+  {
+   "id": "pes-numeros",
+   "nome": "Número ou estatística",
+   "receita": "ache a fonte original, o ano e a metodologia; recuse número sem origem",
+   "prova": "fonte e ano ao lado do número"
+  },
+  {
+   "id": "pes-concorrentes",
+   "nome": "Mapear concorrentes",
+   "receita": "lista de 5, preço, público, diferença, onde são fracos; prints e links",
+   "prova": "tabela com links"
+  },
+  {
+   "id": "pes-doc-lib",
+   "nome": "Usar biblioteca nova",
+   "receita": "leia a doc da versão instalada, exemplo mínimo, rode antes de integrar",
+   "prova": "exemplo mínimo rodando"
+  },
+  {
+   "id": "pes-repo-estudo",
+   "nome": "Estudar um repositório",
+   "receita": "clone raso, README, árvore, ponto de entrada, 1 fluxo ponta a ponta; rode",
+   "prova": "resumo e o que rodou"
+  },
+  {
+   "id": "pes-erro-desconhecido",
+   "nome": "Erro que não conheço",
+   "receita": "busque a mensagem exata entre aspas e o nome da lib; issue do repo primeiro",
+   "prova": "issue/commit que explica"
+  },
+  {
+   "id": "pes-contraditorio",
+   "nome": "Fontes discordam",
+   "receita": "diga que discordam, mostre as duas, explique a diferença (data, escopo)",
+   "prova": "divergência explicada"
+  },
+  {
+   "id": "pes-resumir-longo",
+   "nome": "Resumir documento grande",
+   "receita": "índice primeiro; leia por seção; resumo por seção e síntese de 5 linhas",
+   "prova": "resumo cita seções"
+  },
+  {
+   "id": "pes-timeline",
+   "nome": "Linha do tempo de um assunto",
+   "receita": "eventos com data e fonte, em ordem; marque lacunas",
+   "prova": "lista datada"
+  },
+  {
+   "id": "pes-tendencia",
+   "nome": "O que é novo na área",
+   "receita": "releases e changelogs dos últimos 90 dias; separe hype de adoção",
+   "prova": "3 itens com fonte"
+  },
+  {
+   "id": "pes-benchmark",
+   "nome": "Comparar desempenho",
+   "receita": "mesma máquina, mesmo dado, 5 rodadas, mediana",
+   "prova": "tabela com comando"
+  },
+  {
+   "id": "pes-api-terceiro",
+   "nome": "Entender API de terceiro",
+   "receita": "doc, limites, autenticação, exemplo curl que funciona",
+   "prova": "curl real 200"
+  },
+  {
+   "id": "pes-padrao",
+   "nome": "Qual o padrão da indústria",
+   "receita": "RFC/spec/guia oficial; como os 2 maiores fazem",
+   "prova": "norma citada"
+  },
+  {
+   "id": "pes-risco",
+   "nome": "Riscos de uma escolha",
+   "receita": "liste modos de falha, custo de sair, quem mantém; dê probabilidade e impacto",
+   "prova": "risco e mitigação por item"
+  },
+  {
+   "id": "pes-decisao",
+   "nome": "Registrar decisão",
+   "receita": "contexto, opções, escolha, motivo, quando rever (ADR curto)",
+   "prova": "arquivo de 10 linhas"
+  },
+  {
+   "id": "pes-checagem",
+   "nome": "Checar uma afirmação",
+   "receita": "ache a fonte primária ou desminta; marque [LI] e [NÃO CONFERI]",
+   "prova": "veredito com fonte"
+  }
+ ]
+}

package/agentes/geral/capacidades/seguranca.json

@@ -0,0 +1,132 @@
+{
+ "grupo": "seguranca",
+ "descricao": "Segurança",
+ "itens": [
+  {
+   "id": "seg-segredo-no-codigo",
+   "nome": "Achar segredo no código",
+   "receita": "rg -n \"(api[_-]?key",
+   "prova": "secret"
+  },
+  {
+   "id": "seg-revogar-chave",
+   "nome": "Chave vazou",
+   "receita": "revogue e gere nova ANTES de limpar o git; veja o log de uso",
+   "prova": "chave antiga retorna 401"
+  },
+  {
+   "id": "seg-senha",
+   "nome": "Guardar senha",
+   "receita": "argon2id ou bcrypt com custo; nunca MD5/SHA puro; nunca log de senha",
+   "prova": "hash no banco, senha em lugar nenhum"
+  },
+  {
+   "id": "seg-sqli",
+   "nome": "Injeção de SQL",
+   "receita": "parâmetros (?, $1) sempre; nunca concatenar entrada",
+   "prova": "payload ' OR 1=1-- não altera a consulta"
+  },
+  {
+   "id": "seg-xss",
+   "nome": "XSS",
+   "receita": "escape por contexto; textContent em vez de innerHTML; CSP; sanitize HTML permitido",
+   "prova": "<script> digitado aparece como texto"
+  },
+  {
+   "id": "seg-csrf",
+   "nome": "CSRF",
+   "receita": "SameSite=Lax/Strict, token em formulário, cheque Origin",
+   "prova": "POST de outro site rejeitado"
+  },
+  {
+   "id": "seg-ssrf",
+   "nome": "SSRF",
+   "receita": "nunca buscar URL do usuário sem lista de destinos; bloqueie IPs internos",
+   "prova": "http://169.254.169.254 recusado"
+  },
+  {
+   "id": "seg-autorizacao",
+   "nome": "Autorização por recurso",
+   "receita": "em TODA rota, cheque se o usuário é dono do id pedido (IDOR)",
+   "prova": "usuário A não lê dado do B"
+  },
+  {
+   "id": "seg-jwt",
+   "nome": "JWT sem erro",
+   "receita": "assine com segredo forte, valide alg/exp/aud, curta duração, refresh seguro",
+   "prova": "token adulterado recusado"
+  },
+  {
+   "id": "seg-cookies",
+   "nome": "Cookies de sessão",
+   "receita": "HttpOnly, Secure, SameSite; rotacione ao logar",
+   "prova": "flags vistas no DevTools"
+  },
+  {
+   "id": "seg-dependencias",
+   "nome": "Dependência vulnerável",
+   "receita": "npm audit / pip-audit; atualize a menor versão que corrige; teste",
+   "prova": "auditoria sem alta/crítica"
+  },
+  {
+   "id": "seg-upload",
+   "nome": "Upload seguro",
+   "receita": "tipo pelo conteúdo, limite, nome gerado, fora do diretório público",
+   "prova": ".php disfarçado recusado"
+  },
+  {
+   "id": "seg-path-traversal",
+   "nome": "Caminho de arquivo",
+   "receita": "resolva o caminho e confira que continua dentro da pasta base",
+   "prova": "../../etc/passwd recusado"
+  },
+  {
+   "id": "seg-shell-injection",
+   "nome": "Injeção de comando",
+   "receita": "passe argumentos em array (execFile/subprocess sem shell), nunca monte string",
+   "prova": "; rm -rf digitado vira texto"
+  },
+  {
+   "id": "seg-rate-limit",
+   "nome": "Limitar tentativas",
+   "receita": "por IP e por conta; backoff; bloqueio temporário; avisar o dono",
+   "prova": "6ª tentativa recusada"
+  },
+  {
+   "id": "seg-logs-sem-segredo",
+   "nome": "Logs sem segredo",
+   "receita": "mascare token, senha, cartão, CPF; teste com dado falso",
+   "prova": "rg pelo valor de teste nos logs vazio"
+  },
+  {
+   "id": "seg-permissao-minima",
+   "nome": "Permissão mínima",
+   "receita": "chave com escopo só do que usa; usuário de banco sem DROP; container não-root",
+   "prova": "teste de permissão negada"
+  },
+  {
+   "id": "seg-backup-teste",
+   "nome": "Backup que restaura",
+   "receita": "restaure num ambiente de teste e confira",
+   "prova": "restauração concluída"
+  },
+  {
+   "id": "seg-headers-https",
+   "nome": "Transporte seguro",
+   "receita": "HTTPS em tudo, HSTS, cookies Secure, TLS atual",
+   "prova": "curl confere"
+  },
+  {
+   "id": "seg-checklist-deploy",
+   "nome": "Checklist antes do deploy",
+   "receita": "debug desligado, segredos em variáveis, CORS restrito, erros sem pilha ao usuário, backups",
+   "prova": "lista marcada item a item"
+  },
+  {
+   "id": "seg-modelo-ameaca",
+   "nome": "Modelo de ameaça rápido",
+   "receita": "ativos, quem ataca, por onde entra, o que perde; 5 riscos ordenados",
+   "prova": "tabela de 5 linhas com mitigação"
+  }
+ ]
+}