O desenvolvimento orientado a especificações (Spec-driven development) teve destaque em nossas discussões neste ciclo. Duas grandes abordagens estão surgindo: equipes que confiam na evolução contínua dos agentes de programação com o mínimo de estrutura, e aquelas que preferem fluxos de trabalho definidos e especificações detalhadas.
Vários de nossos times estão experimentando práticas orientadas por especificações usando o GitHub Spec Kit, principalmente em ambientes pré-existentes (brownfield). Um conceito-chave no Spec Kit é a constituição, um documento-base de princípios que alinha o ciclo de vida de desenvolvimento de software. Na prática, os times relataram que uma constituição útil normalmente captura o escopo do projeto, contexto de domínio, versões de tecnologia, padrões de codificação e estrutura do repositório (por exemplo, arquitetura hexagonal ou módulos em camadas). Esse contexto compartilhado ajuda os agentes a operar dentro dos limites arquitetônicos pretendidos.
Os times também encontraram desafios como o crescimento excessivo das instruções, onde a adição contínua de contexto do projeto levou a um conjunto crescente de instruções do agente e, eventualmente, à deterioração do contexto. Um time resolveu isso extraindo orientações reutilizáveis para arquivos de skills, mantendo as instruções do agente enxutas e carregando o contexto detalhado apenas quando necessário.
Em sistemas brownfield, muito do retrabalho decorre de intenção pouco clara, suposições ocultas e descoberta tardia de restrições. Um time adotou um ciclo de vida de spec → plan → tasks → coding → review, o que ajudou a identificar problemas mais cedo. Com o tempo, também moveram o contexto reutilizável para arquivos como .github/prompts/speckit.<command>.prompt.md, tornando os prompts mais curtos e o comportamento do agente mais consistente. Os times relataram algumas limitações, incluindo verificações defensivas desnecessárias e saídas em Markdown verbosas demais que aumentavam a carga cognitiva. Personalizar os templates e as instruções do Spec Kit — por exemplo, limitando o número de arquivos markdown gerados e reduzindo a verbosidade do console — ajudou a resolver alguns desses problemas.
Em última análise, pessoas engenheiras experientes, particularmente aquelas com boas práticas de clean code e arquitetura, tendem a extrair o máximo de valor de workflows orientados a especificações.
