care-api/.cursor/auditoria.md

description, tools

description	tools
Auditoria completa do projeto com Cursor CLI - análise de produtividade e código	filesystem bash

⚡ AUDITORIA CURSOR CLI - Análise de Produtividade e Código

Auditoria sistemática do projeto $1 usando Cursor CLI com foco em produtividade de desenvolvimento e qualidade de código.

🛡️ REALITY CHECK OBRIGATÓRIO:

# SEMPRE executar antes de qualquer ação:
pwd && echo "✅ Directório confirmado"
ls -la && echo "✅ Ficheiros mapeados"
[ -f "package.json" ] && echo "✅ Node.js" || [ -f "composer.json" ] && echo "✅ PHP" || echo "⚠️ Tipo indefinido"

# Verificar Cursor CLI
command -v cursor >/dev/null 2>&1 && echo "✅ Cursor CLI disponível" || echo "❌ Cursor CLI não encontrado"

🚀 PROTOCOLO DE AUDITORIA CURSOR:

1. 📋 Configuração Automática

# Configurar Cursor CLI automaticamente
echo "⚡ Configurando Cursor CLI para auditoria automática..."

# Verificar versão do Cursor
CURSOR_VERSION=$(cursor --version 2>/dev/null || echo "não detectado")
echo "📋 Cursor Version: $CURSOR_VERSION"

# Configurar preferências para auditoria
export CURSOR_API_ENABLED="true"
export CURSOR_ANALYSIS_MODE="comprehensive"
export CURSOR_OUTPUT_FORMAT="detailed"

# Verificar plugins Cursor essenciais para auditoria
CURSOR_EXTENSIONS_DIR="$HOME/.cursor/extensions"
echo "🔍 Verificando extensões Cursor..."

# Lista de extensões recomendadas para auditoria
declare -a RECOMMENDED_EXTENSIONS=(
    "ms-python.python"
    "esbenp.prettier-vscode"
    "ms-vscode.vscode-eslint"
    "bradlc.vscode-tailwindcss"
    "ms-vscode.vscode-typescript-next"
)

for ext in "${RECOMMENDED_EXTENSIONS[@]}"; do
    if cursor --list-extensions | grep -q "$ext" 2>/dev/null; then
        echo "✅ $ext instalado"
    else
        echo "⚠️ $ext não encontrado (recomendado para auditoria)"
    fi
done

2. 🔍 Análise Automática com Cursor AI

# Função para análise com Cursor AI
analyze_with_cursor() {
    local analysis_type="$1"
    local target_files="$2"
    local output_file="$3"

    echo "⚡ Executando análise Cursor: $analysis_type"

    # Prompt optimizado para Cursor AI
    local cursor_prompt="# AUDITORIA AUTOMÁTICA - $analysis_type

Você é um auditor especialista em código e produtividade de desenvolvimento.

## OBJETIVO
Analisar este projeto de software com foco em:
- Qualidade de código e boas práticas
- Produtividade de desenvolvimento
- Otimizações para desenvolvimento com IA (Cursor)
- Refatorações e melhorias específicas

## FICHEIROS ALVO
$target_files

## INSTRUÇÕES
1. Analise profundamente os ficheiros fornecidos
2. Identifique problemas de produtividade
3. Sugira otimizações específicas para Cursor
4. Proponha refatorações concretas
5. Avalie compatibilidade com workflows de IA

## FORMATO DE RESPOSTA
```markdown
# ⚡ AUDITORIA CURSOR - $analysis_type
**Data**: $(date +%Y-%m-%d %H:%M)

## 📊 SCORE DE PRODUTIVIDADE: [XX/100]

### 🚀 OPORTUNIDADES DE ACELERAÇÃO
- [Lista numerada de otimizações específicas]

### 🔧 REFATORAÇÕES RECOMENDADAS
- [Lista numerada de refatorações concretas]

### ⚡ OTIMIZAÇÕES CURSOR AI
- [Lista de melhorias específicas para Cursor]

### 🎯 QUICK WINS (Impacto Alto, Esforço Baixo)
- [Lista de melhorias de implementação rápida]

### 📈 ROADMAP DE MELHORIAS
1. [Prioridade Alta - Implementar primeiro]
2. [Prioridade Média - Implementar após alta]
3. [Prioridade Baixa - Melhorias futuras]

### 🤖 CURSOR-SPECIFIC RECOMMENDATIONS
- Configurações de workspace recomendadas
- Extensions úteis não instaladas
- Shortcuts e workflows optimizados
```"

    # Executar análise via Cursor CLI
    if command -v cursor >/dev/null 2>&1; then
        # Tentar usar Cursor CLI com AI
        echo "$cursor_prompt" > /tmp/cursor_prompt.txt

        # Cursor analysis command (ajustar baseado na CLI real)
        cursor analyze --prompt /tmp/cursor_prompt.txt --files "$target_files" > "$output_file" 2>/dev/null

        if [ $? -ne 0 ]; then
            echo "🔧 Fallback: Análise manual estruturada..."
            manual_cursor_analysis "$analysis_type" "$target_files" "$output_file"
        fi
    else
        echo "⚠️ Cursor CLI não disponível - executando análise manual..."
        manual_cursor_analysis "$analysis_type" "$target_files" "$output_file"
    fi

    echo "✅ Análise '$analysis_type' concluída: $output_file"
}

