{"slug": "spec-driven-development-quando-a-especificacao-vira-a-fonte-da-verdade-nao-o", "title": "Spec-Driven Development: quando a especificação vira a fonte da verdade (não o código)", "summary": "A developer proposes Spec-Driven Development (SDD), where a versioned markdown specification becomes the source of truth instead of code, to solve the scaling problems of vibe coding with AI agents. The approach ensures the AI understands intent before generating code, with tools like Spec Kit, Kiro, Tessl, and OpenSpec compared in a detailed guide.", "body_md": "Venho usando agentes de código (Claude Code, Cursor) e bati numa parede que todo mundo conhece: o **vibe coding** — descrever a tarefa e deixar a IA cuspir código — escala mal. Funciona até a terceira mudança, quando ninguém mais lembra qual era a intenção original. O código virou a única fonte de verdade, e ele é péssimo pra contar *por que* algo foi feito.\n\nFoi aí que caí no **Spec-Driven Development (SDD)**: colocar a especificação *antes* do código. Na prática, a \"spec\" é um markdown versionado no repo — requisitos + critérios de aceite — que a IA lê antes de gerar qualquer linha. Ela vira o artefato principal, não um doc que apodrece numa pasta.\n\nA tese que tirei: o gargalo de programar com IA deixou de ser \"a IA escreve código bom?\". Hoje é \"a IA entende o que eu realmente quero?\". A spec é o que fecha essa lacuna.\n\nTrês coisas que me fizeram levar a sério:\n\n`/speckit.specify`\n\n, `/speckit.plan`\n\n...). Mais perto de TDD do que de cascata.`CLAUDE.md`\n\n(ou `AGENTS.md`\n\n) na raiz do repo já é uma forma enxuta de aplicar a ideia.Não é bala de prata. Pra script de 50 linhas, é overhead. O ganho aparece em código que vai ser mantido, em time, ou quando você delega pesado pra agentes autônomos.\n\nEscrevi um guia mais fundo com as 4 fases em detalhe, a comparação **Spec Kit vs Kiro vs Tessl vs OpenSpec** (qual escolher) e o passo a passo rodando SDD com Claude Code na prática: [techknow.com.br/post/spec-driven-development](https://www.techknow.com.br/post/spec-driven-development)\n\nQuem aqui já tá usando spec como fonte da verdade no fluxo com IA? Curioso pra saber qual ferramenta pegou — e onde travou.", "url": "https://wpnews.pro/news/spec-driven-development-quando-a-especificacao-vira-a-fonte-da-verdade-nao-o", "canonical_source": "https://dev.to/wildrik/spec-driven-development-quando-a-especificacao-vira-a-fonte-da-verdade-nao-o-codigo-f7d", "published_at": "2026-07-21 01:19:33+00:00", "updated_at": "2026-07-21 01:29:39.173646+00:00", "lang": "en", "topics": ["developer-tools", "artificial-intelligence", "ai-agents"], "entities": ["Claude Code", "Cursor", "Spec Kit", "Kiro", "Tessl", "OpenSpec"], "alternates": {"html": "https://wpnews.pro/news/spec-driven-development-quando-a-especificacao-vira-a-fonte-da-verdade-nao-o", "markdown": "https://wpnews.pro/news/spec-driven-development-quando-a-especificacao-vira-a-fonte-da-verdade-nao-o.md", "text": "https://wpnews.pro/news/spec-driven-development-quando-a-especificacao-vira-a-fonte-da-verdade-nao-o.txt", "jsonld": "https://wpnews.pro/news/spec-driven-development-quando-a-especificacao-vira-a-fonte-da-verdade-nao-o.jsonld"}}