codebase

Resumo

Identifica oportunidades de melhoria no codebase baseada em padrões existentes.

Skills Relacionadas

Quando usar

Use esta skill quando precisar:

• Descobrir oportunidades de melhoria no código
• Identificar padrões que podem ser estendidos
• Encontrar quick wins e melhorias de maior impacto
• Priorizar melhorias por esforço/impacto

Não use para:

• Planejamento estratégico de produto (use roadmap-strategy)
• Revisão de PR (use github-pr-review)

Princípio Chave

Encontre oportunidades que o código revela.

Estas são features e melhorias que emergem naturalmente de entender:

• Que padrões existem
• Como podem ser estendidos
• Onde podem ser aplicados em outros lugares

Níveis de Esforço

Categorias de Oportunidade

A. Extensões de Padrão (trivial → medium)

• CRUD para entidade similar
• Filtros para mais campos
• Export para outros formatos

B. Oportunidades de Arquitetura (medium → complex)

• Data model suporta feature X
• API structure habilita novo tipo de endpoint
• Component architecture suporta nova view

C. Configuração/Settings (trivial → small)

• Valores hardcoded → configuráveis
• Missing preferences seguindo padrão existente

D. Adições de Utilitários (trivial → medium)

• Validadores para mais casos
• Formatters para mais formatos
• Helpers relacionados

E. Melhorias de UI (trivial → medium)

• Loading states seguindo padrão
• Empty states seguindo padrão
• Error states seguindo padrão

F. Extensões de Infraestrutura (medium → complex)

• Plugin points não utilizados
• Event system com novos tipos

Output Format

{
  "code_improvements": [
    {
      "id": "ci-001",
      "title": "Add search to user list",
      "description": "Add search functionality to user list page",
      "rationale": "Search pattern exists in product list",
      "builds_upon": ["ProductList search component"],
      "estimated_effort": "trivial",
      "affected_files": ["src/pages/Users.tsx"],
      "existing_patterns": ["SearchBar component"],
      "implementation_approach": "Reuse SearchBar from ProductList"
    }
  ]
}

Analysis Phases

1. Load Context - Ler project_index.json, ideation_context.json
2. Discover Patterns - Buscar padrões repetidos
3. Identify Opportunities - Categorizar por tipo
4. Analyze Specific - Deep dive em cada oportunidade
5. Filter & Prioritize - Remover duplicados, priorizar
6. Generate Output - Criar code_improvements_ideas.json

Referências

• references/improvement-categories.md - Categorias detalhadas
• references/insight-extractor.md - Extração de insights