primocode 10.17.1 → 11.0.0

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

package/agentes/geral/capacidades/shell.json

@@ -0,0 +1,132 @@
+{
+ "grupo": "shell",
+ "descricao": "Shell e terminal",
+ "itens": [
+  {
+   "id": "sh-achar-arquivo",
+   "nome": "Achar arquivos por nome",
+   "receita": "fd nome ou find . -name '*.ext' -not -path '*/node_modules/*'",
+   "prova": "lista com caminhos"
+  },
+  {
+   "id": "sh-achar-texto",
+   "nome": "Achar texto no código",
+   "receita": "rg -n \"texto\" --glob '!node_modules'; -C 2 para contexto",
+   "prova": "linhas com arquivo:número"
+  },
+  {
+   "id": "sh-trocar-em-massa",
+   "nome": "Trocar texto em vários arquivos",
+   "receita": "rg -l \"velho\" ",
+   "prova": " xargs sed -i '' 's/velho/novo/g' (macOS); rode o rg antes para ver o alvo"
+  },
+  {
+   "id": "sh-processos",
+   "nome": "Ver e matar processo",
+   "receita": "lsof -i :PORTA ou ps aux ",
+   "prova": " rg nome; kill PID (kill -9 só se travar)"
+  },
+  {
+   "id": "sh-porta-ocupada",
+   "nome": "Porta já em uso",
+   "receita": "lsof -nP -iTCP:3000 -sTCP:LISTEN; mate o PID ou use outra porta",
+   "prova": "servidor sobe na porta"
+  },
+  {
+   "id": "sh-espaco-disco",
+   "nome": "O que ocupa disco",
+   "receita": "du -sh * ",
+   "prova": " sort -h "
+  },
+  {
+   "id": "sh-tamanho-arquivos",
+   "nome": "Maiores arquivos do projeto",
+   "receita": "find . -type f -not -path './.git/*' -exec du -k {} + ",
+   "prova": " sort -n "
+  },
+  {
+   "id": "sh-variaveis",
+   "nome": "Variável de ambiente certa",
+   "receita": "printenv NOME; export NOME=valor vale só na sessão; arquivo .env com set -a; . ./.env; set +a",
+   "prova": "echo \"${NOME:+definida}\""
+  },
+  {
+   "id": "sh-cron",
+   "nome": "Agendar tarefa",
+   "receita": "crontab -e: min hora dia mes semana comando; no macOS prefira launchd; log com >> arquivo 2>&1",
+   "prova": "execução registrada no log"
+  },
+  {
+   "id": "sh-pipe-json",
+   "nome": "Ler JSON no terminal",
+   "receita": "curl -s url ",
+   "prova": " jq '.campo[] "
+  },
+  {
+   "id": "sh-baixar",
+   "nome": "Baixar arquivo",
+   "receita": "curl -fL -o saida url (falha com código); confira o tamanho",
+   "prova": "ls -lh e file saida"
+  },
+  {
+   "id": "sh-comprimir",
+   "nome": "Compactar e extrair",
+   "receita": "tar -czf a.tgz pasta; tar -xzf a.tgz; unzip -l a.zip lista sem extrair",
+   "prova": "listagem confere"
+  },
+  {
+   "id": "sh-permissao",
+   "nome": "Permissão negada",
+   "receita": "ls -l; chmod u+x script; dono errado: chown (com cuidado, nunca recursivo na raiz)",
+   "prova": "comando roda"
+  },
+  {
+   "id": "sh-script-seguro",
+   "nome": "Script bash robusto",
+   "receita": "set -euo pipefail; aspas em \"$var\"; trap para limpar; shellcheck",
+   "prova": "shellcheck sem aviso"
+  },
+  {
+   "id": "sh-rodar-paralelo",
+   "nome": "Rodar tarefas em paralelo",
+   "receita": "xargs -P 4 -n 1 comando < lista; ou & e wait",
+   "prova": "todas terminam e o código de saída é checado"
+  },
+  {
+   "id": "sh-observar-log",
+   "nome": "Seguir um log",
+   "receita": "tail -f arquivo ",
+   "prova": " rg --line-buffered ERRO"
+  },
+  {
+   "id": "sh-medir-tempo",
+   "nome": "Medir tempo de comando",
+   "receita": "time comando; hyperfine 'a' 'b' para comparar",
+   "prova": "tempo anotado antes e depois"
+  },
+  {
+   "id": "sh-diff-pastas",
+   "nome": "Comparar duas pastas",
+   "receita": "diff -rq a b; rsync -avn a/ b/ simula",
+   "prova": "lista de diferenças"
+  },
+  {
+   "id": "sh-editar-linha",
+   "nome": "Mudar uma linha de arquivo",
+   "receita": "sed -n 'N,Mp' arq para ler; edite com a ferramenta de edição, não com sed frágil",
+   "prova": "trecho relido confere"
+  },
+  {
+   "id": "sh-rede-teste",
+   "nome": "Testar conexão",
+   "receita": "curl -I url; nc -vz host porta; dig dominio",
+   "prova": "status e tempo anotados"
+  },
+  {
+   "id": "sh-historico",
+   "nome": "Repetir comando anterior",
+   "receita": "ctrl-r busca; !! repete; evite colar senha no histórico",
+   "prova": "comando repetido sem segredo no histórico"
+  }
+ ]
+}

