AISP · AI Spec Protocol

Não é velocidade.É direção.

Especificação de requisitos com IA para desenvolvedores — triagem, análise e plano antes do código.

Todo dia seu time entrega código. Parte dele será refeita. Não por falta de habilidade, mas por falta de clareza antes de começar. O AI Spec Protocol estrutura o que a IA sozinha não consegue: a decisão certa, antes da linha errada.

Agent Auto
Agent
O PROBLEMA

Não é mais um framework. É inteligência de processo.

Seu time ficou mais rápido. Mas velocidade na direção errada custa caro. Um card mal especificado descoberto no terceiro dia de sprint pode invalidar 30% do esforço do Squad.

15–30%
RETRABALHO POR SPRINT

Times sem processo estruturado desperdiçam até 30% de capacidade em rework causado por especificação inadequada.

40–60%
DE REDUÇÃO COM AISP

Após 6 sprints de adoção consistente, os mesmos times relatam redução nesse indicador.

< 90min
OVERHEAD POR DEMANDA

De 15 minutos (baixo risco) a 90 minutos (integrações críticas). Menor que o custo de não tê-lo.

Estimativas baseadas em prática de times e relatos de adoção consistente do protocolo — não constituem garantia de resultado.

O CUSTO REAL

O problema quase nunca aparece com seu nome verdadeiro.

O card parece claro. O desenvolvedor começa confiante. No meio da implementação, surge uma regra implícita, uma dependência esquecida ou uma decisão de produto que ninguém formalizou. O código para. O PO entra no meio do sprint. A resposta vem parcial, a interpretação vem humana, e o retrabalho aparece no calendário com outro nome: ajuste, alinhamento, mudança de escopo.

01

Segunda-feira: o card parece pronto.

02

Quarta-feira: a lacuna aparece no código.

03

Quinta-feira: o PO responde sob pressão.

04

Sexta-feira: o time reescreve o que parecia certo.

O problema não foi velocidade. Foi clareza antes do código.

O FLUXO

Sete skills. Uma direção.

Cada skill tem papel único. Cada demanda percorre o caminho certo para o seu nível de risco — sem cerimônia desnecessária, sem lacuna silenciosa.

01
@spec-protocol-triage

Entrada obrigatória. Classifica tipo e risco da demanda.

02
@spec-protocol-analyze

Análise técnica. Cruza card com codebase, atualiza spec.md.

03
@spec-protocol-dor

Definition of Ready. Prontidão proporcional ao risco.

04
@spec-protocol-po

Comunicação de produto. Co-especificação A/B para o PO.

05
@spec-protocol-revalidate

Revalidação. Fecha lacunas após resposta do PO.

06
@spec-protocol-plan

Planejamento. Gera e refina plan.md e tasks.md.

07
@spec-protocol-exception

Modo de exceção. Bypass formal com risco registrado.

@spec-protocol-help

Onboarding do Spec Protocol no Cursor, Claude Code ou IDE compatível — fluxo, skills e CLI.

O CONTRASTE

Mesma demanda. Dois resultados completamente diferentes.

Sem protocolo, o time conversa com a IA no improviso, aceita saídas plausíveis e descobre dúvidas durante a implementação. Com AISP, a demanda entra por triagem, as hipóteses são marcadas, as decisões ficam registradas e o plano chega ao código com direção suficiente para executar sem navegar no escuro.

Sem protocolo

  • O card parece bom o bastante.
  • A IA responde com confiança, não com evidência.
  • Dúvidas aparecem quando o código já começou.
  • A conversa se perde em chat, call ou memória oral.
  • O PO entra tarde, sob pressão e sem contexto estruturado.

Com AISP

  • A demanda é classificada por tipo e risco.
  • Toda inferência sem prova vira HYPOTHESIS.
  • Lacunas críticas aparecem antes da implementação.
  • Decisões vivem em spec.md, plan.md e tasks.md.
  • O PO responde sobre opções e impactos, não sobre perguntas vagas.

Não é fazer mais cerimônia. É errar menos na direção.

OS ARTEFATOS

Três arquivos. Rastreabilidade total.

Decisões, não chats perdidos. Tudo no repositório, versionado e legível pelo dev, pelo agente de IA e pelo PO que entrou no time há duas semanas.

spec.md
# Objetivo
Implementar handler de webhook Stripe para atualizações de assinatura.

# Regras de negócio
- Em falha de pagamento → downgrade imediato para tier gratuito.
- [HYPOTHESIS] ID de usuário existente corresponde ao metadata do cliente Stripe.
- [CRITICAL] Chave de idempotência obrigatória — eventos duplicados devem ser seguros.

# Metadados
Risk level: HIGH
Status:     PARTIALLY READY
Owner:      @backend-team
IA DO JEITO CERTO

Menos conversa aleatória. Mais raciocínio distribuído no fluxo.

A maioria dos times usa IA como interlocutor improvisado: pergunta, repete, corrige, tenta de novo. O AISP muda essa relação. Em vez de depender de prompt engineering manual a cada demanda, você aciona skills com papel claro, artefatos com estrutura conhecida e um fluxo que obriga a separar hipótese, evidência, risco e decisão.

