devkit-agents

Cria e revisa automação de infraestrutura com Ansible: playbooks, roles, inventory, handlers, vars e Ansible Vault. Use quando: provisionar servidores, configurar ambientes, automatizar deploys sem Kubernetes, gerenciar configuração de múltiplos hosts.

Referência e guia de uso do AWS CLI para gerenciar recursos AWS: autenticação, IAM, EKS, ECR, S3, RDS, Secrets Manager e VPC. Use quando: provisionar ou gerenciar recursos AWS via linha de comando, scripts de automação ou pipelines CI/CD.

Referência e guia de uso do Azure CLI (az) para gerenciar recursos Azure: autenticação, resource groups, AKS, ACR, Key Vault, App Service, PostgreSQL gerenciado e networking. Use quando: provisionar ou gerenciar recursos Azure via linha de comando, scripts de automação ou pipelines CI/CD.

Aplica a identidade visual DevKit em interfaces React/Next.js com consistencia de marca, legibilidade e boas praticas de composicao. Use quando: criar telas, componentes, layouts ou qualquer UI que use marca DevKit.

Define e documenta os contratos de API REST entre camadas (frontend ↔ backend) e entre use cases e repositórios. Use quando: arquitetura foi definida e é preciso alinhar o que o backend expõe com o que o frontend consome, ou quando precisar formalizar as interfaces entre camadas internas.

Seleciona a linguagem backend ideal com base em criterios objetivos: performance, equipe, prazo, dominio e requisitos operacionais. Use quando: escolher stack antes de iniciar desenvolvimento, justificar linguagem no ADR, avaliar tradeoffs entre linguagens concorrentes.

Revisa Dockerfiles existentes em busca de problemas de segurança, performance de build, tamanho de imagem e conformidade com boas práticas SRE. Use quando: receber um Dockerfile para avaliar, antes de publicar uma imagem em produção, ou ao auditar containerização de uma aplicação legada.

Referência e guia de uso do Google Cloud SDK (gcloud) para gerenciar recursos GCP: autenticação, GKE, Artifact Registry, Cloud Run, IAM e Cloud SQL. Use quando: provisionar ou gerenciar recursos GCP via linha de comando, scripts de automação ou pipelines CI/CD.

Gera arquivos de migration PostgreSQL seguindo as boas práticas do agente de banco de dados DevKit: nomenclatura, UUID, TIMESTAMPTZ, constraints nomeadas, índices e triggers de updated_at. Use quando: criar uma nova tabela, alterar schema existente, adicionar índice ou constraint.

Define e executa o padrão de trabalho com Git no repositório DevKit: branches, Conventional Commits, merge strategy e tags semver. Use quando: finalizar uma feature, criar commits, realizar merge ou tagear uma release.

Cria e revisa pipelines CI/CD com GitHub Actions: workflow syntax, jobs, steps, secrets, environments, matrix builds e reusable workflows. Use quando: automatizar build, test e deploy de qualquer aplicação no GitHub, criar pipelines multi-cloud (Azure/AWS/GCP) ou padronizar fluxos de CI/CD.

Guia de diagnóstico passo a passo para problemas comuns em clusters Kubernetes. Cobre: CrashLoopBackOff, OOMKilled, ImagePullBackOff, pods Pending, rolling update travado, Ingress 502/503/404, secrets não montando, HPA não escalando. Use quando: uma aplicação não está rodando como esperado no cluster.

Define o protocolo de hooks do ciclo de vida de agentes DevKit. Garante que pre e pos-acao sejam executadas consistentemente: leitura de contexto, validacao, atualizacao de estado e git workflow. Use quando: qualquer agente inicia ou conclui uma tarefa no projeto.

Gera pipelines CI/CD completos adaptados ao cloud provider e stack da aplicação. Suporta AKS (Azure DevOps / GitHub Actions + ACR), EKS (GitHub Actions + ECR), GKE (GitHub Actions / Cloud Build + Artifact Registry) e OpenShift (Tekton Pipelines ou GitHub Actions + oc CLI). Use quando: precisar automatizar build, push de imagem e deploy de uma aplicação containerizada.

Cria e mantém um banco de contexto persistente do projeto em .DevKit/context.md. Registra decisoes arquiteturais, libs adotadas, o que foi tentado, o que falhou e o que nao fazer. Use quando: iniciar qualquer sessao de desenvolvimento, finalizar uma feature, registrar uma decisao importante, ou antes de tentar algo que pode ja ter sido testado.

