{"id":14359,"date":"2026-05-26T22:13:37","date_gmt":"2026-05-26T22:13:37","guid":{"rendered":"https:\/\/cheesecakelabs.com\/blog\/spec-driven-development-capturar-intencao\/"},"modified":"2026-08-15T06:59:07","modified_gmt":"2026-08-15T06:59:07","slug":"spec-driven-development-capturar-intencao","status":"publish","type":"post","link":"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/","title":{"rendered":"Spec-Driven Development: como capturar a inten\u00e7\u00e3o antes de queimar tokens"},"content":{"rendered":"\n

Em fevereiro de 2025, Andrej Karpathy publicou um tweet com uma frase que pegou: “Existe um novo tipo de programa\u00e7\u00e3o que eu chamo de vibe coding, em que voc\u00ea se entrega totalmente \u00e0s vibes, abra\u00e7a as exponenciais e esquece que o c\u00f3digo sequer existe.” Ele estava sendo meio s\u00e9rio. O tweet tem 4,5 milh\u00f5es de visualiza\u00e7\u00f5es,<\/strong> e Karpathy depois chamou aquilo de “um devaneio de banho para jogar fora”. A frase n\u00e3o foi jogada fora: virou o termo que resume um modo de falha inteiro.<\/p>\n\n\n\n

A falha \u00e9 mais ou menos assim. Um engenheiro s\u00eanior manda um prompt para o agente: “Construa um fluxo de checkout com Stripe, autentica\u00e7\u00e3o e confirma\u00e7\u00e3o por e-mail.” O agente roda por 35 minutos, altera quarenta e sete arquivos e produz 3.200 linhas de c\u00f3digo.<\/p>\n\n\n\n

O engenheiro abre o diff e descobre que parte funciona, parte n\u00e3o compila, a integra\u00e7\u00e3o com o Stripe usa uma API depreciada<\/strong>, a l\u00f3gica de confirma\u00e7\u00e3o por e-mail aponta para um servi\u00e7o que n\u00e3o existe e o fluxo de autentica\u00e7\u00e3o parece correto, mas ignora o rate limiter silenciosamente. Nada disso \u00e9 pego no code review, porque simplesmente h\u00e1 coisa demais para ler.<\/p>\n\n\n\n

A rea\u00e7\u00e3o da maioria dos times \u00e9 frear o agente: prompts menores, supervis\u00e3o mais pr\u00f3xima, uma volta ao pair programming da segunda era com passos extras. N\u00e3o \u00e9 esse o caminho. O caminho \u00e9 escrever a spec antes de o agente rodar, n\u00e3o na conversa, mas no reposit\u00f3rio, em um arquivo markdown, com detalhe suficiente para que o agente, o pr\u00f3ximo engenheiro, o gate de QA e o revisor trabalhem todos a partir da mesma fonte de verdade. <\/p>\n\n\n\n

Isso \u00e9 Spec-Driven Development<\/strong> (SDD)<\/strong>, a disciplina mais \u00fatil que adotei na Cheesecake Labs e que j\u00e1 vi cortar pela metade o cycle time de features no tipo certo de trabalho.<\/p>\n\n\n\n

There's a new kind of coding I call "vibe coding", where you fully give in to the vibes, embrace exponentials, and forget that the code even exists. It's possible because the LLMs (e.g. Cursor Composer w Sonnet) are getting too good. Also I just talk to Composer with SuperWhisper\u2026<\/p>— Andrej Karpathy (@karpathy) February 2, 2025<\/a><\/blockquote> \n\n\n\n

As seis formas como os agentes falham em escala<\/h2>\n\n\n\n

Antes de falar do que o Spec-Driven Development resolve, quero ser espec\u00edfico sobre os modos de falha que ele tenta endere\u00e7ar. A maioria dos times fala de “agentes pouco confi\u00e1veis” como se fosse um problema s\u00f3. S\u00e3o seis.<\/p>\n\n\n\n

O primeiro \u00e9 o her\u00f3i de uma tacada s\u00f3:<\/strong> o agente tenta construir a feature inteira em uma \u00fanica janela, estoura o or\u00e7amento de contexto, come\u00e7a a perder coer\u00eancia depois de 200K tokens e entrega algo que parece pronto, mas quebra na integra\u00e7\u00e3o. \u00c9 assim que o vibe coding se parece de perto.<\/p>\n\n\n\n

O segundo \u00e9 a vit\u00f3ria prematura. <\/strong>O agente declara a tarefa conclu\u00edda com peda\u00e7os importantes faltando: entregou o happy path, pulou o tratamento de erro e se deu por completo. Voc\u00ea descobre as lacunas no QA ou, pior, em produ\u00e7\u00e3o.<\/p>\n\n\n\n

O terceiro \u00e9 a amn\u00e9sia entre sess\u00f5es. <\/strong>Uma janela nova n\u00e3o tem nenhuma mem\u00f3ria do que veio antes, ent\u00e3o decis\u00f5es tomadas ontem precisam ser redescobertas hoje, restri\u00e7\u00f5es que levaram trinta minutos para serem articuladas somem no prompt seguinte e voc\u00ea paga duas vezes pelo mesmo racioc\u00ednio.<\/p>\n\n\n\n

O quarto \u00e9 o falso pronto.<\/strong> O agente rodou um comando curl, recebeu uma resposta 200 e considera a integra\u00e7\u00e3o funcionando. Ele n\u00e3o testa os caminhos infelizes, n\u00e3o valida o contrato e segue em frente depois de ver um c\u00f3digo HTTP de sucesso. O bug vai para produ\u00e7\u00e3o.<\/p>\n\n\n\n

O quinto \u00e9 a autoavalia\u00e7\u00e3o: <\/strong>o mesmo agente que implementou a feature tamb\u00e9m decide se ela est\u00e1 completa. O executor aprova a si mesmo, estruturalmente o mesmo conflito de interesse de um desenvolvedor revisando o pr\u00f3prio pull request, com o agravante de que o agente n\u00e3o tem reputa\u00e7\u00e3o profissional a proteger.<\/p>\n\n\n\n

O sexto \u00e9 o ac\u00famulo de slop. <\/strong>Cada feature isolada compila, passa nos testes e vai para produ\u00e7\u00e3o, mas a arquitetura se desvia e as conven\u00e7\u00f5es se degradam. Depois de 100 features constru\u00eddas assim, a base de c\u00f3digo \u00e9 tecnicamente funcional e estruturalmente lixo. O agente n\u00e3o violou nenhuma regra explicitamente, ele simplesmente nunca teve uma regra para seguir.<\/p>\n\n\n\n

Nada disso \u00e9 te\u00f3rico. Vemos os seis em clientes, muitas vezes no mesmo projeto, e n\u00e3o \u00e9 o agente sendo ruim no que faz. S\u00e3o modos de falha previs\u00edveis de execu\u00e7\u00e3o sem supervis\u00e3o. O SDD ataca os tr\u00eas primeiros diretamente e cria as condi\u00e7\u00f5es para o sistema lidar com os outros tr\u00eas.<\/p>\n\n\n\n

\n

Leia mais: <\/strong>As tr\u00eas eras do software: do autocomplete ao desenvolvimento ag\u00eantico<\/a><\/p>\n<\/blockquote>\n\n\n\n

O que \u00e9, de fato, Spec-Driven Development<\/h2>\n\n\n\n

Spec-Driven Development (SDD) \u00e9 a pr\u00e1tica de escrever uma especifica\u00e7\u00e3o estruturada no reposit\u00f3rio, em markdown versionado, antes de o agente escrever uma \u00fanica linha de c\u00f3digo. S\u00e3o quatro fases, com nomes que variam de toolkit para toolkit, mas com um formato que se mant\u00e9m.<\/p>\n\n\n\n

Fase um, Specify: <\/strong>voc\u00ea senta com um agente em plan mode<\/a> e escreve a spec. N\u00e3o “construa um fluxo de checkout”, mas uma spec de verdade: qual \u00e9 o problema do usu\u00e1rio, quem est\u00e1 no escopo, quais s\u00e3o os crit\u00e9rios de aceite, o que est\u00e1 explicitamente fora do escopo, quais edge cases importam. A sa\u00edda \u00e9 um arquivo markdown, normalmente spec.md, que o engenheiro e o agente acordam antes de qualquer outra coisa acontecer.<\/p>\n\n\n\n

Fase dois, Design. <\/strong>A partir da spec, o agente prop\u00f5e uma arquitetura, uma sequ\u00eancia de opera\u00e7\u00f5es, o modelo de dados, os componentes, os contratos de API e as decis\u00f5es principais. A sa\u00edda \u00e9 o design.md. O humano revisa, contesta o que est\u00e1 errado e confirma o que est\u00e1 certo.<\/p>\n\n\n\n

Fase tr\u00eas, Tasks.<\/strong> O design \u00e9 decomposto em tarefas at\u00f4micas e ordenadas: cada uma pequena o suficiente para caber em uma \u00fanica janela de contexto com folga, cada uma com crit\u00e9rios de aceite claros, cada uma test\u00e1vel de forma independente. A sa\u00edda \u00e9 o tasks.md.<\/strong><\/em><\/p>\n\n\n\n

Fase quatro, Execute. <\/strong>Subagentes pegam tarefas da lista, implementam e atualizam o estado. Cada um roda em uma janela nova, l\u00ea a spec, o design e a tarefa correspondente, e produz c\u00f3digo apenas para aquela tarefa. O estado do trabalho vive no tasks.md, n\u00e3o na mem\u00f3ria de nenhum agente.<\/p>\n\n\n\n

As mesmas quatro fases aparecem com nomes diferentes nas ferramentas. O AWS Kiro<\/a> usa Requirements, Design, Tasks (e escreve os requisitos em nota\u00e7\u00e3o EARS, “WHEN [condition] THE SYSTEM SHALL [behavior]”). O GitHub Spec Kit<\/a> usa Spec, Plan, Tasks, Implement. O que usamos na Cheesecake Labs segue Specify, Design, Tasks, Execute e ajusta automaticamente a profundidade de cada fase \u00e0 complexidade do trabalho. As diferen\u00e7as s\u00e3o reais, mas n\u00e3o s\u00e3o estrat\u00e9gicas. Escolha uma. Use.<\/p>\n\n\n\n

Por que escrever a spec em um arquivo muda tudo<\/h2>\n\n\n\n

A maioria dos engenheiros com quem converso concorda com a ideia de escrever uma spec e segue fazendo o trabalho no chat. A “spec” vive na conversa. O entendimento que o agente de Intelig\u00eancia Artificial<\/a> tem da feature vive na cabe\u00e7a do agente. Nada \u00e9 dur\u00e1vel.<\/p>\n\n\n\n

A maioria dos engenheiros com quem converso concorda com a ideia de escrever uma spec e segue fazendo o trabalho no chat. A “spec” vive na conversa, o entendimento que o agente tem da feature vive na cabe\u00e7a do agente e nada \u00e9 dur\u00e1vel. O insight do SDD que eu quero que todo engenheiro internalize \u00e9 este: a spec \u00e9 o artefato, n\u00e3o a conversa.<\/p>\n\n\n\n

Tr\u00eas coisas mudam no instante em que a spec vira um arquivo no reposit\u00f3rio.<\/p>\n\n\n\n

A spec sobrevive \u00e0 sess\u00e3o<\/h3>\n\n\n\n

O pr\u00f3ximo agente que pega uma tarefa l\u00ea a spec. O pr\u00f3ximo engenheiro que entra no projeto l\u00ea a spec. O agente de QA que valida a implementa\u00e7\u00e3o l\u00ea a spec. Quem revisa o pull request l\u00ea a spec. Todo mundo recebe a mesma fonte de verdade e voc\u00ea para de pagar tr\u00eas vezes pela mesma conversa.<\/p>\n\n\n\n

A spec \u00e9 revis\u00e1vel<\/h3>\n\n\n\n

Um pull request com cinco arquivos de c\u00f3digo \u00e9 dif\u00edcil de revisar; um pull request que diz “implementa a tarefa 4 de docs\/specs\/checkout.md” \u00e9 f\u00e1cil de revisar contra a inten\u00e7\u00e3o original. Quem revisa l\u00ea o que foi acordado, l\u00ea o diff e pergunta se um bate com o outro. A conversa sobe um n\u00edvel: sai do linha a linha e vai para inten\u00e7\u00e3o versus implementa\u00e7\u00e3o.<\/p>\n\n\n\n

A spec \u00e9 combin\u00e1vel<\/h3>\n\n\n\n

Voc\u00ea pode ter um agente especificando, outro desenhando, um terceiro quebrando em tarefas, um quarto implementando e um quinto julgando, com a entrada e a sa\u00edda de cada agente sendo um arquivo markdown ou c\u00f3digo. O pipeline inteiro \u00e9 s\u00f3 arquivos, e \u00e9 assim que um \u00fanico engenheiro consegue mudar noventa arquivos em uma feature sem nunca passar de 50K tokens em nenhuma janela.<\/p>\n\n\n\n

Sean Grove (OpenAI) fez a vers\u00e3o mais provocativa desse argumento na palestra dele na AI Engineer World’s Fair no ano passado. A tese: “o c\u00f3digo que voc\u00ea escreve representa s\u00f3 10% a 20% do valor que voc\u00ea entrega como programador; os outros 80% a 90% est\u00e3o na comunica\u00e7\u00e3o estruturada.<\/strong>” Para ele, a spec \u00e9 o produto de verdade e o c\u00f3digo \u00e9 a sa\u00edda compilada. O SDD \u00e9 a implementa\u00e7\u00e3o pr\u00e1tica dessa ideia.<\/p>\n\n\n\n

Ou, como o time do GitHub Spec Kit coloca no toolkit open source deles, o modelo mental central \u00e9 “especifica\u00e7\u00f5es n\u00e3o servem ao c\u00f3digo, o c\u00f3digo serve \u00e0s especifica\u00e7\u00f5es”. A hierarquia \u00e9 o oposto do que a maioria dos engenheiros internalizou nos \u00faltimos vinte anos.<\/p>\n\n\n\n

\n

Leia mais: <\/strong>Agent Skills: pare de enfiar workflows no seu arquivo de regras<\/a><\/p>\n<\/blockquote>\n\n\n\n

Os toolkits de SDD<\/h2>\n\n\n\n

N\u00e3o existe um motivo forte para preferir um toolkit de SDD a outro, todos funcionam, e a decis\u00e3o mais importante \u00e9 escolher um e manter a consist\u00eancia.<\/p>\n\n\n\n

O AWS Kiro<\/a> \u00e9 a IDE spec-driven da Amazon. Entrou em preview em 15 de julho de 2025, chegou \u00e0 disponibilidade geral em 17 de novembro de 2025 e o time do lan\u00e7amento reportou mais de 250.000 desenvolvedores nos tr\u00eas primeiros meses. Ele \u00e9 opinativo quanto ao workflow (tr\u00eas arquivos, nota\u00e7\u00e3o EARS para requisitos, design estruturado com diagramas de sequ\u00eancia, tarefas rastre\u00e1veis) e, se voc\u00ea quer o workflow de spec embutido na IDE sem precisar pensar no harness, o Kiro \u00e9 o caminho mais simples.<\/p>\n\n\n\n

O GitHub Spec Kit<\/a> \u00e9 a alternativa open source: licen\u00e7a MIT, compat\u00edvel com mais de 30 agentes de IA<\/a> de programa\u00e7\u00e3o, incluindo Claude Code, Copilot e Gemini CLI. O workflow segue Spec, Plan, Tasks, Implement, e o reposit\u00f3rio traz templates, slash commands e um documento de metodologia chamado spec-driven.md que vale a leitura mesmo que voc\u00ea n\u00e3o adote o toolkit. A vantagem \u00e9 a portabilidade: suas specs n\u00e3o ficam presas dentro de uma IDE espec\u00edfica.<\/p>\n\n\n\n

Onde o SDD sozinho n\u00e3o d\u00e1 conta<\/h2>\n\n\n\n

O SDD ataca diretamente o her\u00f3i de uma tacada s\u00f3, a vit\u00f3ria prematura e a amn\u00e9sia entre sess\u00f5es. A spec impede que o agente tente construir a feature inteira em uma janela. A quebra em tarefas evita a vit\u00f3ria prematura, porque cada tarefa tem crit\u00e9rios de aceite. Os arquivos markdown resolvem a amn\u00e9sia entre sess\u00f5es ao persistir decis\u00f5es fora da mem\u00f3ria de qualquer agente.<\/p>\n\n\n\n

O que o SDD n\u00e3o resolve sozinho \u00e9 o falso pronto, a autoavalia\u00e7\u00e3o e o ac\u00famulo de slop. Esses n\u00e3o s\u00e3o problemas de spec, s\u00e3o problemas de execu\u00e7\u00e3o e de revis\u00e3o.<\/p>\n\n\n\n

O falso pronto se resolve com gates de conclus\u00e3o que o agente n\u00e3o consegue burlar: lint, typecheck e testes em todo commit; cobertura de diff que verifica se o diff de fato atende \u00e0 spec; uma checagem de fidelidade que compara a implementa\u00e7\u00e3o com o design. Nada disso faz parte da spec, faz parte do harness.<\/p>\n\n\n\n

A autoavalia\u00e7\u00e3o se resolve com um agente juiz separado. O executor entrega a implementa\u00e7\u00e3o e um segundo modelo, sem nenhum contexto al\u00e9m da spec e do diff, avalia se a implementa\u00e7\u00e3o atende aos crit\u00e9rios de aceite. O executor n\u00e3o pode dar nota para si mesmo. Chamamos isso de LLM-as-Judge<\/a> (o padr\u00e3o original de Zheng et al., 2023) e, na Cheesecake Labs, rodamos em todo PR n\u00e3o trivial.<\/p>\n\n\n\n

O ac\u00famulo de slop se resolve com conven\u00e7\u00f5es arquiteturais codificadas no harness: arquivos CLAUDE.md<\/strong><\/em> na raiz do projeto capturando conven\u00e7\u00f5es, skills que codificam a forma certa de fazer tarefas comuns e agentes de code review que fazem valer tudo isso. Sem isso, at\u00e9 uma spec perfeita acaba executada de um jeito que desvia a arquitetura.<\/p>\n\n\n\n

Kief Morris, da Thoughtworks<\/a>, tem o enquadramento mais limpo para isso. No texto dele de mar\u00e7o de 2026, “Humans and Agents in Software Engineering Loops”, ele distingue tr\u00eas pap\u00e9is. “In the loop” \u00e9 o engenheiro que revisa cada sa\u00edda do agente linha a linha, o gargalo. “On the loop” \u00e9 o engenheiro que projeta e mant\u00e9m os mecanismos que guiam e validam o comportamento do agente, construindo o harness, incluindo o workflow de spec e os gates.<\/p>\n\n\n\n

“Out of the loop” \u00e9 o caso em que o harness est\u00e1 maduro o suficiente para o agente rodar de forma bastante aut\u00f4noma, com o humano auditando resultados agregados. O SDD \u00e9 o que leva voc\u00ea de “in the loop” para “on the loop”. O harness \u00e9 o que leva voc\u00ea a “out of the loop” com seguran\u00e7a. SDD sem harness deixa voc\u00ea com uma pilha de specs bem escritas que continuam sendo entregues erradas.<\/p>\n\n\n\n

Como eu uso Spec-Driven Development<\/h2>\n\n\n\n

Quatro movimentos para colocar na mesa neste trimestre.<\/p>\n\n\n\n

Primeiro, escolha um toolkit de SDD e padronize nele. Seja o Kiro<\/a>, o Spec Kit<\/a> ou um conjunto de skills internas, o erro \u00e9 deixar cada engenheiro inventar o pr\u00f3prio workflow de spec. Comprometa-se com um formato s\u00f3 e use para tudo que passe de um limite definido: no nosso caso, “qualquer coisa que toque mais de dois arquivos”. A varia\u00e7\u00e3o que voc\u00ea elimina ao padronizar vale mais do que a varia\u00e7\u00e3o que voc\u00ea preserva ao continuar flex\u00edvel.<\/p>\n\n\n\n

Versione as specs no reposit\u00f3rio. Toda spec aprovada fica em docs\/specs\/<feature>\/<\/em><\/strong> com spec.md, design.md e tasks.md. Os pull requests referenciam a spec que implementam, e a spec passa pelo code review como o c\u00f3digo passa. S\u00f3 esse movimento j\u00e1 torna o planejamento do time inteiro leg\u00edvel para ele mesmo e para quem for contratado depois.<\/p>\n\n\n\n

Adicione os gates de conclus\u00e3o em ordem de custo. Lint, typecheck e testes em todo PR s\u00e3o o m\u00ednimo. Depois, cobertura de diff que verifica se a implementa\u00e7\u00e3o tocou os arquivos certos, uma checagem de fidelidade comparando a implementa\u00e7\u00e3o com o design e um agente juiz que avalia contra os crit\u00e9rios de aceite da spec. Os filtros baratos rodam primeiro; o agente juiz roda s\u00f3 nos PRs que passam por eles.<\/p>\n\n\n\n

Por \u00faltimo, separe o executor do juiz. Nenhum agente d\u00e1 nota para o pr\u00f3prio trabalho<\/strong>, ou seja, o agente que implementou a feature n\u00e3o \u00e9 quem declara que ela est\u00e1 pronta. Um modelo separado, de prefer\u00eancia diferente (rodamos Opus 4.7 como juiz sobre implementa\u00e7\u00f5es feitas com Sonnet 4.6), l\u00ea a spec e o diff e produz um aceite ou uma rejei\u00e7\u00e3o expl\u00edcita, com justificativa. O executor recebe a rejei\u00e7\u00e3o e tenta de novo com o feedback. Esse \u00e9 o movimento de maior alavancagem que voc\u00ea pode fazer na qualidade do output.<\/p>\n\n\n\n

A ordem importa:<\/strong> coloque o workflow de spec em p\u00e9 primeiro, porque tanto os gates quanto o juiz dependem de existir uma spec para validar. Sem a spec, os gates n\u00e3o t\u00eam o que checar.<\/p>\n\n\n\n

Para fechar<\/h2>\n\n\n\n

Os agentes dispon\u00edveis em 2026 s\u00e3o bons. O gargalo \u00e9 o sistema ao redor: como a inten\u00e7\u00e3o \u00e9 capturada, como a conclus\u00e3o \u00e9 verificada e como a arquitetura se mant\u00e9m coerente ao longo de centenas de features. As specs s\u00e3o a alavanca mais barata desse sistema.<\/p>\n\n\n\n

Custam minutos para escrever, sobrevivem \u00e0s sess\u00f5es e viabilizam todos os outros gates. Se o seu time ainda n\u00e3o fez a passagem de “spec no chat” para “spec no reposit\u00f3rio”, esse \u00e9 o trabalho dos pr\u00f3ximos trinta dias. Depois vem o harness.<\/p>\n\n\n\n

\"Banner<\/a><\/figure>\n","protected":false},"excerpt":{"rendered":"

Vibe coding gera c\u00f3digo que ningu\u00e9m consegue revisar. O Spec-Driven Development resolve isso escrevendo a spec no reposit\u00f3rio antes de o agente rodar: quatro fases, arquivos markdown versionados e uma \u00fanica fonte de verdade para o agente, o QA e o code review.<\/p>\n","protected":false},"author":92,"featured_media":13812,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_yoast_wpseo_title":"Spec-driven development: capture a inten\u00e7\u00e3o antes do c\u00f3digo","_yoast_wpseo_metadesc":"Spec-driven development captura a inten\u00e7\u00e3o antes de queimar tokens. Veja como os agents falham em escala e por que a spec em arquivo muda tudo.","_yoast_wpseo_meta-robots-noindex":"","_yoast_wpseo_canonical":"","footnotes":"","ckl_wpml_lang":"br","ckl_wpml_source_id":13807,"ckl_wpml_status":"ok: lang=br trid=55117 source=13807 at 2026-08-14 15:43:04"},"categories":[432,471],"tags":[1395,1397,1396],"class_list":["post-14359","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-engineering","category-engenharia","tag-ai-agent","tag-sdd","tag-spec-driven-development"],"acf":[],"yoast_head":"\nSpec-driven development: capture a inten\u00e7\u00e3o antes do c\u00f3digo<\/title>\n<meta name=\"description\" content=\"Spec-driven development captura a inten\u00e7\u00e3o antes de queimar tokens. Veja como os agents falham em escala e por que a spec em arquivo muda tudo.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/\" \/>\n<meta property=\"og:locale\" content=\"pt_BR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Spec-driven development: capture a inten\u00e7\u00e3o antes do c\u00f3digo\" \/>\n<meta property=\"og:description\" content=\"Spec-driven development captura a inten\u00e7\u00e3o antes de queimar tokens. Veja como os agents falham em escala e por que a spec em arquivo muda tudo.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/\" \/>\n<meta property=\"og:site_name\" content=\"Cheesecake Labs\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/cheesecakelabs\" \/>\n<meta property=\"article:published_time\" content=\"2026-05-26T22:13:37+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-08-15T06:59:07+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2026\/05\/what-is-Spec-Driven-Development.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1536\" \/>\n\t<meta property=\"og:image:height\" content=\"689\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Cheesecake Labs\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@cheesecakelabs\" \/>\n<meta name=\"twitter:site\" content=\"@cheesecakelabs\" \/>\n<meta name=\"twitter:label1\" content=\"Escrito por\" \/>\n\t<meta name=\"twitter:data1\" content=\"\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. tempo de leitura\" \/>\n\t<meta name=\"twitter:data2\" content=\"14 minutos\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/\"},\"author\":{\"name\":\"Diana Martins\",\"@id\":\"https:\/\/cheesecakelabs.com\/blog\/br\/#\/schema\/person\/37fa2f0fa5f8d3cbaeb21b973fa5c4b9\"},\"headline\":\"Spec-Driven Development: como capturar a inten\u00e7\u00e3o antes de queimar tokens\",\"datePublished\":\"2026-05-26T22:13:37+00:00\",\"dateModified\":\"2026-08-15T06:59:07+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/\"},\"wordCount\":2802,\"publisher\":{\"@id\":\"https:\/\/cheesecakelabs.com\/blog\/br\/#organization\"},\"image\":{\"@id\":\"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2026\/05\/what-is-Spec-Driven-Development.jpg\",\"keywords\":[\"AI agent\",\"sdd\",\"spec-driven development\"],\"articleSection\":[\"Engineering\",\"Engenharia\"],\"inLanguage\":\"pt-BR\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/\",\"url\":\"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/\",\"name\":\"Spec-driven development: capture a inten\u00e7\u00e3o antes do c\u00f3digo\",\"isPartOf\":{\"@id\":\"https:\/\/cheesecakelabs.com\/blog\/br\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2026\/05\/what-is-Spec-Driven-Development.jpg\",\"datePublished\":\"2026-05-26T22:13:37+00:00\",\"dateModified\":\"2026-08-15T06:59:07+00:00\",\"description\":\"Spec-driven development captura a inten\u00e7\u00e3o antes de queimar tokens. Veja como os agents falham em escala e por que a spec em arquivo muda tudo.\",\"breadcrumb\":{\"@id\":\"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/#breadcrumb\"},\"inLanguage\":\"pt-BR\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"pt-BR\",\"@id\":\"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/#primaryimage\",\"url\":\"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2026\/05\/what-is-Spec-Driven-Development.jpg\",\"contentUrl\":\"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2026\/05\/what-is-Spec-Driven-Development.jpg\",\"width\":1536,\"height\":689,\"caption\":\"what-is-Spec-Driven Development | | Cheesecake Labs\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/cheesecakelabs.com\/blog\/br\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Spec-Driven Development: como capturar a inten\u00e7\u00e3o antes de queimar tokens\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/cheesecakelabs.com\/blog\/br\/#website\",\"url\":\"https:\/\/cheesecakelabs.com\/blog\/br\/\",\"name\":\"Cheesecake Labs\",\"description\":\"Empresa de desenvolvimento e design de aplicativos mobile & web que est\u00e1 reinventando o desenvolvimento de produtos com times remotos. N\u00f3s desenvolvemos aplicativos iOS, Android e aplica\u00e7\u00f5es Web com as melhores empresas dos EUA, do Brasil e do mundo.\",\"publisher\":{\"@id\":\"https:\/\/cheesecakelabs.com\/blog\/br\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/cheesecakelabs.com\/blog\/br\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"pt-BR\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/cheesecakelabs.com\/blog\/br\/#organization\",\"name\":\"Cheesecake Labs\",\"alternateName\":\"Cheesecake Labs Inc\",\"url\":\"https:\/\/cheesecakelabs.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/cheesecakelabs.com\/#logo\",\"url\":\"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2022\/06\/cheesecake-labs-1.png\",\"contentUrl\":\"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2022\/06\/cheesecake-labs-1.png\",\"caption\":\"Cheesecake Labs\",\"inLanguage\":\"br\"},\"image\":{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/cheesecakelabs.com\/#primary-image\",\"url\":\"https:\/\/ckl-website-v4-strapi-prod.s3.us-east-2.amazonaws.com\/ai_software_development_company_83fb512983.webp\",\"contentUrl\":\"https:\/\/ckl-website-v4-strapi-prod.s3.us-east-2.amazonaws.com\/ai_software_development_company_83fb512983.webp\",\"width\":1920,\"height\":1080,\"caption\":\"Cheesecake Labs \u2014 AI, Data & Blockchain software development services\",\"inLanguage\":\"br\"},\"sameAs\":[\"https:\/\/www.facebook.com\/cheesecakelabs\",\"https:\/\/x.com\/cheesecakelabs\",\"https:\/\/www.instagram.com\/cheesecakelabs\/\",\"https:\/\/www.linkedin.com\/company\/cheesecake-labs\/\",\"https:\/\/www.youtube.com\/channel\/UCdGEQ5AHJcmIlaOaI5fGGVA\",\"https:\/\/clutch.co\/profile\/cheesecake-labs\",\"https:\/\/www.behance.net\/cheesecakelabs\",\"https:\/\/dribbble.com\/cheesecakelabs\",\"https:\/\/www.designrush.com\/agency\/profile\/cheesecake-labs\",\"https:\/\/www.g2.com\/products\/cheesecake-labs\/reviews\"],\"description\":\"Cheesecake Labs is a software development studio that designs and builds custom digital products \u2014 web, mobile, and platforms \u2014 combining product design and high-performance engineering.\",\"foundingDate\":\"2013\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/cheesecakelabs.com\/blog\/br\/#\/schema\/person\/37fa2f0fa5f8d3cbaeb21b973fa5c4b9\",\"name\":\"Diana Martins\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"pt-BR\",\"@id\":\"https:\/\/cheesecakelabs.com\/blog\/br\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/d074fb633a22723051c9d98ffc13065a28f0b52bd30a4c0a832ee19820caa4ba?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/d074fb633a22723051c9d98ffc13065a28f0b52bd30a4c0a832ee19820caa4ba?s=96&d=mm&r=g\",\"caption\":\"Diana Martins\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Spec-driven development: capture a inten\u00e7\u00e3o antes do c\u00f3digo","description":"Spec-driven development captura a inten\u00e7\u00e3o antes de queimar tokens. Veja como os agents falham em escala e por que a spec em arquivo muda tudo.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/","og_locale":"pt_BR","og_type":"article","og_title":"Spec-driven development: capture a inten\u00e7\u00e3o antes do c\u00f3digo","og_description":"Spec-driven development captura a inten\u00e7\u00e3o antes de queimar tokens. Veja como os agents falham em escala e por que a spec em arquivo muda tudo.","og_url":"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/","og_site_name":"Cheesecake Labs","article_publisher":"https:\/\/www.facebook.com\/cheesecakelabs","article_published_time":"2026-05-26T22:13:37+00:00","article_modified_time":"2026-08-15T06:59:07+00:00","og_image":[{"width":1536,"height":689,"url":"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2026\/05\/what-is-Spec-Driven-Development.jpg","type":"image\/jpeg"}],"author":"Cheesecake Labs","twitter_card":"summary_large_image","twitter_creator":"@cheesecakelabs","twitter_site":"@cheesecakelabs","twitter_misc":{"Escrito por":null,"Est. tempo de leitura":"14 minutos"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/#article","isPartOf":{"@id":"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/"},"author":{"name":"Diana Martins","@id":"https:\/\/cheesecakelabs.com\/blog\/br\/#\/schema\/person\/37fa2f0fa5f8d3cbaeb21b973fa5c4b9"},"headline":"Spec-Driven Development: como capturar a inten\u00e7\u00e3o antes de queimar tokens","datePublished":"2026-05-26T22:13:37+00:00","dateModified":"2026-08-15T06:59:07+00:00","mainEntityOfPage":{"@id":"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/"},"wordCount":2802,"publisher":{"@id":"https:\/\/cheesecakelabs.com\/blog\/br\/#organization"},"image":{"@id":"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/#primaryimage"},"thumbnailUrl":"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2026\/05\/what-is-Spec-Driven-Development.jpg","keywords":["AI agent","sdd","spec-driven development"],"articleSection":["Engineering","Engenharia"],"inLanguage":"pt-BR"},{"@type":"WebPage","@id":"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/","url":"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/","name":"Spec-driven development: capture a inten\u00e7\u00e3o antes do c\u00f3digo","isPartOf":{"@id":"https:\/\/cheesecakelabs.com\/blog\/br\/#website"},"primaryImageOfPage":{"@id":"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/#primaryimage"},"image":{"@id":"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/#primaryimage"},"thumbnailUrl":"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2026\/05\/what-is-Spec-Driven-Development.jpg","datePublished":"2026-05-26T22:13:37+00:00","dateModified":"2026-08-15T06:59:07+00:00","description":"Spec-driven development captura a inten\u00e7\u00e3o antes de queimar tokens. Veja como os agents falham em escala e por que a spec em arquivo muda tudo.","breadcrumb":{"@id":"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/#breadcrumb"},"inLanguage":"pt-BR","potentialAction":[{"@type":"ReadAction","target":["https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/"]}]},{"@type":"ImageObject","inLanguage":"pt-BR","@id":"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/#primaryimage","url":"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2026\/05\/what-is-Spec-Driven-Development.jpg","contentUrl":"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2026\/05\/what-is-Spec-Driven-Development.jpg","width":1536,"height":689,"caption":"what-is-Spec-Driven Development | | Cheesecake Labs"},{"@type":"BreadcrumbList","@id":"https:\/\/cheesecakelabs.com\/blog\/br\/spec-driven-development-capturar-intencao\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/cheesecakelabs.com\/blog\/br\/blog\/"},{"@type":"ListItem","position":2,"name":"Spec-Driven Development: como capturar a inten\u00e7\u00e3o antes de queimar tokens"}]},{"@type":"WebSite","@id":"https:\/\/cheesecakelabs.com\/blog\/br\/#website","url":"https:\/\/cheesecakelabs.com\/blog\/br\/","name":"Cheesecake Labs","description":"Empresa de desenvolvimento e design de aplicativos mobile & web que est\u00e1 reinventando o desenvolvimento de produtos com times remotos. N\u00f3s desenvolvemos aplicativos iOS, Android e aplica\u00e7\u00f5es Web com as melhores empresas dos EUA, do Brasil e do mundo.","publisher":{"@id":"https:\/\/cheesecakelabs.com\/blog\/br\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/cheesecakelabs.com\/blog\/br\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"pt-BR"},{"@type":"Organization","@id":"https:\/\/cheesecakelabs.com\/blog\/br\/#organization","name":"Cheesecake Labs","alternateName":"Cheesecake Labs Inc","url":"https:\/\/cheesecakelabs.com\/","logo":{"@type":"ImageObject","@id":"https:\/\/cheesecakelabs.com\/#logo","url":"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2022\/06\/cheesecake-labs-1.png","contentUrl":"https:\/\/ckl-website-static.s3.amazonaws.com\/wp-content\/uploads\/2022\/06\/cheesecake-labs-1.png","caption":"Cheesecake Labs","inLanguage":"br"},"image":{"@type":"ImageObject","@id":"https:\/\/cheesecakelabs.com\/#primary-image","url":"https:\/\/ckl-website-v4-strapi-prod.s3.us-east-2.amazonaws.com\/ai_software_development_company_83fb512983.webp","contentUrl":"https:\/\/ckl-website-v4-strapi-prod.s3.us-east-2.amazonaws.com\/ai_software_development_company_83fb512983.webp","width":1920,"height":1080,"caption":"Cheesecake Labs \u2014 AI, Data & Blockchain software development services","inLanguage":"br"},"sameAs":["https:\/\/www.facebook.com\/cheesecakelabs","https:\/\/x.com\/cheesecakelabs","https:\/\/www.instagram.com\/cheesecakelabs\/","https:\/\/www.linkedin.com\/company\/cheesecake-labs\/","https:\/\/www.youtube.com\/channel\/UCdGEQ5AHJcmIlaOaI5fGGVA","https:\/\/clutch.co\/profile\/cheesecake-labs","https:\/\/www.behance.net\/cheesecakelabs","https:\/\/dribbble.com\/cheesecakelabs","https:\/\/www.designrush.com\/agency\/profile\/cheesecake-labs","https:\/\/www.g2.com\/products\/cheesecake-labs\/reviews"],"description":"Cheesecake Labs is a software development studio that designs and builds custom digital products \u2014 web, mobile, and platforms \u2014 combining product design and high-performance engineering.","foundingDate":"2013"},{"@type":"Person","@id":"https:\/\/cheesecakelabs.com\/blog\/br\/#\/schema\/person\/37fa2f0fa5f8d3cbaeb21b973fa5c4b9","name":"Diana Martins","image":{"@type":"ImageObject","inLanguage":"pt-BR","@id":"https:\/\/cheesecakelabs.com\/blog\/br\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/d074fb633a22723051c9d98ffc13065a28f0b52bd30a4c0a832ee19820caa4ba?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/d074fb633a22723051c9d98ffc13065a28f0b52bd30a4c0a832ee19820caa4ba?s=96&d=mm&r=g","caption":"Diana Martins"}}]}},"_links":{"self":[{"href":"https:\/\/cheesecakelabs.com\/blog\/br\/wp-json\/wp\/v2\/posts\/14359","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cheesecakelabs.com\/blog\/br\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/cheesecakelabs.com\/blog\/br\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/cheesecakelabs.com\/blog\/br\/wp-json\/wp\/v2\/users\/92"}],"replies":[{"embeddable":true,"href":"https:\/\/cheesecakelabs.com\/blog\/br\/wp-json\/wp\/v2\/comments?post=14359"}],"version-history":[{"count":3,"href":"https:\/\/cheesecakelabs.com\/blog\/br\/wp-json\/wp\/v2\/posts\/14359\/revisions"}],"predecessor-version":[{"id":15027,"href":"https:\/\/cheesecakelabs.com\/blog\/br\/wp-json\/wp\/v2\/posts\/14359\/revisions\/15027"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/cheesecakelabs.com\/blog\/br\/wp-json\/wp\/v2\/media\/13812"}],"wp:attachment":[{"href":"https:\/\/cheesecakelabs.com\/blog\/br\/wp-json\/wp\/v2\/media?parent=14359"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/cheesecakelabs.com\/blog\/br\/wp-json\/wp\/v2\/categories?post=14359"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/cheesecakelabs.com\/blog\/br\/wp-json\/wp\/v2\/tags?post=14359"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}