package/agentes/geral/capacidades/web.json

@@ -0,0 +1,126 @@
+{
+ "grupo": "web",
+ "descricao": "Web e API",
+ "itens": [
+  {
+   "id": "web-curl-get",
+   "nome": "Chamar API com GET",
+   "receita": "curl -sS -H 'Accept: application/json' url ",
+   "prova": " jq ."
+  },
+  {
+   "id": "web-curl-post",
+   "nome": "Chamar API com POST",
+   "receita": "curl -sS -X POST -H 'Content-Type: application/json' -d '{\"a\":1}' url",
+   "prova": "status e corpo lidos"
+  },
+  {
+   "id": "web-auth-bearer",
+   "nome": "API com token",
+   "receita": "header Authorization: Bearer $TOKEN; token vem de variável, nunca do chat",
+   "prova": "200 sem token impresso"
+  },
+  {
+   "id": "web-oauth",
+   "nome": "Fluxo OAuth",
+   "receita": "redirect, código, troca por token no servidor; state anti-CSRF; segredo só no servidor",
+   "prova": "token obtido e usado"
+  },
+  {
+   "id": "web-webhook",
+   "nome": "Receber webhook",
+   "receita": "responda 200 rápido; valide assinatura; processe em fila; seja idempotente",
+   "prova": "evento de teste processado uma vez"
+  },
+  {
+   "id": "web-ratelimit",
+   "nome": "Respeitar limite de API",
+   "receita": "leia Retry-After; backoff; fila; cache",
+   "prova": "sem 429 em 100 chamadas"
+  },
+  {
+   "id": "web-paginacao",
+   "nome": "Percorrer API paginada",
+   "receita": "siga next/cursor até acabar; limite de segurança",
+   "prova": "total coletado = total declarado"
+  },
+  {
+   "id": "web-scraping",
+   "nome": "Extrair dados de página",
+   "receita": "API oficial primeiro; senão HTML estável (seletor); respeite robots e termos; sem login alheio",
+   "prova": "10 itens extraídos conferidos"
+  },
+  {
+   "id": "web-navegador-headless",
+   "nome": "Automatizar navegador",
+   "receita": "Playwright: goto, wait por seletor (não sleep), screenshot; trace em falha",
+   "prova": "execução repetida passa"
+  },
+  {
+   "id": "web-sitemap",
+   "nome": "Mapear um site",
+   "receita": "sitemap.xml, robots.txt, links internos; liste rotas",
+   "prova": "lista de URLs"
+  },
+  {
+   "id": "web-seo-basico",
+   "nome": "SEO técnico",
+   "receita": "title/description únicos, h1, canonical, sitemap, velocidade, dados estruturados",
+   "prova": "Lighthouse SEO verde"
+  },
+  {
+   "id": "web-performance-pagina",
+   "nome": "Página mais rápida",
+   "receita": "imagens WebP e dimensionadas, fonte com swap, JS dividido, cache longo",
+   "prova": "LCP antes e depois"
+  },
+  {
+   "id": "web-headers",
+   "nome": "Headers de segurança",
+   "receita": "CSP, HSTS, X-Content-Type-Options, Referrer-Policy",
+   "prova": "curl -I confere"
+  },
+  {
+   "id": "web-cache-http",
+   "nome": "Cache HTTP",
+   "receita": "Cache-Control com max-age; ETag; arquivo com hash no nome pode ser immutable",
+   "prova": "segunda requisição vem do cache"
+  },
+  {
+   "id": "web-dns",
+   "nome": "Apontar domínio",
+   "receita": "registro A/CNAME no provedor; dig +short; espere propagar",
+   "prova": "dig devolve o IP novo"
+  },
+  {
+   "id": "web-https",
+   "nome": "Certificado HTTPS",
+   "receita": "Let's Encrypt/Cloudflare; renovação automática; redirecione http para https",
+   "prova": "curl -I https 200"
+  },
+  {
+   "id": "web-cors-config",
+   "nome": "Liberar CORS",
+   "receita": "origem específica (não *, se tiver credenciais); responda OPTIONS",
+   "prova": "chamada do navegador passa"
+  },
+  {
+   "id": "web-openapi",
+   "nome": "Descrever API",
+   "receita": "OpenAPI 3: caminhos, esquemas, erros; gere cliente e validação",
+   "prova": "swagger valida"
+  },
+  {
+   "id": "web-websocket",
+   "nome": "Tempo real",
+   "receita": "conexão, reconexão com backoff, heartbeat, mensagens com id",
+   "prova": "derrubar e voltar a conexão funciona"
+  },
+  {
+   "id": "web-feed-rss",
+   "nome": "Ler/gerar RSS",
+   "receita": "feed.xml com título, link, data, guid estável",
+   "prova": "leitor de feed abre"
+  }
+ ]
+}

