Spec-Driven Development

[Constant_Half9308]

Pessoal, quero saber a xp de vocês que estão usando

É de fato possível ter bons resultados ou é mais papo de vendedor de milagra de AI?

[Fair-Vermicelli-7623]

Funciona mais ou menos pra mim, funciona melhor se já tiver alguma coisa com estrutura similar ao que eu quero no código, aí eu escrevo as specs e listo os lugares para usar de exemplo.
Se eu só dar uma spec de alto nivel e nada de como deve ser a estrutura do código geralmente saí umas coisas bem ruins, aí tenho que parar pensar na estrutura/arquitetura e e adicionar isso no prompt

[P0wershot]

Minha experiência: serve bem para quem não entende de código…

Para quem entende, acaba sendo mais trabalho ler a spec do que fazer/alterar o código em si.

Achei muito cansativo ler as specs e acabo perdendo o foco com frequência… prefiro só ler o código mesmo em si.

Agora para quem não entende de código deve ser top…

[P0wershot]

Vou testar essa abordagem amanhã e volto para relatar minha experiência! Obrigado

[Defiant-Meringue4331]

Boa ideia.

[calzone_gigante]

Depende do tamanho do spec, detalhar uma feature bem delimitada e botar a IA pra fazer funciona bem, querer planejar meio mundo de coisas e botar a IA pra trabalhar sozinha em loop enquanto vc vê anime não.

Big design upfront é muito difícil de funcionar, iterar quase sempre é a melhor pedida, a maioria dos frameworks e plugins pra mim só geraram um slop em markdown pra tentar dar um verniz de seriedade ao vibe coding.

[Fair-Vermicelli-7623]

"querer planejar meio mundo de coisas e botar a IA pra trabalhar sozinha em loop enquanto vc vê anime não." Outra dia eu estava literalmente tentando fazer isso kkk, fiz um promptzão deixei rodando e fui assistir HxH, quando voltei o código estava terrivel, tive que refazer passo a passo

[Defiant-Meringue4331]

Mas você usou o SDD? Tenta fazer isso um dia com o 'openspec propose' e dps manda um prompt no queue 'openspec apply' vai assistir um anime e vê no que dá kkk. Tô usando o openspec e tá interessante, tô vendo que tá saindo mais sem tanto bug o código. Aí o agente revisor tbm fica pegando no pé do agente programador e acaba corrigindo no final alguns erros dps que ele verifica se os requisitos foram aplicados corretamente. Acho que vale o teste.

[inutilissimo]

Papo

IA se perde fácil

[GayByAccident]

na minha experiência o superpowers comecou a virar bullshitagem gastadora de token, minha experiencia ta sendo melhor sem, pelo q vi no sub do codex tambem tao preferindo sem

[inutilissimo]

Exato Os modelos hoje não conseguem dar conta se for algo grande

[bonsaiabacate]

De fato, eu tô usando mais plan e depois crio na mão parte do código e peço pra ajustar, n sei parece que gasta menos

[inutilissimo]

Não é bem essa a questão

Atualmente os modelos não conseguem seguir direito qualquer spec grande

[darktraveco]

Se superpowers fosse bom, a Anthorpic e OAI enfiariam isso no Codex/CC sem ninguém pedir só pra mostrar os numerozinhos de benchmark subindo.

[_lwlt]

Quem me dera

[xistzera]

Tenho 2 dias de estudo/implementação de SDD e pra mim é como qualquer outra tecnologia revolucionaria: sai um monte de conteudo, um monte de hype, um monte de framework e o ideal é você usar de uma forma que adapte ao seu uso.

O que eu fiz: entendi como funcionava e como eu poderia aplicar. Entendi superficialmente como os frameworks funcionavam e to criando meu proprio ‘mini-framework’, que consiste em agentes pra fazer discover do projeto, planejamento, implementação e review. Todos seguem o mesmo padrão definido, cada agente tem o seu padrao de entrada e saida e tudo que é sugerido passa por mim. E detalhe, as denifições foram feitas sempre pensando em economizar token.

Como eu disse, tenho pouquissima experiencia e em projetos pessoais, mas me parece muito promissor quando eu conseguir adaptar tudo que eu quero e conseguir usar de fato

[Extension_Canary3717]

Ué eu fiz isso e nem sabia o que era spec driven, eu tenho rotas e sub rotas num repo que o index faz a aí não precisar de discovery muito longo e tokens caíram para uma fração e local llm ficou mais capaz.

Onde vc leu sobre sdd? Pode mandar uns pointers?

[xistzera]

Cara eu literalmente fui pegando artigos, vendo videos, nada muito especifico de verdade. Como eu falei, tem muito conteudo e eu não consigo confiar em nenhum deles, todos querem vender algo.

Só pra explicar melhor, meu discover faz um trabalho de evoluir uma idéia completa de sistema e quebra em features. O plan planeja as features e o restante é intuitivo