Executa validacao final da interface segundo as regras de identidade visual DevKit, incluindo contraste, tipografia, escalas minimas e usos proibidos. Use quando: revisar PRs de frontend e aprovar entregas visuais.

Revisa código backend em busca de vulnerabilidades do OWASP Top 10. Use quando: código de endpoint foi escrito, autenticação foi implementada, validações foram adicionadas, ou antes de considerar qualquer feature como completa. Aplicável a qualquer linguagem.

Gera a estrutura de pastas e arquivos base seguindo Clean Architecture (Robert C. Martin) adaptada à stack escolhida. Use quando: arquitetura foi definida e é hora de criar a estrutura física do projeto, qualquer linguagem (Node.js, Python, Java, Go).

Gera manifests Kubernetes completos (Deployment, Service, Ingress, ConfigMap, Secret, HPA, Namespace) adaptados por plataforma: AKS, EKS, GKE e OpenShift. Use quando: o agente SRE identificou a cloud alvo e precisa gerar os arquivos k8s com as convenções e anotações corretas de cada provider.

Configura o projeto React ou Next.js do zero com estrutura de pastas, dependências e convenções padrão do agente de frontend DevKit. Use quando: iniciar um novo projeto frontend, definir estrutura de componentes, configurar Tailwind, React Query, Zustand e roteamento.

Cria estrutura completa de projeto Rust seguindo Clean Architecture com Axum + SQLx + PostgreSQL. Usa cargo via WSL para inicializar o projeto. Use quando: iniciar um novo projeto Rust, configurar Axum, definir estrutura de handlers, repositórios e use cases.

Pesquisa CVEs, vulnerabilidades e reputacao de bibliotecas antes de adota-las. Use quando: escolher uma dependencia nova, auditar dependencias existentes, investigar se uma lib tem historico de problemas de seguranca, encontrar alternativas seguras para uma lib vulneravel.

Seleciona logo, simbolo, icones e elementos DevKit por contexto de uso (tema, fundo, tamanho e objetivo da interface). Use quando: escolher assets para header, sidebar, avatar, favicon, cards e dashboards.

Guia completo para estabelecer conexões SSH seguras: autenticação por chave (Ed25519/RSA) e por usuário/senha. Cobre geração de par de chaves, configuração do servidor, SSH config file, tunneling, SCP/SFTP e troubleshooting. Use quando: conectar a um servidor remoto, configurar acesso de um pipeline CI/CD, transferir arquivos ou diagnosticar falhas de conexão SSH.

Cria e revisa infraestrutura como código com Terraform: providers, recursos, módulos, state, workspaces e pipelines de plan/apply. Use quando: provisionar infra em Azure, AWS ou GCP de forma declarativa, criar módulos reutilizáveis, gerenciar state remoto.

Implementa tokens de design DevKit em React/Next.js com CSS variables e Tailwind, garantindo consistencia de cores, tipografia e escala visual. Use quando: configurar design system, tema global e padroes de componentes.

Workflow de pré-processamento do orquestrador DevKit. Traduz o input do usuário para inglês usando um modelo leve antes de processar com Claude Sonnet. Use quando: iniciar qualquer tarefa no orquestrador, garantir que sub-agentes recebam contexto em inglês para melhor precisão.

Aplica identidade visual do projeto em interfaces React/Next.js. Le configuracoes de toolkit.config.md e .github/brand/guide.txt. Use quando: criar telas, componentes, layouts ou qualquer UI que use a marca do projeto.

Executa validacao final da interface segundo as regras de identidade visual do projeto, lendo toolkit.config.md e .github/brand/guide.txt. Use quando: revisar PRs de frontend e aprovar entregas visuais.

Seleciona logo, simbolo, icones e elementos do projeto por contexto de uso (tema, fundo, tamanho e objetivo da interface). Le estrutura de .github/brand/. Use quando: escolher assets para header, sidebar, avatar, favicon, cards e dashboards.

Implementa tokens de design do projeto em React/Next.js com CSS variables e Tailwind, lendo as cores e tipografia de toolkit.config.md. Use quando: configurar design system, tema global e padroes de componentes.