AnthonyPoschen/agent-skills

Programação

Use esta habilidade como ponto de entrada para trabalhos de software. Mantenha este arquivo em contexto, em seguida, carregue o menor conjunto de referências relevante para a tarefa.

Roteamento

• Para escrever novo código ou estender comportamento, leia ./references/implementation.md.
• Para refatoração, limpeza, simplificação, extração, reestruturação ou reescrita de trabalho, leia ./references/refactoring.md.
• Para revisão de código, revisão de PR, crítica de diff ou avaliação de risco, leia ./references/review.md.
• Para depuração, testes com falha, regressões, erros de execução, falhas de CI ou correções de bugs, leia ./references/debugging.md.
• Para arquitetura, design de API, limites de módulos, direção de dependências ou discussão exclusiva de design, leia ./references/design.md.
• Para regras compartilhadas de qualidade de código, leia ./references/standards.md sempre que escrever ou alterar código, e conforme necessário durante revisão/design.
• Para estratégia de asserções (verificações de invariante, decisões de assert em depuração versus produção, e contratos fail-fast), leia ./references/assertions.md ao escrever ou revisar código que valida suposições internas.

Carregue apenas as referências necessárias para a solicitação atual do usuário. Se a tarefa tiver múltiplas fases, carregue a próxima referência quando essa fase começar.

Regras de Base

• Correção, segurança e intenção do usuário têm prioridade sobre preferências de estilo.
• Formatador do projeto, linter, testes, sistema de build, convenções do framework e padrões locais sistêmicos têm prioridade sobre os padrões padrão desta habilidade.
• Um padrão local é sistêmico quando aparece em vários arquivos próximos, é imposto por ferramentas ou faz parte de uma clara convenção de framework/aplicação. Não copie código fraco pontual apenas por estar adjacente.
• Quando não houver um padrão de projeto sistêmico, use ./references/standards.md.
• Preserve comportamento público, APIs, contratos de dados, migrações e semântica operacional, a menos que o usuário peça explicitamente para alterá-los.
• Mantenha as edições limitadas à tarefa. Melhore o código tocado o suficiente para um resultado coerente, mas não normalize código legado não relacionado.

Consulta de Exemplos

Use exemplos apenas quando a decisão de uma regra não estiver clara.

• ./examples/README.md indexa exemplos focados.
• Abra um arquivo de exemplo correspondente por vez.