# Função de análise manual quando Cursor CLI não está disponível
manual_cursor_analysis() {
    local analysis_type="$1"
    local target_files="$2"
    local output_file="$3"

    cat > "$output_file" << EOF
# ⚡ AUDITORIA CURSOR - $analysis_type
**Data**: $(date +%Y-%m-%d %H:%M)
**Método**: Análise manual estruturada (Cursor CLI não disponível)

## 📊 ANÁLISE ESTRUTURADA

### 🔍 Ficheiros Analisados
EOF

    # Adicionar lista de ficheiros analisados
    echo "$target_files" | tr ',' '\n' | while read file; do
        if [ -f "$file" ]; then
            lines=$(wc -l < "$file" 2>/dev/null || echo "N/A")
            echo "- \`$file\` ($lines linhas)" >> "$output_file"
        fi
    done

    cat >> "$output_file" << EOF

### 📈 Métricas Automáticas

#### Complexidade de Código
EOF

    # Análise básica de complexidade
    echo "$target_files" | tr ',' '\n' | while read file; do
        if [ -f "$file" ]; then
            # Contadores básicos
            functions=$(grep -c "function\|def\|class" "$file" 2>/dev/null || echo 0)
            comments=$(grep -c "#\|//\|/\*" "$file" 2>/dev/null || echo 0)
            lines=$(wc -l < "$file" 2>/dev/null || echo 0)

            echo "**$file**:" >> "$output_file"
            echo "- Funções/Classes: $functions" >> "$output_file"
            echo "- Comentários: $comments" >> "$output_file"
            echo "- Total linhas: $lines" >> "$output_file"
            echo "" >> "$output_file"
        fi
    done

    cat >> "$output_file" << EOF

### 🚀 RECOMENDAÇÕES AUTOMÁTICAS

#### Cursor-Specific Optimizations
- Configure workspace settings para melhor experiência com IA
- Use Cursor AI para refatoração assistida
- Implemente consistent coding patterns
- Configure snippets customizados para produtividade

#### Quick Wins Identificados
- Adicionar comentários JSDoc/docstrings onde em falta
- Extrair magic numbers para constantes
- Implementar error handling consistency
- Optimizar imports e dependências

### 📋 PRÓXIMOS PASSOS
1. Configurar Cursor CLI para auditorias futuras mais detalhadas
2. Implementar sugestões de Quick Wins
3. Usar Cursor AI para refatorações automáticas
4. Re-executar auditoria após melhorias

---
**Nota**: Esta análise foi executada sem Cursor CLI. Para auditorias mais avançadas, instale Cursor CLI.
EOF
}

3. 🎯 Bateria de Análises Especializadas

echo "🚀 Iniciando bateria completa de análises Cursor..."

# Preparar contexto do projeto
echo "📋 Coletando contexto do projeto para análise..."

