Kit proprietário · Spec‑Driven Development · Claude Code e Codex

Spec Ultra

O kit de skills agênticas que o time leva instalado no Programa: especificação rigorosa antes do código, um plano de implementação eficiente depois, e verificação de qualidade em cada fase do caminho.

  • Planejamento em seis fases: enriquecimento de contexto, requisitos funcionais e não‑funcionais, desenho de arquitetura com decisões registradas, tarefas rastreadas a requisitos e uma checagem final de confiança.
  • Implementação disciplinada: testes antes do código (TDD) e tarefas independentes em paralelo, com checkpoints de integração.
  • Funciona nos agentes que o time já usa: Claude Code e Codex.
Aba de requisitos de uma spec gerada pelo Spec Ultra, com requisitos funcionais e não-funcionais em formato EARS, prioridade e padrão
FIG. 01 · Requisitos de uma spec real. Formato EARS, com prioridade, padrão e rastreabilidade até tarefa e commit.

Método embutido · EARS · QAS · ATAM‑Lite · C4 · ADR/MADR · TDD · Ondas paralelizáveis

Por que existe

Na classe Novidade, errar o plano custa mais que errar o código.

Migrar a versão do Delphi, implementar a autenticação nova, o problema que aparece uma vez: essa é a classe Novidade da Dicotomia de Problemas. Nela, um agente sem especificação produz código confiante na direção errada, e o retrabalho aparece semanas depois.

O Spec Ultra instala no agente a disciplina que essa classe exige: primeiro uma especificação completa, verificada fase a fase, depois uma implementação que segue o plano, com cada tarefa rastreável aos requisitos que ela atende.

O método · Planejamento · skill spec

Da conversa à especificação verificada.

A skill de planejamento conduz a elicitação, pesquisa o contexto e produz a spec completa: requisitos, decisões, design e tarefas. São seis fases em sequência, e cada uma só fecha com o resultado verificado: é isso que impede o agente de pular etapas.

  1. 0

    Enriquecimento de contexto

    Contexto do repositório, pesquisa das melhores práticas de mercado e entrevista com quem conhece o problema: informação de alta qualidade antes do primeiro requisito.

  2. 1

    Requisitos

    Funcionais e não-funcionais em formato padronizado, cada um com prioridade e critério de medição, sem ambiguidade.

  3. 2

    Contexto

    O sistema, seus usuários e as dependências externas em uma única figura: todos enxergam a mesma fronteira do problema.

  4. 3

    Arquitetura

    Alternativas comparadas critério a critério, desenho da solução em diagramas e cada decisão registrada com a sua justificativa.

  5. 4

    Tarefas

    O trabalho quebrado em tarefas ligadas aos requisitos que realizam, sequenciadas pelo grafo de dependências num plano de implementação eficiente.

  6. 5

    Checagem de confiança

    A especificação passa por uma revisão final de completude e consistência; a implementação só começa quando nada crítico ficou em aberto.

Decisão de arquitetura gerada pelo Spec Ultra com matriz ATAM-Lite comparando três alternativas com pesos e pontuações por critério
FIG. 02 · Decisão de arquitetura (ADR). Alternativas pontuadas critério a critério na matriz ATAM‑Lite, com a escolha justificada.
Aba de design de uma spec do Spec Ultra com diagrama C4 de contexto do sistema e anotação dos requisitos que cada figura realiza
FIG. 03 · Design em diagramas C4. Cada figura declara quais requisitos realiza; a rastreabilidade é parte do documento.

O método · Implementação · skill spec-dev

Da especificação ao código, em paralelo e sob controle.

A skill de implementação executa o plano montado na especificação: tarefas independentes rodam em paralelo, agrupadas por tema, e cada grupo termina num checkpoint de integração e revisão que confirma que tudo funciona junto. Dentro de cada tarefa, cinco checagens disciplinam o trabalho.

  1. A

    Dependências

    Verifica que as tarefas anteriores foram entregues de verdade antes de começar a nova.

  2. B

    Testes primeiro

    Escreve os testes que falham antes de qualquer código de produção (TDD obrigatório).

  3. C

    Implementação

    Código mínimo para os testes passarem, seguido de refatoração com a suíte verde.

  4. D

    Documentação

    Atualiza a documentação afetada; em telas, valida o resultado com o usuário antes de seguir.

  5. E

    Commit

    Uma tarefa vira um commit, sempre com aprovação explícita: o kit nunca commita sozinho.

É o checkpoint que garante que o especificado vira o implementado: a cada grupo entregue, o trabalho é integrado, revisado e verificado contra os requisitos antes de a próxima frente começar.

Grafo de dependências de tarefas gerado pelo Spec Ultra, organizado em Ondas com checkpoints entre elas
FIG. 04 · Grafo de dependências. Tarefas organizadas em Ondas, com checkpoints entre elas e o caminho crítico identificado.
Plano de implementação de uma Onda no Spec Ultra: tarefas com executor, passos de construção, critérios de aceitação e verificação
FIG. 05 · Plano de uma Onda. Cada tarefa com executor definido, passos, critérios de aceitação, verificação e os requisitos que realiza.

Prova Concreta · documento navegável

Uma spec de verdade, aberta para inspeção.

Este documento foi gerado pelo Spec Ultra para uma demo (uma calculadora com animação de ondas do mar). Navegue pelas abas de requisitos, decisões, design e tarefas e siga a rastreabilidade entre elas.

DOC. 01 · Spec compilada pelo Spec Ultra. Documento real, sem edição posterior. Role e clique dentro da folha.

Abrir em tela cheia

Como o time recebe o kit

O Spec Ultra chega instalado, demonstrado e praticado.

O kit é parte do Programa Desenvolvimento Acelerado por IA: a instalação acontece no Curso Online, a demonstração e a prática acontecem no Workshop.

  1. 01

    Curso Online · módulo Setup

    Cada aluno instala o kit e chega ao Workshop com o agente respondendo e o Spec Ultra disponível.

  2. 02

    Workshop · demo ao vivo

    O instrutor constrói uma aplicação completa com o Spec Ultra, da elicitação e pesquisa à implementação: o fluxo inteiro, sem cortes.

  3. 03

    Prática e continuidade

    No Prototype Shotgun, as duplas aplicam o kit em problemas reais da empresa. O time segue com o Spec Ultra instalado depois do Programa.

O Spec Ultra cobre a classe Novidade. Para o trabalho repetitivo, a classe Mais do Mesmo, o Programa gera Agent Skills pelo método Percorrer & Cristalizar. As duas técnicas juntas cobrem quase todo o trabalho do time: conheça o Programa completo.

Spec Ultra · Parte do Programa “Desenvolvimento Acelerado por IA”

Leve o Spec Ultra instalado no seu time.

Conte o contexto do seu time no formulário e receba uma proposta com o desenho do Programa para a sua empresa.