package/agentes/git-pr.md

@@ -0,0 +1,10 @@
+---
+id: git-pr
+nome: Git e Pull Request
+area: devops
+quando_usar: commits, branches, conflitos, rebase e descrição de PR
+palavras: git commit branch merge rebase conflito pr pull request cherry-pick stash histórico
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em GIT. Antes de agir: git status e git log --oneline -5. Commit pequeno, uma ideia, mensagem no padrão do repo (git log mostra) dizendo o porquê. Conflito: leia os dois lados, entenda a intenção de cada um, rode o teste depois da resolução. Nunca use push --force em branch compartilhada, reset --hard sem salvar o trabalho, nem commite .env, chave ou binário grande; não commite nem dê push sem o pedido do usuário. PR: título curto, o que mudou, como testar, risco. Prova: git status limpo, git log mostrando o resultado, e o teste verde depois da mesclagem.

package/agentes/indice.md

@@ -0,0 +1,86 @@
+# Agentes só-índice: id|Nome|area|quando_usar|palavras (briefing completo: agentes/<id>.md). Ver docs/rebuild/agentes-arquitetura.md
+javascript|JavaScript|programacao|JS de navegador e Node, closures, async, DOM|javascript js dom closure promise async es6
+go|Go|programacao|serviços, goroutines, CLIs e módulos Go|go golang goroutine channel gomod
+rust|Rust|programacao|ownership, lifetimes, cargo, performance de sistema|rust cargo borrow lifetime crate tokio
+java|Java|programacao|Spring, JVM, Maven/Gradle, servidores Java|java spring maven gradle jvm kotlin
+csharp|C# e .NET|programacao|ASP.NET, LINQ, .NET e Unity|csharp dotnet aspnet linq unity
+php|PHP e Laravel|programacao|Laravel, WordPress, composer|php laravel composer wordpress symfony
+ruby|Ruby e Rails|programacao|Rails, gems, ActiveRecord|ruby rails gem activerecord
+swift|Swift e iOS|mobile|apps iOS/macOS, SwiftUI, Xcode|swift ios swiftui xcode macos
+kotlin|Kotlin e Android|mobile|apps Android, Jetpack Compose, Gradle|kotlin android compose gradle
+flutter|Flutter e Dart|mobile|apps multiplataforma em Flutter|flutter dart widget
+react-native|React Native|mobile|apps móveis em React Native e Expo|reactnative expo native mobile
+bash|Shell e Bash|programacao|scripts de shell, pipes, sed/awk, cron|bash shell zsh script sed awk cron pipe
+cpp|C e C++|programacao|C/C++, CMake, memória, embarcado|cpp c++ cmake ponteiro memoria embarcado
+vue|Vue e Nuxt|frontend|Vue 3, composition API, Nuxt|vue nuxt pinia composition
+svelte|Svelte e SvelteKit|frontend|Svelte, runes, SvelteKit|svelte sveltekit runes
+angular|Angular|frontend|Angular, RxJS, módulos e DI|angular rxjs ngrx
+tailwind|Tailwind CSS|frontend|utilitários Tailwind, tokens, temas|tailwind utility classe tema
+animacao-web|Animação web|frontend|transições CSS, GSAP, Framer Motion, scroll|animacao animation gsap framer transicao scroll
+web3d|3D na web|frontend|Three.js, WebGL, shaders|three threejs webgl 3d shader glb
+canvas|Canvas e SVG|frontend|desenho em canvas, SVG, gráficos manuais|canvas svg desenho grafico
+pwa|PWA e offline|frontend|service worker, manifesto, instalável|pwa serviceworker offline manifest
+extensao-chrome|Extensão de navegador|frontend|extensões Chrome/Firefox, manifest v3|extensao chrome firefox manifest
+electron|Electron e desktop|programacao|apps desktop Electron/Tauri|electron tauri desktop
+graphql|GraphQL|backend|schemas, resolvers, N+1|graphql resolver schema apollo
+websocket|Tempo real|backend|WebSocket, SSE, filas de eventos|websocket sse tempo real socket evento
+filas|Filas e jobs|backend|BullMQ, Celery, cron, retry, idempotência|fila queue job worker bullmq celery retry
+auth|Autenticação|backend|login, OAuth, sessão, JWT, SSO|auth login oauth jwt sessao sso senha
+pagamentos|Pagamentos|backend|Stripe, Pix, assinatura, webhook de pagamento|pagamento stripe pix checkout assinatura cobranca
+mongodb|MongoDB e NoSQL|banco-de-dados|documentos, agregação, índices NoSQL|mongodb nosql agregacao documento dynamodb
+redis|Redis e cache|banco-de-dados|cache, filas, rate limit, TTL|redis cache ttl ratelimit
+orm|ORM e migrações|banco-de-dados|Prisma, Drizzle, SQLAlchemy, migrations|orm prisma drizzle sqlalchemy migration
+firebase|Firebase e Supabase|backend|Firestore, Auth, Storage, regras|firebase supabase firestore baas
+docker|Docker e containers|devops|Dockerfile, compose, imagens enxutas|docker container compose dockerfile imagem
+ci-cd|CI/CD|devops|GitHub Actions, pipelines, deploy automático|ci cd github actions pipeline deploy workflow
+cloud|Cloud e deploy|devops|Vercel, Railway, AWS, Cloudflare, DNS|cloud aws vercel railway cloudflare dns deploy hospedagem
+kubernetes|Kubernetes|devops|manifests, helm, escala|kubernetes k8s helm pod
+observabilidade|Logs e observabilidade|devops|logs, métricas, alertas, tracing|log logs metrica alerta tracing sentry monitoramento
+linux|Linux e servidores|devops|SSH, systemd, nginx, permissões|linux ssh systemd nginx permissao servidor
+rede|Redes e HTTP|devops|DNS, TLS, proxy, CORS, depuração de rede|rede dns tls proxy cors curl porta
+testes-e2e|Testes E2E|qualidade|Playwright, Cypress, fluxos ponta a ponta|e2e playwright cypress navegador fluxo
+testes-unit|Testes unitários|qualidade|mocks, fixtures, TDD|unitario unit mock fixture tdd
+qa-manual|QA exploratório|qualidade|roteiro de teste, casos de borda, regressão manual|qa exploratorio roteiro caso borda
+testes-carga|Teste de carga|qualidade|k6, benchmark, limites de capacidade|carga k6 benchmark stress
+pentest|Pentest ético|seguranca|teste de invasão em sistema autorizado, escopo e relatório|pentest invasao vulnerabilidade escopo burp
+privacidade|LGPD e privacidade|seguranca|dados pessoais, consentimento, retenção|lgpd privacidade gdpr consentimento dado pessoal
+dados-sql-analise|Análise com SQL|dados|métricas, funil, coorte, relatório em SQL|metrica funil coorte kpi relatorio
+planilhas|Planilhas|dados|Excel/Sheets, fórmulas, tabelas dinâmicas|excel planilha sheets formula xlsx
+visualizacao|Visualização de dados|dados|gráfico certo, dashboard, cores|grafico dashboard chart visualizacao d3
+ml|Machine learning|dados|modelos, avaliação, features, sklearn|ml machine learning sklearn modelo treino
+llm-prompts|Prompts e LLM|ia|engenharia de prompt, avaliação, RAG, agentes|prompt llm rag embedding agente claude gpt
+raspagem|Raspagem e automação web|dados|scraping, Playwright, APIs não documentadas|scraping raspagem crawler automacao
+ia-evals|Avaliação de IA|ia|conjunto de testes para prompts e agentes|eval avaliacao benchmark juiz
+brand|Identidade de marca|design|logo, voz, sistema de marca|marca brand logo identidade voz
+design-system|Design system|design|tokens, componentes, documentação de UI|design system tokens componente biblioteca
+ui-mobile|UI mobile|design|padrões iOS/Android, gestos, tamanho de toque|ui mobile gestos toque ios android
+tipografia|Tipografia|design|pares de fontes, escala, legibilidade|tipografia fonte escala legibilidade
+cores|Cor e paleta|design|paleta, contraste, modo escuro|cor paleta contraste escuro
+ilustracao|Ilustração e ícones|design|ícones SVG, ilustração, pixel art|ilustracao icone svg pixel
+landing|Landing page|design|página de conversão, hierarquia, prova social|landing conversao pagina cta hero
+video-roteiro|Roteiro de vídeo|video|roteiro, gancho, estrutura de vídeo curto e longo|roteiro video gancho reels youtube
+video-edicao|Edição de vídeo|video|cortes, ritmo, legenda, ffmpeg|edicao video corte ritmo legenda ffmpeg
+motion|Motion graphics|video|animação, easing, composição, After Effects, HyperFrames|motion animacao easing aftereffects hyperframes
+audio|Áudio e trilha|video|mixagem, trilha, SFX, narração|audio trilha sfx mixagem narracao
+thumbnails|Capas e thumbnails|video|capa de vídeo, composição, texto grande|thumbnail capa miniatura
+seo|SEO|marketing|busca orgânica, metatags, estrutura, velocidade|seo busca organica meta sitemap ranking
+growth|Crescimento|marketing|funil, experimentos, retenção, métricas|growth funil experimento retencao aquisicao
+anuncios|Anúncios pagos|marketing|Meta/Google Ads, público, criativo, orçamento|anuncio ads meta google trafego criativo
+email-mkt|E-mail marketing|marketing|sequências, assunto, entregabilidade|email newsletter sequencia entregabilidade
+social|Redes sociais|marketing|calendário, formatos, legenda|social instagram tiktok linkedin legenda
+produto|Produto e priorização|produto|PRD, escopo mínimo, priorização, métricas|produto prd mvp priorizacao roadmap escopo
+pesquisa-usuario|Pesquisa com usuário|produto|entrevista, hipótese, teste de usabilidade|entrevista usuario pesquisa hipotese persona
+negocio|Negócio e preço|produto|modelo de receita, preço, concorrência|preco precificacao negocio receita concorrente
+traducao|Tradução e i18n|escrita|tradução, localização, strings de interface|traducao i18n idioma localizacao
+revisao-texto|Revisão de texto|escrita|gramática, clareza, tom, corte de palavras|revisar texto gramatica clareza tom
+apresentacao|Apresentações|escrita|slides, narrativa, estrutura de fala|slides apresentacao pitch deck narrativa
+juridico-basico|Termos e contratos|escrita|rascunho de termos, política, checklist (não substitui advogado)|termos contrato politica privacidade
+arquitetura|Arquitetura de software|programacao|decisão de estrutura, trade-offs, módulos, ADR|arquitetura adr modulo acoplamento trade-off
+legado|Código legado|programacao|entender e mexer em código sem teste e sem dono|legado heranca sem teste migracao
+algoritmos|Algoritmos|programacao|estrutura de dados, complexidade, problemas de lógica|algoritmo complexidade estrutura recursao grafo
+regex|Expressões regulares|programacao|criar e depurar regex, parsing de texto|regex expressao regular parsing
+automacao|Automação e scripts|devops|cron, launchd, atalhos, integrações simples|automacao cron launchd zapier integracao
+mcp|MCP e ferramentas de IA|ia|criar/conectar servidores MCP, tool design|mcp ferramenta tool servidor protocolo
+games|Jogos|programacao|loop de jogo, física, Godot, Phaser, Unity|jogo game godot phaser unity sprite
+iot|Hardware e IoT|programacao|Arduino, ESP32, sensores, MQTT|arduino esp32 sensor mqtt hardware
+blockchain|Blockchain|programacao|contratos inteligentes, wallets, auditoria|blockchain solidity contrato wallet

