Padrões Defensivos em Bash

Orientação abrangente para escrever scripts Bash prontos para produção usando técnicas de programação defensiva, tratamento de erros e melhores práticas de segurança para prevenir armadilhas comuns e garantir confiabilidade.

Use esta habilidade quando

• Escrever scripts de automação de produção
• Construir scripts de pipeline CI/CD
• Criar utilitários de administração de sistemas
• Desenvolver automação de implantação resiliente a erros
• Escrever scripts que devem lidar com casos extremos com segurança
• Construir bibliotecas de scripts shell manteníveis
• Implementar logs e monitoramento abrangentes
• Criar scripts que devem funcionar em diferentes plataformas

Não use esta habilidade quando

• Você precisa de um único comando shell ad-hoc, não de um script
• O ambiente de destino requer apenas POSIX sh estrito
• A tarefa não está relacionada a scripts shell ou automação

Instruções

1. Confirme o shell de destino, o sistema operacional e o ambiente de execução.
2. Ative o modo estrito e os padrões seguros desde o início.
3. Valide entradas, coloque variáveis entre aspas e lide com arquivos com segurança.
4. Adicione logs, armadilhas de erro e testes básicos.

Segurança

• Evite comandos destrutivos sem confirmação ou flags de "dry-run" (simulação).
• Não execute scripts como root, a menos que seja estritamente necessário.

Consulte resources/implementation-playbook.md para padrões detalhados, checklists e modelos.

Recursos

• resources/implementation-playbook.md para padrões detalhados, checklists e modelos.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como substituta para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.