PROJECT_NAME=$(basename "$(pwd)")
PROJECT_TYPE="indefinido"
MAIN_FILES=""
TEST_FILES=""
CONFIG_FILES=""

# Identificar ficheiros principais por tipo
if [ -f "package.json" ]; then
    PROJECT_TYPE="Node.js/JavaScript"
    MAIN_FILES=$(find . -name "*.js" -o -name "*.ts" -o -name "*.jsx" -o -name "*.tsx" | grep -v node_modules | head -10 | tr '\n' ',')
    TEST_FILES=$(find . -name "*.test.*" -o -name "*.spec.*" | head -5 | tr '\n' ',')
    CONFIG_FILES="package.json,tsconfig.json,.eslintrc*,webpack.config.js"
elif [ -f "composer.json" ]; then
    PROJECT_TYPE="PHP"
    MAIN_FILES=$(find . -name "*.php" | grep -v vendor | head -10 | tr '\n' ',')
    TEST_FILES=$(find . -name "*Test.php" | head -5 | tr '\n' ',')
    CONFIG_FILES="composer.json,phpunit.xml,.env.example"
elif [ -f "requirements.txt" ] || [ -f "pyproject.toml" ]; then
    PROJECT_TYPE="Python"
    MAIN_FILES=$(find . -name "*.py" | head -10 | tr '\n' ',')
    TEST_FILES=$(find . -name "test_*.py" -o -name "*_test.py" | head -5 | tr '\n' ',')
    CONFIG_FILES="requirements.txt,pyproject.toml,setup.py"
fi

echo "✅ Projeto identificado: $PROJECT_TYPE"

# Criar pasta de relatórios
REPORTS_DIR="reports/cursor-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$REPORTS_DIR"

echo "📁 Relatórios Cursor serão salvos em: $REPORTS_DIR"

# Análise 1: Produtividade de Desenvolvimento
echo "⚡ [1/6] Análise de Produtividade..."
analyze_with_cursor "PRODUTIVIDADE DE DESENVOLVIMENTO" "$MAIN_FILES" "$REPORTS_DIR/01-produtividade.md"

# Análise 2: Qualidade de Código (Cursor AI Focus)
echo "🎯 [2/6] Análise de Qualidade com IA..."
analyze_with_cursor "QUALIDADE DE CÓDIGO IA-OPTIMIZADA" "$MAIN_FILES" "$REPORTS_DIR/02-qualidade-ia.md"

# Análise 3: Refatorações Automáticas
echo "🔧 [3/6] Análise de Refatorações..."
analyze_with_cursor "OPORTUNIDADES DE REFATORAÇÃO" "$MAIN_FILES" "$REPORTS_DIR/03-refatoracoes.md"

# Análise 4: Configurações de Workspace
echo "⚙️ [4/6] Análise de Configurações..."
analyze_with_cursor "OTIMIZAÇÃO DE WORKSPACE" "$CONFIG_FILES" "$REPORTS_DIR/04-workspace.md"

# Análise 5: Estratégia de Testes (Cursor Assisted)
echo "🧪 [5/6] Análise de Testes..."
analyze_with_cursor "TESTES ASSISTIDOS POR IA" "$TEST_FILES,$MAIN_FILES" "$REPORTS_DIR/05-testes-ia.md"

# Análise 6: Acceleration Opportunities
echo "🚀 [6/6] Análise de Aceleração..."
analyze_with_cursor "OPORTUNIDADES DE ACELERAÇÃO" "$MAIN_FILES,$CONFIG_FILES" "$REPORTS_DIR/06-aceleracao.md"

echo "✅ Todas as análises Cursor concluídas!"

4. 📋 Configurações Recomendadas

echo "⚙️ Gerando configurações recomendadas para Cursor..."

# Criar pasta de configurações
mkdir -p "$REPORTS_DIR/configs"