Chat solto com IA

chat

Implementa o handler do webhook Stripe.

Claro! Aqui está uma solução completa...

Espera — e a idempotência?

Boa pergunta. Tente assim...

Qual era o contexto do card mesmo?

Fluxo AISP

AISP flow
01/spec-protocol-triage — classifica risco e lacunas
02spec.md — hipóteses marcadas, decisões pendentes
03plan.md — abordagem e critérios de aceite
04tasks.md — checklist pronto para executar
Menos tempo inventando prompt.
Menos esforço lembrando contexto.
Menos chance de aceitar texto bonito como verdade.
Mais confiança porque o julgamento continua humano.

A IA amplifica a análise. O protocolo organiza o pensamento. O desenvolvedor decide.

ALÉM DO RETRABALHO

O AISP resolve problemas que o time sente, mas raramente nomeia.

Nem toda perda aparece como bug, atraso ou reabertura de card. Parte do custo está na carga mental de analisar demanda ambígua, na dependência de memória informal do time, no atrito silencioso com o PO e no risco de agentes operarem sem contexto suficiente. O protocolo atua exatamente nessa camada invisível.

Carga cognitiva

A análise profunda de um card é cara em atenção. Sem estrutura, ela é feita pela metade ou pulada.

Onboarding frágil

Quando as decisões não vivem no repositório, o dev novo depende de quem lembra da história.

Mediação que não escala

Muitos times dependem do mesmo dev que sabe falar com negócio. O AISP transforma isso em função explícita do fluxo.

Agente sem contexto

Sem tasks.md claro, um agente tende a introduzir alterações de escopo não intencionais.

O invisível também custa sprint. O protocolo torna esse custo tratável.

QUEM SE RECONHECE AQUI

Perfis diferentes. Um problema comum.

O AISP não fala só com um tipo de profissional. Ele organiza a interface entre desenvolvimento, produto e execução assistida por IA, então o ganho aparece em pontos diferentes do fluxo para cada papel.

01

Dev

Para de começar uma tarefa com a sensação de que vai descobrir o requisito real no meio do caminho.

02

PO

Recebe decisões estruturadas com impacto descrito, em vez de perguntas jogadas no chat durante o sprint.

03

Tech Lead / EM

Escala escrutínio técnico consistente sem depender sempre do mesmo sênior.

04

Time que usa IA na IDE

Sai do improviso conversacional e passa a operar com contexto versionado e fluxo explícito.

A SENSAÇÃO CORRETA

Menos dúvida no caminho. Mais segurança para implementar.

Quando o fluxo obriga a classificar risco, marcar hipótese, registrar decisão e validar prontidão, a sensação de trabalho muda. Você não precisa conduzir conversa solta com a IA para descobrir o que deveria ter sido pensado antes. Você entrega menos no improviso e mais com direção.

Clareza também é produtividade.

Agora que o fluxo está claro, a pergunta deixa de ser “o que é o AISP?” e passa a ser “por onde faz mais sentido começar?”.

Capa do e-book AI Spec Protocol — Guia Prático
AISP · GUIA PRÁTICO

Do card ambíguo à implementação consciente.

Capítulo a capítulo, do custo invisível da ambiguidade ao fluxo completo de implementação consciente. O guia que transforma incerteza em risco gerenciável — com decisões registradas e menos retrabalho.

AISP · CURSO

Fluxo completo em 6 passos já no próximo sprint.

Aulas práticas online. Você sai com o fluxo completo rodando no Cursor, Claude Code ou IDE compatível — triagem, análise, DoR, comunicação com o PO e plano executável em mãos. Cadastre-se e assista à primeira aula grátis: triagem, análise, decisões, plano e implementação com spec.md, plan.md e tasks.md.

Cadastre-se para assistir

Saiba mais sobre o curso

Integrado a qualquer terminal.

Instale via NPM e inicialize as skills, gere os artefatos e valide prontidão direto no repositório em que você já trabalha.

bash
SEM BIG BANG

Você não precisa adotar tudo de uma vez.

O protocolo foi desenhado para ser proporcional ao risco. Demandas simples não exigem peso de processo; demandas críticas não podem ser tratadas com leveza. Isso permite começar pequeno, validar valor e expandir com maturidade.

Nível 01

Triagem antes do código

Use spec-protocol-triage, gere um spec.md mínimo e pare de começar demanda no escuro.

Nível 02

Refinamento completo para demandas médias

Analise, valide prontidão, envolva o PO quando necessário e chegue no plan.md com critérios melhores.

Nível 03

Operação madura de processo

Adicione métricas, modo de exceção formal, revalidação e artefatos preparados para agentes e pipelines.

Comece com o que cabe no próximo sprint. Expanda quando o ganho ficar visível.

AISP · AI SPEC PROTOCOL

Mais clareza.Menos retrabalho.

Você viu o contraste, os perfis e os níveis de adoção. Agora escolha por onde começar — protocolo, guia ou CLI.

Protocolo open source · CLI disponível via npm