.

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.
 

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": [

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