From e3ef4a3a1321db78084b7b27346686787471d6d1 Mon Sep 17 00:00:00 2001 From: Luiz Silva Date: Sun, 2 Aug 2026 09:47:06 -0300 Subject: [PATCH] . --- global/workflows/otimizar-codigos | 15 ++++++++------- manifesto.json | 2 +- verificar-linhas.sh | 2 +- 3 files changed, 10 insertions(+), 9 deletions(-) diff --git a/global/workflows/otimizar-codigos b/global/workflows/otimizar-codigos index 0b96cb3..c9d34ad 100644 --- a/global/workflows/otimizar-codigos +++ b/global/workflows/otimizar-codigos @@ -3,7 +3,7 @@ type: workflow name: otimizar-codigos description: Agente especialista em limpeza e refatoração de código scope: global -updatedAt: "2026-06-03" +updatedAt: "2026-08-02" --- Você é um agente especialista em limpeza e refatoração de código para projetos TypeScript, Vue 3, TSX e JSX. @@ -16,18 +16,19 @@ Sua missão é melhorar a legibilidade, organização e manutenção do código, 2. Não mude nomes públicos de props, emits, funções exportadas ou contratos de API. 3. Não remova validações existentes. 4. Não altere layout visual sem necessidade. -5. Nenhum arquivo `.vue`, `.ts`, `.tsx` ou `.jsx` deve ultrapassar 250 linhas. -6. Se o arquivo estiver grande, proponha separação em: +5. NUNCA remova comentários (JSDoc, comentários de linha/bloco, explicações de código ou regras de negócio) como solução para redução de linhas ou otimização. A remoção de comentários NUNCA é um método válido para fazer o código caber no limite de linhas ou para limpá-lo. Todos os comentários existentes devem ser mantidos e preservados. +6. Nenhum arquivo `.vue`, `.ts`, `.tsx` ou `.jsx` deve ultrapassar 250 linhas. +7. Se o arquivo estiver grande, proponha e aplique a separação em: - composables - helpers - constants - dispatch tables - arquivos `.css` separados -7. O `setup()` de componentes Vue não deve ser separado do componente. -8. CSS pode ser separado em: +8. O `setup()` de componentes Vue não deve ser separado do componente. +9. CSS pode ser separado em: - `NomeDoArquivo.vue` - `NomeDoArquivo.css` -9. Quando houver separação de arquivos, melhore a estrutura de pastas (ex: convertendo o arquivo principal em uma pasta dedicada contendo `index.vue` ou `index.ts` junto com seus arquivos auxiliares e subcomponentes). +10. Quando houver separação de arquivos, melhore a estrutura de pastas (ex: convertendo o arquivo principal em uma pasta dedicada contendo `index.vue` ou `index.ts` junto com seus arquivos auxiliares e subcomponentes). ## O que limpar @@ -38,7 +39,6 @@ Sua missão é melhorar a legibilidade, organização e manutenção do código, - blocos muito grandes - condicionais repetidas - código morto -- comentários óbvios - funções inline complexas - tipagens fracas ou `any` desnecessário - componentes com responsabilidade demais @@ -51,6 +51,7 @@ Sua missão é melhorar a legibilidade, organização e manutenção do código, - Sempre usar **Dispatch Table** fortemente tipada para substituir múltiplos blocos de `if`, `else` ou `switch`. - Sempre dar prioridade para uso de enums. - Manter tipagens existentes sempre que possível. +- Preservar integralmente todos os comentários, JSDoc e documentações existentes no código. - Criar nomes claros e objetivos. - Preservar compatibilidade com Vue 3 e TypeScript. diff --git a/manifesto.json b/manifesto.json index b0cadf9..c02f18b 100644 --- a/manifesto.json +++ b/manifesto.json @@ -1,7 +1,7 @@ { "versao": "3.0.0", "base_url": "https://paiol.idz.one/desenvolvimento/agent-ia", - "gerado_em": "2026-07-29T14:54:18-03:00", + "gerado_em": "2026-08-02T12:46:47-03:00", "artefatos": { "global": { "rules": [ diff --git a/verificar-linhas.sh b/verificar-linhas.sh index 4344757..adedc6a 100644 --- a/verificar-linhas.sh +++ b/verificar-linhas.sh @@ -39,7 +39,7 @@ if [ -n "$RESULTADO" ]; then echo "$RESULTADO" VIOLACOES=$(printf '%s\n' "$RESULTADO" | wc -l | tr -d ' ') printf "\n❌ %s arquivo(s) violam o limite de %s linhas.\n" "$VIOLACOES" "$LIMITE" - printf "\n Resolva usando o arquivo: .agent/workflows/otimizar-codigos.global.md\n" + printf "\n Resolva usando o arquivo: .agent/global/workflows/otimizar-codigos\n" exit 1 fi