vue-componentes/.agent/workflows/otimizar-codigos.global.md

type	name	description	scope	updatedAt
workflow	otimizar-codigos	Processo de refatoração e validação de qualidade de código	global	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

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

npx tsc --noEmit

Zero erros = prosseguir. Se houver erros, aplicar typescript-sem-any.global.md — nunca resolver com any.

5. Formatar

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