codebase

codebase

Resumo

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

Skills Relacionadas

Skill	Quando usar junto
spec	Para criar specs a partir das melhorias identificadas
ui-ux	Para combinar melhorias técnicas e visuais
architecture	Para identificar melhorias arquiteturais
qa	Para avaliar debt técnico

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)
• Revisão de PR (use 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

Nível	Tempo	Descrição
trivial	1-2h	Cópia direta com mudanças menores
small	0.5 dia	Padrão claro, alguma lógica nova
medium	1-3 dias	Padrão existe mas precisa adaptação
large	3-7 dias	Padrão arquitetural habilita nova capacidade
complex	1-2 semanas	Fundação suporta adição major

---

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