package/agentes/nextjs.md

@@ -0,0 +1,10 @@
+---
+id: nextjs
+nome: Next.js
+area: frontend
+quando_usar: App Router, SSR, server actions, rotas e cache no Next.js
+palavras: nextjs next app router ssr rsc server actions middleware vercel ssg isr
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em NEXT.JS. Descubra a versão e se usa app/ ou pages/ antes de escrever. Padrão: Server Component; "use client" só na folha que precisa de estado ou evento. Dado se busca no servidor; entenda o cache (fetch, revalidate, dynamic) antes de culpar o framework. Variável pública só com NEXT_PUBLIC_, segredo nunca no cliente. Server action valida entrada e checa quem chamou. Nunca importe módulo de servidor em componente cliente. Prova: next build sem erro e a rota aberta no navegador (ou curl) mostrando o conteúdo esperado, com o log de build colado.

package/agentes/node.md

@@ -0,0 +1,10 @@
+---
+id: node
+nome: Node.js
+area: programacao
+quando_usar: scripts, CLIs, servidores e módulos Node
+palavras: node nodejs npm esm commonjs stream fs process cli script express
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em NODE.JS. Veja package.json (type, engines, scripts) e a versão de node antes de usar sintaxe ou API nova. Siga ESM ou CommonJS conforme o projeto, não misture. Async de verdade: await em tudo que devolve promessa, tratamento de rejeição no topo, nada de callback solto; arquivo grande vira stream. Processo longo trata SIGINT e fecha recursos. Caminho com path.join, nunca concatenado; variável de ambiente com valor padrão explícito. Nunca engula erro com catch vazio nem use execSync com texto vindo de fora. Prova: rode o script ou o servidor de verdade com uma entrada real e uma inválida, e cole a saída.

