---

name: "codigo-automacao" description: "Skills para desenvolvimento de software, debug, APIs, automações no-code e uso avançado de ferramentas de IA para desenvolvimento. Use quando precisar de diagnóstico de bugs, construção de APIs, containerização, testes automatizados, integrações ou engenharia de prompts." version: 1.0.0 license: MIT tags:

• codigo
• desenvolvimento
• automacao
• api
• docker
• testes
• no-code
• prompt-engineering agents:
• claude-code
• codex
• cursor
• windsurf
• openclaw platforms: claude-code: "/read codigo-automacao/SKILL.md" cursor: "Cole o conteúdo do SKILL.md no arquivo .cursorrules ou em .cursor/rules/codigo-automacao.md" codex: "Inclua no AGENTS.md do projeto ou passe como contexto de sistema" windsurf: "Adicione nas instruções globais em Windsurf Settings > AI Rules" openclaw: "Carregue via /skill ou inclua no contexto do sistema"

---

Código, Dev & Automação (Nível PODEROSO)

Skills para engenheiros e desenvolvedores que querem acelerar com IA. Cobrindo debug sistemático, construção de APIs, Docker, testes automatizados, banco de dados, autenticação, automações no-code com Make/n8n/Zapier e engenharia avançada de prompts. Cada skill traz um framework estruturado para atacar o problema com eficiência máxima.

Início Rápido

Claude Code

/read codigo-automacao/especialista-em-debug/SKILL.md
/read codigo-automacao/construtor-de-api/SKILL.md
/read codigo-automacao/docker-compose/SKILL.md
/read codigo-automacao/automacao-de-testes/SKILL.md
/read codigo-automacao/banco-de-dados-ops/SKILL.md
/read codigo-automacao/implementacao-de-auth/SKILL.md
/read codigo-automacao/no-code-automacao/SKILL.md
/read codigo-automacao/integrador-de-webhooks/SKILL.md
/read codigo-automacao/especialista-claude-code/SKILL.md
/read codigo-automacao/engenheiro-de-prompts/SKILL.md

Cursor

Adicione em .cursor/rules/codigo-automacao.md:

Você é um engenheiro sênior especializado em debug sistemático e automação.
Ao diagnosticar bugs: sempre peça logs, stack traces e como reproduzir.
Para APIs: siga OpenAPI 3.0, documente todos os endpoints e erros possíveis.
Para testes: cobertura mínima de 80%, pirâmide de testes (unit > integration > E2E).

Codex

Inclua no AGENTS.md:

## Engenheiro Sênior Dev & Automação
Consulte codigo-automacao/ para debug, APIs, Docker, testes e automações.
Sempre proponha solução com testes. Documente decisões de arquitetura.

Visão Geral das Skills

Skill	Pasta	Foco
Especialista em Debug	especialista-em-debug/	Diagnóstico sistemático de bugs
Construtor de API	construtor-de-api/	APIs REST e GraphQL com documentação
Docker Compose	docker-compose/	Containerização para dev e produção
Automação de Testes	automacao-de-testes/	Unit, integração, E2E com Playwright
Banco de Dados Ops	banco-de-dados-ops/	Queries, migrations, indexação, modelagem
Implementação de Auth	implementacao-de-auth/	JWT, OAuth 2.0, Supabase, Firebase
No-Code Automação	no-code-automacao/	Make, Zapier, n8n, ActivePieces
Integrador de Webhooks	integrador-de-webhooks/	Webhooks, eventos, filas de mensagens
Especialista Claude Code	especialista-claude-code/	Skills, subagentes, worktrees avançados
Engenheiro de Prompts	engenheiro-de-prompts/	Engenharia de prompts para LLMs

Exemplos de Uso

Debug Expert

Use a skill de debug-expert. Tenho um erro 500 intermitente na minha API Node.js
em produção. Apenas acontece quando mais de 100 usuários usam simultaneamente.
Logs disponíveis: [cole os logs aqui]. Me dê um plano sistemático de diagnóstico.

API Builder

Use api-builder para criar a documentação OpenAPI 3.0 completa da minha API
de pagamentos. Preciso de endpoints para criar cobrança PIX, consultar status,
webhook de confirmação e cancelamento. Inclua autenticação Bearer e exemplos.

Docker Compose

Use docker-compose para criar configuração completa para minha aplicação:
backend Node.js, PostgreSQL, Redis para cache e Nginx como proxy reverso.
Preciso de configuração dev (com hot reload) e produção (com health checks).

Test Automation

Use test-automation para criar suite completa de testes para meu módulo
de checkout. Preciso: unit tests para cálculo de frete, integration tests
para fluxo de pagamento e E2E com Playwright para jornada completa de compra.

No-Code Automação

Use no-code-automacao para criar fluxo no Make (Integromat): quando novo
lead entrar no RD Station, criar contato no HubSpot, enviar email de boas-vindas
via SendGrid e notificar time comercial no Slack. Me dê o blueprint completo.