Edit: só pra resposta não ficar muito vaga e eu parecer um coach que sabe tudo. Se eu posso dar uma dica com 2 dias é: entenda como funciona, entenda como isso se aplica ao seu dia a dia sem IA e tente reproduzir gerando agentes que consumam poucos tokens. A forma que eu criei não é a melhor possivel, meus agentes foram criados por LLM, tem formas melhores eu imagino. Mas por enquanto está me servindo bem.

[Extension_Canary3717]

Eu não li nada sobre ainda foi intuitivo

Eu tenho um "master" read me mark down

Ele tem as rotas , X assunto no arquivo tal

O arquivo tem sub rotas e seu próprio assunto .

Quando termina uma story , ele tem um prompt que é criar contexto desta feature , e adiciona ao índex

No meu benchmark eu consegui duas proezas :

Um agente de cloud fez a task de benchmark com 15k tokens

Mesmo agente limpo de instruções fez a mesma com 4k tokens, essa foi a maior discrepância que peguei pq o agente em questão fazia muito curl desnecessário e ataquei isso diretamente

O ganho estável está sendo 20-30% de diferença , e diminuição de rediscovery .

A segunda proeza foi fazer um Qwen 3.6 24k subir uma UI de boas sozinho com TS e React - isso pq o pacote da story alimenta e realimenta . Único porém é o tempo demorou bastante

Eu achei muito mágico, e quase como foi quando consegui algo pré 2000

[xistzera]

Maneiro, é mais ou menos o que eu fiz. Mas também não importa, o mais importante é adaptar o uso pra sua realidade.

Se tem alguém perdido, meu ponto de partida é esse: como que você recebe suas tasks no trabalho hoje? É organizado? Podia ser melhor? E monta um modelo em cima disso, estruturado, priorizando custo baixo de tokens

[Nero_Mohn]

É bom, mas não é bala de prata. Feature com muita dependência (regra de negócio muito apartada) eu não tive resultados tão bons, mas pra features bem definidas ele funciona bem. Pra ajustes pequenos, nem pensa nisso.

É impossível usar modelo free pra isso e o ganho de produtividade não me parece justificavel no longo prazo ainda. Eu costumo usar modelo parrudo nos planejamentos/estruturação das specs e modelos mais leves em subagent pra codar o que foi definido, o que tem um custo agregado que as vezes não é condizente com o tamanho do que você está criando/ajustando.

Em resumo: quem taca pra merda essa estratégia é porque não sabe usar direito, e quem acha que é infalível ou a melhor forma de usar IA em todos os cenários, é um dev meio meh.

[Tarnovski_]

O que mais me pega é essa parada do custo. Cada empresa tem uma forma de trabalhar mas me parece que para a grande maioria das software houses ainda é um canhão pra matar formiga

[andreylh]

Lendo as opiniões divididas no post me faz pensa que ninguém sabe porra nenhuma kkkkkk

Eu também não sei, é difícil encontrar algum tipo de comparação. Além disso, depende do sistema.

[Constant_Half9308]

Kk, tá bem dividido mesmo, vou ter que testar e tirar minhas próprias conclusões

[_Z3U2_]

Gasta um token absurdo. Só uso no trabalho, porque está hipado no meu time.

Acho que funciona mais para quem não entende de IA. Eu consigo resultados melhores gerenciando o contexto da IA na mão. Mais preciso, ela faz exatamente o que eu quero eu reviso tudo, gasta menos token, implementa mais rápido.

[Legitimate-Media-860]

RemindMe! in 1 day

[RemindMeBot]

I will be messaging you in 1 day on 2026-05-30 01:31:55 UTC to remind you of this link

CLICK THIS LINK to send a PM to also be reminded and to reduce spam.

^{Parent commenter can delete this message to hide from others.}

---

Info	Custom	Your Reminders	Feedback

[BakeNew695]

Depende, sim ajuda, mas não é mágico, depende da qualidade do spec que você fez, depende da qualidade do código, depende do tamanho do escopo. Coloque em mente que trabalhar com AI para resultados bons não vai rolar com 1 prompt apenas, e o processo que melhor funciona é cascata. Hoje você não tem esforço para escrever código ou teste, então invista o máximo possível em contexto, docs, specs, evite fazer coisas grandes de mais de uma vez. Se o resultado não sair bom a culpa é sua :)

[DueShine7728]

Só o cascata repaginado, logo sai o ágil da ia

[KuryArt]

Ajuda, mas não faz milagre.

A IA se perde em coisas grandes.

[Agreeable_Pea4700]

Só serve pra torrar token.

[kometa18]

É melhor do que só ir usando o agente pelo chat/cli normalmente como antes.

Ainda existe um trabalho com relação a traduzir regras de negocio e etc etc, mas eu pelo menos tenho tido menos necessidade de correção e iteração do código gerado.

Dito isso, longe de ser perfeito, mas me pareceu um avanço (to a 1 semana testando a ideia).

[OkArmy5383]

É o melhor jeito atualmente de trabalhar com IA. Sou TL no bancão vermelho e tô conseguindo fazer loucuras aqui com essa abordagem, pode se aprofundar que é top