package/agentes/performance.md

@@ -0,0 +1,10 @@
+---
+id: performance
+nome: Performance
+area: programacao
+quando_usar: lentidão, uso de memória, tempo de carga e gargalos
+palavras: performance lento lentidao otimizar memoria cache profiling gargalo latencia bundle carregamento
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: opus
+---
+Você é o especialista em PERFORMANCE. Regra única: meça, não chute. 1) Defina a métrica e o valor atual (ms, MB, requisições, bytes) rodando de verdade. 2) Ache o gargalo com profiler/EXPLAIN/DevTools: ele quase nunca está onde se imagina. 3) Mude UMA coisa e meça de novo. Ganho comum: consulta N+1, índice, cache, trabalho repetido em laço, bundle grande, imagem sem otimizar. Nunca otimize sem número, nem sacrifique legibilidade por ganho de 2%. Prova: tabela antes/depois da mesma medição, mesmo comando, e o teste funcional ainda verde.

package/agentes/pesquisa.md

@@ -0,0 +1,10 @@
+---
+id: pesquisa
+nome: Pesquisa na web
+area: pesquisa
+quando_usar: investigar um assunto, comparar opções, achar fonte e fato atual
+palavras: pesquisa pesquisar buscar fonte comparar alternativa documentacao pesquisar-web referencia mercado concorrente
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em PESQUISA. Comece pela pergunta exata e o que mudaria a decisão. Prefira fonte primária (documentação oficial, repositório, changelog, norma) a blog; anote URL e data de cada afirmação. Cruze pelo menos duas fontes para número, versão ou licença; discorde em voz alta quando elas divergirem. Separe FATO (com fonte), INFERÊNCIA e NÃO CONFERI. Nunca cite de memória como se fosse lido, nem invente link, nem dê uma lista de dez quando uma recomendação com motivo serve. Prova: devolva a recomendação em 3 linhas e a lista de fontes com URL, marcando o que foi lido na página e o que não foi.