quetrex-architect
Aplicar os Padrões de Arquitetura da Quetrex
Padrões de codificação inconsistentes criam dívida técnica, vulnerabilidades de segurança e desafios de manutenção. Esta skill impõe o fluxo de trabalho TDD, o modo estrito do TypeScript, os padrões do App Router do Next.js e componentes de UI do ShadCN para cada novo recurso na Quetrex.
Baixar o ZIP da skill
Upload no Claude
Vá em Configurações → Capacidades → Skills → Upload skill
Ative e comece a usar
Testar
A utilizar "quetrex-architect". Review my new user profile page
Resultado esperado:
- Encontrados 3 problemas:
- - Linha 42: Uso do tipo any para dados do usuário (use a interface UserProfile explícita)
- - Linha 78: Validação Zod ausente no handler POST (adicionar validação de schema)
- - Linha 15: Componente client assíncrono (converter para server ou remover async)
- Veja o guia de padrões para implementações corretas.
A utilizar "quetrex-architect". Help me create a new API endpoint
Resultado esperado:
- Vou guiá-lo pelo fluxo de trabalho TDD:
- 1. Primeiro, defina o schema Zod para validação de entrada
- 2. Escreva testes que falhem para o comportamento esperado
- 3. Implemente o endpoint com consultas parametrizadas
- 4. Verifique se os testes passam
- Comece lendo o CLAUDE.md para contexto do projeto.
A utilizar "quetrex-architect". Check my new dashboard component
Resultado esperado:
- Verificando padrões do componente de dashboard:
- - Server Component (padrão): Bom
- - Tipos TypeScript: Explícitos e definidos
- - Componentes ShadCN: Usando Button e Dialog
- - Nenhum segredo hardcoded encontrado
- - Validação Zod ausente na busca de dados
Auditoria de Segurança
SeguroDocumentation-only skill providing architectural guidance. Contains no executable code, no network calls, no file writes, and no external command execution. Static findings are false positives from the analyzer misinterpreting documentation patterns and metadata fields. Previous audit correctly rated this skill as safe.
Fatores de risco
🌐 Acesso à rede (1)
⚙️ Comandos externos (10)
🔑 Variáveis de ambiente (4)
Pontuação de qualidade
O Que Você Pode Construir
Padrões de Componentes no Next.js
Garantir que novos componentes React sigam o padrão de Server Component e as diretivas de Client Component.
Validação de Rotas de API
Validar que todos os endpoints de API usam schemas Zod para validação de entrada e consultas parametrizadas.
Aplicação de Cobertura de Testes
Verificar se o código atende aos limites de cobertura antes do merge: 75 por cento no geral, 90 por cento para services.
Tente Estes Prompts
Ajude-me a configurar um novo recurso usando TDD. Leia CLAUDE.md primeiro e depois me guie para escrever testes antes da implementação.
Revise meu novo componente. Verifique se ele usa corretamente Server versus Client Components, segue os padrões ShadCN e tem tipos TypeScript adequados.
Verifique minha rota de API. Garanta que ela tenha validação Zod para toda a entrada, use consultas parametrizadas e trate erros corretamente.
Examine meu código em busca de segredos hardcoded, injeção de SQL, vulnerabilidades de XSS e verificações de autenticação ausentes.
Melhores Práticas
- Escreva testes que falhem antes de escrever o código de implementação
- Use type guards em vez de any para dados desconhecidos
- Valide todas as entradas de API com schemas Zod
Evitar
- Usar o tipo any para contornar erros do TypeScript
- Pular a validação Zod para endpoints de API rápidos
- Misturar responsabilidades de Server e Client Components
Perguntas Frequentes
Com quais ferramentas esta skill funciona?
Esta skill escreve código automaticamente?
Quais limites de cobertura são aplicados?
Como isso se integra aos fluxos de trabalho existentes?
Meus dados de código estão seguros?
Como isso é diferente de um linter?
Detalhes do Desenvolvedor
Licença
MIT
Repositório
https://github.com/Barnhardt-Enterprises-Inc/quetrex-plugin/tree/main/templates/skills/quetrex-architectReferência
main
Estrutura de arquivos
📄 SKILL.md