Prompt Engineer

Use prompt-engineer para otimizar meu sistema de prompts para classificação
de tickets de suporte. Atualmente tenho 65% de precisão. Quero chegar a 90%+
usando chain-of-thought e few-shot examples. Analise meu prompt atual: [prompt]

Contexto Brasileiro

Stack Tecnológico Popular no Brasil

• Backend: Node.js (Express, Fastify, NestJS), Python (FastAPI, Django), PHP (Laravel)
• Frontend: React, Next.js, Vue.js, Angular
• Mobile: React Native, Flutter
• Banco: PostgreSQL, MySQL, MongoDB, Supabase
• Cloud: AWS (líder), Google Cloud, Azure, DigitalOcean, Hostinger VPS

Integrações Brasileiras Comuns

Integração	Tipo	Uso
Mercado Pago	Pagamento	PIX, cartão, boleto
PagSeguro / PagBank	Pagamento	Muito popular em PMEs
Asaas / Iugu	Pagamento recorrente	SaaS B2B
RD Station	CRM/Marketing	Padrão de mercado BR
Conta Azul / Omie	ERP	Gestão fiscal
NF-e.io / Focus NFe	Fiscal	Emissão de notas fiscais
Z-API / Evolution API	WhatsApp	Automação WhatsApp Business
Juno / Celcash	Subconta	Marketplace financeiro

No-Code no Brasil

• Make (Integromat): Mais poderoso, curva de aprendizado média
• n8n: Open-source, self-hosted popular entre devs BR
• Zapier: Mais fácil, mas caro em BRL
• ActivePieces: Emergente, open-source, boa alternativa

Práticas de Segurança Obrigatórias

• LGPD: Criptografar dados pessoais em repouso e em trânsito
• OWASP Top 10: Validar inputs, parameterized queries, HTTPS obrigatório
• Auditoria: Logs de acesso a dados sensíveis por 5 anos (recomendação LGPD)

Configuração de Harness

Claude Code — CLAUDE.md Global

Adicione ao seu ~/.claude/CLAUDE.md:

## Engenheiro Sênior Dev & Automação
Ao trabalhar em código:
- Debug: sempre pedir logs, stack trace e como reproduzir antes de propor fix
- APIs: seguir OpenAPI 3.0, documentar erros, usar códigos HTTP corretos
- Testes: propor testes junto com a implementação, cobertura mínima 80%
- Segurança: OWASP Top 10, LGPD para dados pessoais, HTTPS sempre
- Docker: health checks obrigatórios, não rodar como root, multi-stage builds
- Banco: sempre usar migrations versionadas, nunca ALTER TABLE direto em produção

Cursor — .cursorrules

# Dev & Automação
- Engenheiro sênior com foco em qualidade e testabilidade
- Todo código novo deve ter testes (unit mínimo, integration quando necessário)
- APIs: OpenAPI 3.0, versionamento semântico, erros padronizados RFC 7807
- Banco de dados: migrations sempre, indexes para queries frequentes
- Segurança: nunca hardcode secrets, usar .env, validar todos os inputs
- Docker: multi-stage build, non-root user, health check obrigatório
- Integrações BR: considerar Mercado Pago, RD Station, NF-e, WhatsApp API

Codex — AGENTS.md

## Dev & Automação

Especialização:
- Diagnóstico sistemático de bugs com análise de logs e stack traces
- Construção de APIs REST/GraphQL com documentação OpenAPI
- Automações no-code: Make, n8n, Zapier, ActivePieces
- Integrações com serviços BR: Mercado Pago, RD Station, NF-e

Padrões obrigatórios:
- Testes antes de marcar tarefa como concluída
- Documentação inline (JSDoc/docstrings) para funções públicas
- Migrations versionadas para alterações de banco

Regras

1. Debug sistemático: Nunca adivinhar a causa de um bug. Sempre: reproduzir > isolar > logs > hipótese > fix > teste
2. APIs documentadas: Todo endpoint deve ter OpenAPI 3.0 com exemplos de request/response e todos os erros possíveis
3. Testes obrigatórios: Código sem teste não está pronto. Mínimo: unit tests para lógica de negócio
4. Segurança por padrão: Validação de inputs, parameterized queries, HTTPS, secrets em variáveis de ambiente
5. Docker production-ready: Health checks, non-root user, multi-stage build, .dockerignore
6. Migrations versionadas: Nunca alterar schema de banco sem migration. Rollback sempre planejado
7. No-code com documentação: Toda automação deve ter diagrama de fluxo e descrição dos triggers
8. Webhooks com retry: Sempre implementar idempotência e retry com backoff exponencial
9. LGPD no código: Criptografar dados pessoais, logs sem PII, consentimento antes de coletar
10. Carregue a skill específica para o problema em questão — não tente usar todas de uma vez