Cdigo Limpo E Refinamento Aspirador

---
name: Código Limpo e Refinamento (Aspirador)
description: Skill focada em identificar e corrigir dívidas técnicas, inconsistências de design e problemas de performance no ecossistema Biodiagnóstico.
---

# Skill: Código Limpo e Refinamento (Aspirador)

Esta skill define o protocolo "Aspirador", cujo objetivo é purificar o código-fonte, eliminando redundâncias, corrigindo bugs silenciosos e garantindo que cada linha de código seja eficiente e elegante.

## 🧹 Princípios do Aspirador

1. **Modularização Extrema**: Arquivos com mais de 800 linhas (ex: `state.py`) são considerados "caixas pretas" perigosas. Devem ser fatiados em estados menores e especializados (ex: `StateAnalise`, `StateQC`, `StateFaturamento`).
2. **Design System Purista**: Qualquer estilo CSS declarado fora de `styles.py` ou sem o uso de tokens (`Color`, `Design`, `Spacing`) deve ser "aspirado" e substituído pelas constantes oficiais.
3. **Eliminação de Código Morto**: Funções que não são chamadas ou variáveis globais obsoletas devem ser removidas.
4. **UX de Alinhamento**: Tabelas e grids devem seguir o mesmo padrão de respiro e hover em todas as páginas. Se uma página "parece diferente", ela está quebrada.

## 🛠️ Ferramentas de Limpeza (Scripts)
Use esses "agentes de limpeza" para manter a casa em ordem:

1.  **Organizador de Gavetas** (O Organizador):
    - Comando: `py .agent/skills/codigo-limpo-aspirador/scripts/organizador_arquivos.py`
    - Função: Garante que todos os arquivos seguem o padrão `snake_case`.

2.  **Coletor de Lixo** (O Coletor):
    - Comando: `py .agent/skills/codigo-limpo-aspirador/scripts/coletor_lixo.py`
    - Função: Remove código comentado morto e lista TODOs esquecidos.

3.  **Padronizador de Texto** (O Professor):
    - Comando: `py .agent/skills/codigo-limpo-aspirador/scripts/padronizador_texto.py`
    - Função: Cobra Docstrings em todas as funções públicas.

4.  **Bibliotecário** (O Bibliotecário):
    - Comando: `py .agent/skills/codigo-limpo-aspirador/scripts/bibliotecario.py`
    - Função: Verifica se as dependências (pip) estão desatualizadas.

5.  **Scanner de Segurança** (O Segurança):
    - Comando: `py .agent/skills/codigo-limpo-aspirador/scripts/scanner_seguranca.py`
    - Função: Procura por senhas e chaves de API expostas no código.

## 🛠️ O Protocolo de Refinamento (Passo-a-passo)
1. Rodar os scripts acima para diagnóstico.
2. Corrigir os alertas críticos (Segurança > Lixo > Documentação).
3. **Pre-commit**: Antes de cada commit, rodar o `coletor_lixo.py` para garantir que não estamos subindo sujeira.

## 🚨 Checklist do Aspirador (Antes de entregar)
- O código está mais curto do que antes?
- A performance melhorou ou a legibilidade aumentou?
- O `Reflex Technical Guardrails` foi aplicado em 100% dos arquivos tocados?
- Existe algum comentário "TODO" ou código comentado que poderia ser deletado?