Principais Artefatos do SDD
Os artefatos do Spec-Driven Development (SDD) são documentos e estruturas formais utilizados como a "única fonte da verdade" para agentes de Inteligência Artificial escreverem, validarem e iterarem código. Em vez do código fonte principal, a especificação torna-se o contrato executável do projeto.Para uma visão geral de como o SDD funciona e como agentes de IA utilizam esses artefatos para guiar o projeto:
O ecossistema do SDD baseia-se em uma anatomia de arquivos de texto (geralmente em formato Markdown) onde a intenção do software é detalhada antes de qualquer linha de código ser gerada[1].
SPEC.md(Especificação de Intenção):
O artefato mais importante. Define o O Que e o Porquê. Ele encapsula histórias de usuário (user stories), regras de negócio, restrições, limites de escopo e os critérios de aceitação. Deve ser agnóstico quanto à tecnologia utilizada[2]. spec-template.mdCONSTITUTION.md(Princípios Fundamentais):
Comum em toolkits de código aberto como o Spec Kit, este arquivo estabelece as regras inegociáveis do projeto. Inclui a stack tecnológica, regras arquiteturais, convenções de lint, padronização de commits e políticas de acessibilidade[1:1]. constitution-template.mdPLAN.md(Estratégia Técnica):
Traduz a intenção abstrata doSPEC.mdem decisões técnicas concretas. Define o Como: escolhas de bibliotecas, estrutura de pastas, fluxos de banco de dados e abordagens de arquitetura, servindo como o planejamento global para os subagentes[3]. plan-template.mdTASKS.md(Tarefas e Execução):
Derivado do plano técnico, divide o trabalho de forma otimizada para o entendimento dos agentes. Cada tarefa define o que deve ser feito, quais arquivos serão alterados, pré-requisitos e critérios de conclusão para execução em paralelo[4]. tasks-template.md- AGENTS.md (Configuração de Agentes):
Em abordagens multi-agentes (como o uso do Codex), este artefato documenta a divisão de responsabilidades, por exemplo: quem é o Agente Arquiteto (especificação), o Agente Engenheiro (implementação) e o Agente Revisor (validação)[5].
Referências
#sdd #Inteligencia-artificial #Projeto
O ecossistema do SDD baseia-se em uma anatomia de arquivos de texto onde a intenção do software é detalhada antes da geração de código. Spec-Driven Development: A Nova Arquitetura de Engenharia de Software na Era dos Agentes de IA – Parte 3 - Data Science Academy ↩︎ ↩︎
O artefato define o O Que e Porquê, encapsulando histórias de usuário, regras de negócio, restrições e critérios de aceitação, sendo agnóstico quanto à tecnologia. Spec-Driven Development: A Nova Arquitetura de Engenharia de Software na Era dos Agentes de IA – Parte 2 - Data Science Academy ↩︎
O
PLAN.mdtraduz a intenção abstrata em decisões técnicas concretas, definindo escolhas de bibliotecas, estrutura de pastas e abordagens arquiteturais para os subagentes. YouTube, blog DSAcademy ↩︎O
TASKS.mddivide o trabalho em tarefas otimizadas com pré-requisitos claros e critérios de conclusão, facilitando a execução paralela dos agentes. YouTube tutorials (Spec-Driven Development: O Fim do Vibe Coding - YouTube) ↩︎Documenta a divisão entre Agente Arquiteto (especificação), Engenheiro (implementação) e Revisor (validação). Medium blog por Marcos Abreu ↩︎