76 lines
No EOL
2.1 KiB
Markdown
76 lines
No EOL
2.1 KiB
Markdown
---
|
|
type: workflow
|
|
name: otimizar-codigos
|
|
description: Processo de refatoração e validação de qualidade de código
|
|
scope: global
|
|
updatedAt: "2026-06-01"
|
|
---
|
|
|
|
# Workflow: Qualidade e Otimização de Código
|
|
|
|
## 🎯 Objetivo
|
|
|
|
Aplicar as rules de qualidade do ecossistema Azteca em código existente ou novo, garantindo que todos os padrões sejam cumpridos antes de finalizar uma tarefa.
|
|
|
|
---
|
|
|
|
## Passos
|
|
|
|
### 1. Verificar limite de linhas
|
|
|
|
```bash
|
|
sh .agent/verificar-linhas.sh
|
|
```
|
|
|
|
Se houver violações, aplicar estratégias da rule `limite-linhas.global.md`:
|
|
- Extrair subcomponentes, mover CSS, usar Dispatch Table
|
|
- Se necessário, converter em pasta com `index.vue`
|
|
|
|
### 2. Validar estrutura Vue
|
|
|
|
Para cada componente `.vue` modificado, verificar conforme `estrutura-vue.global.md`:
|
|
- `defineComponent` presente?
|
|
- `setup()` contém lógica própria (não delegada)?
|
|
- CSS extenso foi movido para arquivo co-localizado?
|
|
|
|
### 3. Documentar código
|
|
|
|
Para cada função compartilhada criada/modificada, aplicar `jsdoc-padrao.global.md`:
|
|
- JSDoc com `@param` e `@returns`?
|
|
- Casts temporários têm comentário justificando?
|
|
- TODOs no formato padronizado?
|
|
|
|
### 4. Validar tipagem
|
|
|
|
```bash
|
|
npx tsc --noEmit
|
|
```
|
|
|
|
Zero erros = prosseguir. Se houver erros, aplicar `typescript-sem-any.global.md` — nunca resolver com `any`.
|
|
|
|
### 5. Formatar
|
|
|
|
```bash
|
|
npx biome check --write .
|
|
```
|
|
|
|
---
|
|
|
|
## Checklist Final
|
|
|
|
- [ ] `verificar-linhas.sh` passa sem violações?
|
|
- [ ] Componentes Vue usam `defineComponent`?
|
|
- [ ] Funções compartilhadas têm JSDoc?
|
|
- [ ] Casts temporários estão justificados?
|
|
- [ ] `tsc --noEmit` zero erros?
|
|
- [ ] `biome check` sem problemas?
|
|
|
|
## Rules Aplicadas
|
|
|
|
Este workflow orquestra a verificação das seguintes rules:
|
|
|
|
- `.agent/rules/limite-linhas.global.md` — máximo 250 linhas
|
|
- `.agent/rules/estrutura-vue.global.md` — defineComponent, setup, CSS, dispatch
|
|
- `.agent/rules/jsdoc-padrao.global.md` — JSDoc, casts, TODOs
|
|
- `.agent/rules/typescript-sem-any.global.md` — proibição de any
|
|
- `.agent/rules/zod-validacao-padrao.global.md` — validação de entradas externas |