# Configuração de Workspace recomendada
cat > "$REPORTS_DIR/configs/cursor-workspace.json" << EOF
{
  "name": "$PROJECT_NAME - Optimized for Cursor AI",
  "folders": [
    {
      "path": "."
    }
  ],
  "settings": {
    "cursor.ai.enabled": true,
    "cursor.autocomplete.enabled": true,
    "cursor.chat.enabled": true,
    "cursor.refactor.enabled": true,
    "editor.tabSize": 2,
    "editor.insertSpaces": true,
    "editor.formatOnSave": true,
    "editor.codeActionsOnSave": {
      "source.fixAll": true,
      "source.organizeImports": true
    },
    "files.autoSave": "onFocusChange",
    "workbench.editor.enablePreview": false,
    "breadcrumbs.enabled": true,
    "editor.minimap.enabled": true,
    "editor.wordWrap": "on"
  },
  "extensions": {
    "recommendations": [
      "cursor.cursor-ai",
      "esbenp.prettier-vscode",
      "ms-vscode.vscode-eslint",
      "bradlc.vscode-tailwindcss",
      "ms-python.python",
      "ms-vscode.vscode-typescript-next"
    ]
  }
}
EOF

# Configuração específica por tipo de projeto
case "$PROJECT_TYPE" in
    "Node.js/JavaScript")
        cat > "$REPORTS_DIR/configs/cursor-settings-js.json" << EOF
{
  "javascript.suggest.autoImports": true,
  "typescript.suggest.autoImports": true,
  "javascript.updateImportsOnFileMove.enabled": "always",
  "typescript.updateImportsOnFileMove.enabled": "always",
  "eslint.autoFixOnSave": true,
  "prettier.requireConfig": false,
  "editor.defaultFormatter": "esbenp.prettier-vscode"
}
EOF
        ;;
    "PHP")
        cat > "$REPORTS_DIR/configs/cursor-settings-php.json" << EOF
{
  "php.suggest.basic": false,
  "php.validate.executablePath": "/usr/bin/php",
  "php.executablePath": "/usr/bin/php",
  "files.associations": {
    "*.php": "php"
  }
}
EOF
        ;;
    "Python")
        cat > "$REPORTS_DIR/configs/cursor-settings-python.json" << EOF
{
  "python.linting.enabled": true,
  "python.linting.pylintEnabled": true,
  "python.formatting.provider": "black",
  "python.sortImports.args": ["--profile", "black"],
  "editor.formatOnSave": true
}
EOF
        ;;
esac

echo "✅ Configurações Cursor geradas em: $REPORTS_DIR/configs/"

5. 📊 Relatório Consolidado Cursor

echo "📊 Gerando relatório consolidado Cursor..."

MASTER_REPORT="$REPORTS_DIR/00-RELATORIO-CURSOR-CONSOLIDADO.md"

cat > "$MASTER_REPORT" << EOF
# ⚡ AUDITORIA COMPLETA CURSOR CLI - $PROJECT_NAME

**Data**: $(date +%Y-%m-%d %H:%M:%S)
**Auditor**: Cursor AI + Análise Automática
**Projeto**: $PROJECT_NAME
**Tipo**: $PROJECT_TYPE

## 🎯 RESUMO EXECUTIVO

### ⚡ Foco da Auditoria Cursor
Esta auditoria especializa-se em:
- **Produtividade de desenvolvimento** com IA
- **Oportunidades de refatoração** assistida
- **Otimização de workflow** para Cursor
- **Aceleração de desenvolvimento** com AI

### 🔍 Metodologia Cursor
- **6 análises especializadas** para produtividade
- **Configurações optimizadas** geradas automaticamente
- **Refatorações específicas** para Cursor AI
- **Quick wins** identificados para implementação imediata

## 📁 ESTRUTURA DOS RELATÓRIOS

### 📋 Análises Executadas:
EOF

