Desenvolvimento Orientado por Fontes

Visão Geral

Toda decisão de código específica de um framework deve ser apoiada pela documentação oficial. Não implemente de memória — verifique, cite e deixe o usuário ver suas fontes. Dados de treinamento ficam desatualizados, APIs são depreciadas, melhores práticas evoluem. Essa habilidade garante que o usuário receba código confiável, pois cada padrão remonta a uma fonte autoritativa que ele pode verificar.

Quando Usar

• O usuário quer código que siga as melhores práticas atuais para um determinado framework
• Construindo código boilerplate, código inicial ou padrões que serão copiados em um projeto
• O usuário pede explicitamente por implementação documentada, verificada ou "correta"
• Implementando funcionalidades onde a abordagem recomendada pelo framework importa (formulários, roteamento, busca de dados, gerenciamento de estado, autenticação)
• Revisando ou aprimorando código que usa padrões específicos de framework
• Qualquer momento em que você esteja prestes a escrever código específico de framework de memória

Quando NÃO usar:

• A correção não depende de uma versão específica (renomear variáveis, corrigir erros de digitação, mover arquivos)
• Lógica pura que funciona da mesma forma em todas as versões (loops, condicionais, estruturas de dados)
• O usuário quer explicitamente velocidade em vez de verificação ("faça logo")

O Processo

DETECT ──→ FETCH ──→ IMPLEMENT ──→ CITE
  │          │           │            │
  ▼          ▼           ▼            ▼
 What       Get the    Follow the   Show your
 stack?     relevant   documented   sources
            docs       patterns

Passo 1: Detectar Stack e Versões

Leia o arquivo de dependências do projeto para identificar as versões exatas:

package.json    → Node/React/Vue/Angular/Svelte
composer.json   → PHP/Symfony/Laravel
requirements.txt / pyproject.toml → Python/Django/Flask
go.mod          → Go
Cargo.toml      → Rust
Gemfile         → Ruby/Rails

Declare o que você encontrou explicitamente:

STACK DETECTED:
- React 19.1.0 (from package.json)
- Vite 6.2.0
- Tailwind CSS 4.0.3
→ Fetching official docs for the relevant patterns.

Se as versões estiverem faltando ou forem ambíguas, pergunte ao usuário. Não adivinhe — a versão determina quais padrões estão corretos.

Passo 2: Buscar Documentação Oficial

Busque a página de documentação específica para a funcionalidade que você está implementando. Não a página inicial, não a documentação completa — a página relevante.

Hierarquia de fontes (em ordem de autoridade):

Não são autoritativas — nunca cite como fontes primárias:

• Respostas do Stack Overflow
• Posts de blog ou tutoriais (mesmo os populares)
• Documentação ou resumos gerados por IA
• Seus próprios dados de treinamento (esse é o ponto principal — verifique-os)

Seja preciso com o que você busca:

BAD:  Fetch the React homepage
GOOD: Fetch react.dev/reference/react/useActionState

BAD:  Search "django authentication best practices"
GOOD: Fetch docs.djangoproject.com/en/6.0/topics/auth/

Após buscar, extraia os padrões chave e anote quaisquer avisos de depreciação ou orientações de migração.

Quando fontes oficiais entram em conflito entre si (por exemplo, um guia de migração contradiz a referência da API), apresente a discrepância ao usuário e verifique qual padrão realmente funciona com a versão detectada.

Passo 3: Implementar Seguindo Padrões Documentados

Escreva código que corresponda ao que a documentação mostra:

• Use as assinaturas de API das docs, não da memória
• Se as docs mostrarem uma nova maneira de fazer algo, use a nova maneira
• Se as docs depreciaram um padrão, não use a versão depreciada
• Se as docs não cobrirem algo, marque como não verificado

Quando as docs entram em conflito com o código existente do projeto:

CONFLICT DETECTED:
The existing codebase uses useState for form loading state,
but React 19 docs recommend useActionState for this pattern.
(Source: react.dev/reference/react/useActionState)

Options:
A) Use the modern pattern (useActionState) — consistent with current docs
B) Match existing code (useState) — consistent with codebase
→ Which approach do you prefer?

Apresente o conflito. Não escolha um silenciosamente.

Passo 4: Cite Suas Fontes

Todo padrão específico de framework recebe uma citação. O usuário deve ser capaz de verificar cada decisão.

Em comentários de código:

…