source-driven-development
por addyosmaniA skill source-driven-development ancora a programação específica de frameworks em documentação oficial, ajudando você a validar padrões antes de implementar. É ideal para usar source-driven-development em React, Vue, Next.js, Svelte, Angular e stacks semelhantes quando correção, procedência e decisões sensíveis à versão importam.
Esta skill recebeu 82/100, o que a torna uma boa candidata para usuários de diretórios que querem orientação de implementação baseada em documentação e com fontes citadas. O repositório oferece clareza operacional suficiente para justificar a instalação em programação específica de frameworks, quando a correção importa, embora o usuário deva esperar um fluxo de trabalho centrado em documentação, e não uma skill automatizada ou apoiada por ferramentas.
- Acionamento claro: a descrição diz explicitamente para usá-la em trabalhos com frameworks e bibliotecas em que código com fonte autoritativa e citada faz diferença.
- Orientação operacional forte: o SKILL.md descreve um processo passo a passo DETECT → FETCH → IMPLEMENT → CITE e define quando não usá-la.
- Bom valor para decisão de instalação: o repositório é substancial (7.8k body, vários headings, sem marcadores de espaço reservado) e foca em reduzir erros de implementação desatualizados ou baseados em memória.
- Não há arquivos de suporte nem scripts incluídos, então a execução depende inteiramente das instruções escritas, e não de um fluxo de trabalho empacotado.
- Ela é ampla e centrada em documentação, então usuários que buscam velocidade ou tarefas de lógica geral podem achar que é desnecessária ou exagerada.
Visão geral da skill source-driven-development
O que a source-driven-development faz
A skill source-driven-development ajuda você a escrever código específico do framework só depois de consultar a documentação oficial, citando ou refletindo essas fontes na implementação. Ela é indicada para trabalhos em que “provavelmente correto” não basta: código inicial, padrões recorrentes de aplicação, upgrades e qualquer funcionalidade cuja resposta certa mude conforme a versão do framework.
Quem deve usar
Use a source-driven-development skill se você desenvolve com React, Vue, Next.js, Svelte, Angular ou ferramentas parecidas e quer reduzir o uso de padrões desatualizados. Ela é especialmente útil para agentes que geram código para formulários, roteamento, autenticação, estado, busca de dados e scaffolding de projetos.
Por que ela é diferente de um prompt comum
Um prompt genérico pode produzir código plausível com base nos dados de treinamento. Esta skill direciona o fluxo para um comportamento de verificação primeiro: identificar a stack, consultar a fonte oficial e só então implementar com base nela. Isso a torna mais adequada para trabalho em produção, APIs sensíveis à versão e cenários de code review em que a procedência importa.
Como usar a skill source-driven-development
Instale a skill na configuração do seu agente
Use o fluxo de instalação de skills do repositório e depois carregue source-driven-development no contexto do agente antes de pedir código. Uma source-driven-development install típica se parece com o comando do gerenciador de skills do repo, seguido da leitura do próprio arquivo da skill para que o agente siga o fluxo pretendido.
Transforme sua tarefa em um prompt source-first
Para obter o melhor source-driven-development usage, informe ao modelo o framework, a versão se souber, o runtime e o objetivo exato. Um pedido forte seria: “Use source-driven-development to add a protected dashboard route in Next.js App Router 15, using official docs only, and explain the source for each pattern.” Um pedido fraco seria apenas “build auth.” Quanto mais específica for a stack e a funcionalidade, menos o agente precisa adivinhar.
Leia os arquivos certos primeiro
Comece por SKILL.md e depois examine quaisquer docs, exemplos ou notas do repositório que a skill referencie. Neste repositório, não há pastas auxiliares para sair seguindo, então o principal é acompanhar de perto o processo descrito em SKILL.md e mapeá-lo para as convenções da aplicação de destino.
Workflow da source-driven-development que melhora a qualidade da saída
Use um ciclo de 4 etapas: identificar a stack e a versão, buscar a documentação oficial, implementar a menor versão correta e então verificar se o resultado continua alinhado com a documentação. Se você estiver pedindo geração de código, inclua restrições como a estrutura atual de pastas, o package manager, o modo do framework e se você precisa de citações em comentários ou em uma explicação separada.
FAQ da skill source-driven-development
A source-driven-development serve apenas para frameworks grandes?
Não. O source-driven-development guide é mais valioso quando APIs mudam com frequência ou têm vários padrões concorrentes, algo comum em frameworks e bibliotecas modernas. Ele é menos útil para mudanças de linguagem simples ou lógica que não depende da versão do framework.
Devo usar no lugar de um prompt normal de código?
Use quando correção e rastreabilidade importarem mais do que velocidade. Prompts comuns funcionam bem para edições simples e agnósticas de versão, mas a abordagem source-driven-development for Code Generation é melhor quando você quer um código que possa ser sustentado com base na documentação oficial atual.
É amigável para iniciantes?
Sim, desde que você consiga nomear o framework e descrever a funcionalidade. Iniciantes se beneficiam porque a skill reduz a adivinhação de padrões, mas ainda precisam informar a stack da aplicação e o comportamento desejado. Sem isso, o agente pode validar a documentação errada.
Quando ela não é uma boa escolha?
Não use para edições triviais, lógica pura ou situações em que o usuário quer explicitamente a resposta mais rápida possível sem verificação. Se a tarefa não depende de uma versão específica do framework, a checagem extra de fontes normalmente adiciona esforço sem trazer muito valor.
Como melhorar a skill source-driven-development
Dê ao agente alvos de fonte melhores
O maior ganho de qualidade vem de informar o framework, a versão e a funcionalidade exatos. Por exemplo, diga “official Next.js App Router docs for server actions” em vez de “Next.js stuff.” Alvos mais precisos reduzem buscas na fonte errada e melhoram a precisão do código final.
Deixe as restrições de saída claras desde o início
Se você precisa de citações, explique o formato: comentários inline, uma nota curta de fonte ou um breve resumo da implementação. Também especifique o que não pode mudar, como tipos existentes, nomes de arquivos ou comportamento da UI. Isso ajuda a skill a se manter source-driven sem reescrever demais a sua base de código.
Fique atento aos modos de falha mais comuns
Os principais riscos são usar a versão errada da documentação, misturar padrões de várias releases ou ajustar demais a implementação a um exemplo de tutorial. Se a primeira resposta parecer genérica, peça ao agente para conferir novamente a documentação oficial e restringir a solução à sua stack exata.
Itere a partir da fonte, não de suposições
Se o primeiro resultado estiver próximo do ideal, mas ainda não for o bastante, peça uma segunda rodada que preserve as partes verificadas e ajuste apenas o comportamento que está faltando. Em source-driven-development, o melhor ciclo de melhoria é: esclarecer a stack, confirmar a fonte e então refinar a implementação com uma mudança específica de cada vez.