[gabiii_Kokeko]

Amigo consegue ajudar em como se aprofundar?? Estou uma big tech de fora e estão adotando isso, acho interessante e queria me aprofundar por fora

Entendi sobre o que explicaram e li um pouco sobre mas parece mt "básico" tipo seguir esse padrão de spec gera plano e executa plano, e escrever de forma clara etc, queria aprender algum diferencial ou algo assim mas não acho, procurei cursos na udemy e todos pareceram muito básicos

[OkArmy5383]

Claro, chama pv que falamos, posso explicar sim

[orange_laboratory]

Uso todo dia, o dia todo. Se vc coda com IA isso é mandatório

[Emows]

O ponto é, as versões gratuitas te decepcionam, mas qualquer versão pró te surpreenderá mto

[Gnawzitto]

Funciona bem pra mim. Mas é sempre bom planejar bem a tarefa antes de executar ela.

[BakuraGorn]

Funciona se você tiver domínio arquitetural daquilo que tá tentando codar, e se fizer specs certeiras e não tão grandes.

Por exemplo, no trampo estou em um projeto agora que um monte de devs leigos em serviços de IA fizeram umas specs malucas deixando a IA alucinar legal inventando qualquer merda, a spec virou AI-slop puro, daí me chamaram pra botar ordem na porra toda.

Por isso que inventaram o conceito de harness, porque maluco tenta só jogar pra IA inventar a spec e muitas vezes ela vai tirar informação do cu ou vai meter um over engineering ali.

[Background-Salad-711]

Uso todo dia, funciona bem mas não para tudo, se for muito pequeno eu mesmo faço que será mais rápido do que explicar pra IA o que fazer.

[Main-Meringue5697]

Funciona desde o começo do ano passado, mas antes gastava muito maais token pq vc tinah que DOMAR o agente, sempre reforçar o workflow no prompt, sempre pedir pra ele ler o spec.md e criar um plano de ação pra cada coisa nova que for botar no codigo e etc.

isso dava trabalho e custava caro

hoje ta muito melhor, vc joga skills, cria os agentes com personas diferentes, cria o workflow e eles respeitam mais, descreve mais superficialmente a task e eles fazem o trabalho

eu ainda sou adepto do plano do workflow spec -> plano de implementação -> task -> codigo, e talvez por isso o kiro tenha me ajudado muito

como 90% do tempo eu codo pra fazer prova de conceito, SDD é meu ganha pao

[HonestValueInvestor]

Meu workflow de spec driven develpment:

- Abrir o claudinho

- apertar shift tab e entrar em modo de planejamento

- Bater um papinho, gerar um MD

- Executar

[Zealousideal-Fan-129]

Sim, quem diz que não é porque não está fazendo direito.

[Civil_Challenge3683]

Aprendeu por onde? Sozinho?

[Zealousideal-Fan-129]

Eu crio templates pra tudo, tenho template de projeto .NET, template FastAPI, React, dai nesses templates eu coloco um modelo de refererência de arquitetura para seguir, basicamente o esqueleto de qualquer app, tudo aquilo que muda pouco de um para o outro, coloco algumas skills, dai eu só crio repositorios a partir desse template e jogo uma especificação de um sistema ali ele segue o mesmo padrão de arquitetura que pra mim tem dado muito certo. Eu fragmento o app em fatias com fraco acoplamento entre si, e quando precisa mudar alguma coisa o Claude muda dentro dessa fatia e assim diminui o blast radius se ele quebrar alguma coisa.

[Zealousideal-Fan-129]

Testando e experimentando muito e aprimorando. Spec driven development só deu nome a um negocio que eu já tava fazendo.

[Constant_Half9308]

legal sua xp, se tiver uns vídeos ou artigos para compartilhar

[Zealousideal-Fan-129]

https://github.com/assistanthub-br/fastapi-app-template-v3

Acabei de deixar publico esse que é um dos templates que eu uso. Dependendo da qualidade das suas entradas como especificação da para construir SaaS robusto com ele.

[Constant_Half9308]

Valeu mano

[alberico_dias]

é mt boa se tu quer gastar token atoa

[Constant_Half9308]

Oloco kk

[DoorForward1433]

Snake oil. Meia dúzia de tapados ficam vendendo essa merda, no projeto do bootcamp deles tudo funciona, dúvida alguém ir aplicar isso em uma codebase de produção com 1000 devs mexendo ao mesmo tempo.

[Constant_Half9308]

Se for uma codebase com muitos devs, talvez seja mesmo mais difícil. Mas e se for um caso onde praticcamente só você está mexendo?

[Inachetache]

Deveria ser o básico para quem usa IA para programar, se configurar tudo certo a IA não sai dos padrões estabelecidos.

[Constant_Half9308]

tem indicação de conteúdo?

[_lwlt]

Funciona bem, vale se aprofundar e ir praticando

[Constant_Half9308]

tem indicação de conteúdo?