---
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