# Listar relatórios gerados
ls -la "$REPORTS_DIR"/*.md | while read line; do
    filename=$(echo "$line" | awk '{print $9}')
    basename=$(basename "$filename")
    case "$basename" in
        "01-produtividade.md")
            echo "- **🚀 Produtividade**: Análise de eficiência de desenvolvimento - [Ver](./$basename)" >> "$MASTER_REPORT"
            ;;
        "02-qualidade-ia.md")
            echo "- **🎯 Qualidade IA**: Optimizações específicas para Cursor AI - [Ver](./$basename)" >> "$MASTER_REPORT"
            ;;
        "03-refatoracoes.md")
            echo "- **🔧 Refatorações**: Oportunidades de melhoria assistida - [Ver](./$basename)" >> "$MASTER_REPORT"
            ;;
        "04-workspace.md")
            echo "- **⚙️ Workspace**: Configurações optimizadas - [Ver](./$basename)" >> "$MASTER_REPORT"
            ;;
        "05-testes-ia.md")
            echo "- **🧪 Testes IA**: Estratégia de testes assistida - [Ver](./$basename)" >> "$MASTER_REPORT"
            ;;
        "06-aceleracao.md")
            echo "- **🚀 Aceleração**: Oportunidades de speed-up - [Ver](./$basename)" >> "$MASTER_REPORT"
            ;;
    esac
done

cat >> "$MASTER_REPORT" << EOF

### ⚙️ Configurações Geradas:
- **cursor-workspace.json**: Workspace optimizado para $PROJECT_NAME
- **cursor-settings-*.json**: Configurações específicas para $PROJECT_TYPE
- **Extensões recomendadas**: Lista curada para máxima produtividade

## 🎯 QUICK WINS CONSOLIDADOS

### ⚡ Implementação Imediata (< 1 hora)
EOF

# Tentar extrair quick wins dos relatórios
for report in "$REPORTS_DIR"/*.md; do
    if [ -f "$report" ] && [ "$report" != "$MASTER_REPORT" ]; then
        quickwins=$(grep -A 5 "QUICK WINS\|Quick Wins" "$report" 2>/dev/null | grep "^-" | head -2)
        if [ -n "$quickwins" ]; then
            basename_report=$(basename "$report")
            echo "**De $basename_report:**" >> "$MASTER_REPORT"
            echo "$quickwins" >> "$MASTER_REPORT"
            echo "" >> "$MASTER_REPORT"
        fi
    fi
done

cat >> "$MASTER_REPORT" << EOF

## 🚀 IMPLEMENTAÇÃO COM CURSOR AI

### 1. Configurar Workspace
\`\`\`bash
# Copiar configurações geradas
cp $REPORTS_DIR/configs/cursor-workspace.json .vscode/settings.json
\`\`\`

### 2. Instalar Extensões Recomendadas
\`\`\`bash
# Via Cursor CLI (se disponível)
cursor --install-extension esbenp.prettier-vscode
cursor --install-extension ms-vscode.vscode-eslint
\`\`\`

### 3. Usar Cursor AI para Refatorações
- Abrir projeto no Cursor
- Usar Ctrl+Shift+P > "Cursor: Refactor with AI"
- Aplicar sugestões dos relatórios gerados

### 4. Implementar Quick Wins
- Seguir lista de Quick Wins de cada relatório
- Usar Cursor AI para implementação assistida
- Testar melhorias incrementalmente

## 📈 MEDIÇÃO DE SUCESSO

### KPIs de Produtividade
- **Tempo de implementação**: Redução esperada de 30-50%
- **Qualidade de código**: Aumento em métricas automáticas
- **Developer Experience**: Melhor workflow e menos friction

### 🔄 Próxima Auditoria
- **Quando**: Após implementação de 80% das sugestões
- **Foco**: Medição de melhorias e identificação de novas oportunidades
- **Método**: Re-execução desta auditoria Cursor

---
**Método**: Auditoria automática Cursor CLI v1.0 (Descomplicar®)
**Especialidade**: Produtividade e desenvolvimento assistido por IA
**Template**: Multi-LLM Audit System - Cursor Focus
EOF

echo "✅ Relatório consolidado Cursor gerado: $MASTER_REPORT"

6. 💾 Arquivo Local dos Relatórios

echo "💾 Configurando arquivo local dos relatórios Cursor..."

PROJECT_NAME=$(basename "$(pwd)")

# Criar/atualizar índice de auditorias local
AUDIT_INDEX="reports/AUDIT_INDEX.md"
mkdir -p "reports"

# Atualizar índice com entrada Cursor
if [ -f "$AUDIT_INDEX" ]; then
    # Adicionar secção Cursor se não existir
    if ! grep -q "## ⚡ Auditorias Cursor CLI" "$AUDIT_INDEX"; then
        echo "" >> "$AUDIT_INDEX"
        echo "## ⚡ Auditorias Cursor CLI" >> "$AUDIT_INDEX"
        echo "" >> "$AUDIT_INDEX"
    fi
    echo "- **$(date +%Y-%m-%d %H:%M)** - Cursor CLI - [Ver](./$REPORTS_DIR/00-RELATORIO-CURSOR-CONSOLIDADO.md)" >> "$AUDIT_INDEX"
else
    # Criar índice inicial
    cat > "$AUDIT_INDEX" << EOF
# 📋 ÍNDICE DE AUDITORIAS - $PROJECT_NAME

Registo de todas as auditorias executadas neste projeto.

## ⚡ Auditorias Cursor CLI

- **$(date +%Y-%m-%d %H:%M)** - Cursor CLI - [Ver](./$REPORTS_DIR/00-RELATORIO-CURSOR-CONSOLIDADO.md)

EOF
fi

echo "✅ Relatórios Cursor mantidos localmente no projeto"
echo "📁 Localização: $REPORTS_DIR/"
echo "📋 Índice: $AUDIT_INDEX"

7. 📊 Sumário Final

echo ""
echo "⚡ ===== AUDITORIA CURSOR CLI CONCLUÍDA ====="
echo ""
echo "📊 **RESULTADOS CURSOR:**"
echo "- 🎯 **6 análises especializadas** em produtividade"
echo "- ⚙️ **Configurações optimizadas** geradas"
echo "- 🔧 **Refatorações específicas** para Cursor AI"
echo "- 🚀 **Quick wins** identificados"
echo ""
echo "📁 **LOCALIZAÇÃO:**"
echo "- 📋 **Relatórios**: $REPORTS_DIR/"
echo "- ⚙️ **Configurações**: $REPORTS_DIR/configs/"
echo "- 💾 **Índice Local**: reports/AUDIT_INDEX.md"
echo ""
echo "🎯 **PRÓXIMOS PASSOS CURSOR:**"
echo "1. 📖 Ler: $MASTER_REPORT"
echo "2. ⚙️ Aplicar configurações geradas"
echo "3. 🔧 Implementar refatorações com Cursor AI"
echo "4. ⚡ Executar quick wins identificados"
echo "5. 📈 Medir melhoria na produtividade"
echo ""
echo "🔗 **COMANDOS ÚTEIS:**"
echo "- Ver relatório: \`cat $MASTER_REPORT\`"
echo "- Abrir configs: \`nautilus $REPORTS_DIR/configs\`"
echo "- Ver índice: \`cat reports/AUDIT_INDEX.md\`"
echo ""
echo "🎉 **AUDITORIA CURSOR FINALIZADA - PRODUTIVIDADE OPTIMIZADA!**"

---

⚡ CARACTERÍSTICAS CURSOR CLI

🎯 Foco Especializado:

• Produtividade de desenvolvimento com IA
• Refatorações assistidas por Cursor AI
• Optimizações de workflow específicas
• Configurações automáticas para melhor experiência

🔧 Análises Especializadas:

• Produtividade: Eficiência de desenvolvimento atual
• Qualidade IA: Optimizações específicas para Cursor
• Refatorações: Oportunidades de melhoria assistida
• Workspace: Configurações optimizadas
• Testes IA: Estratégia assistida por IA
• Aceleração: Quick wins e speed-ups

⚙️ Configurações Automáticas:

• Workspace JSON optimizado para o projeto
• Settings específicos por linguagem
• Extensões recomendadas curadas
• Shortcuts e workflows optimizados

🚀 Implementação Imediata:

• Quick wins identificados automaticamente
• Refatorações específicas para Cursor AI
• Configurações prontas para aplicar
• Roadmap de melhorias priorizado

---

Diferencial: Enquanto Gemini foca em auditoria técnica abrangente, Cursor foca em produtividade de desenvolvimento e optimização de workflow com IA.