Expectation-First Development

A AI sabe
o que você espera.

SEDD captura sua expectativa antes de qualquer código. Migrations incrementais. Validação automática. Zero escopo perdido.

sedd
SEDD em ação - capturando expectativas

Sem SEDD

# Você pede:
"Implementa dark mode"

# AI entrega:
- Cria endpoint em serviço errado
- Usa localStorage (você queria DB)
- Esquece persistência cross-session
- 3 horas revertendo código

Com SEDD

# Você define expectativa:
DEVE: "Toggle dark mode, persistir no DB"
NÃO DEVE: "Criar endpoint em service-x"

# AI valida cada task:
✓ Coverage: 85%
✓ Validação automática
✓ Checkpoints de alinhamento

Por que Expectativas?

O problema do Spec Driven Development

Spec Driven Development já existe. Desenvolvimento orientado a especificação. Você escreve o que quer, a AI implementa. Simples, certo?

Não. LLMs têm limitações reais: contexto grande se perde, linha de raciocínio se fragmenta, e o código vira uma colcha de retalhos. Cada prompt é um reset. Cada sessão, uma chance de desviar do objetivo original.

Sem metodologia? Pior ainda. Código cresce, manutenção explode, ninguém lembra o porquê das decisões.

A estratégia humana

Esse conceito veio de uma observação simples sobre como humanos funcionam bem: expectativas claras geram alinhamentos claros.

Na vida, quando você sabe exatamente o que espera de uma situação, suas decisões ficam mais consistentes. Você não desvia. Você não esquece. Você tem um norte.

Spec & Expectation Driven Development

SEDD adiciona uma camada crítica: a expectativa tem peso nas decisões.

Não basta especificar "implementa login". É preciso capturar: "O que você espera ver funcionando quando estiver pronto?"

Especificação O QUE construir
+
Expectativa COMO você imagina funcionando
=
Alinhamento AI que nunca desvia

A expectativa vira âncora. A cada task, a cada checkpoint, a cada decisão — SEDD valida contra o que você realmente espera. Não o que a AI interpretou. Não o que parecia fazer sentido no momento. O que você disse que queria.

Controle Total do Escopo

DEVE e NÃO DEVE. A AI nunca mais vai além ou aquém do que você espera.

🎯

Expectation-First

Captura obrigatória do que você espera ver funcionando. Antes de qualquer código.

📊

Coverage Score

Calcula % de cobertura das tasks vs. sua expectativa. Identifica gaps automaticamente.

Validação NÃO DEVE

Cada task é validada contra restrições. Viola regra? Bloqueia e alerta.

Acceptance Criteria

Gera checklist de aceite baseado na expectativa. Critérios positivos e negativos.

Checkpoints

A cada N tasks, SEDD verifica alinhamento. "Ainda está alinhado?"

📂

Migrations

Sistema incremental. Cada clarificação vira uma migration com histórico.

GitHub Projects

Kanban board integrado. Sync de issues, colunas e status direto do GitHub Projects V2.

📍

Multi-Org

Escolha entre suas organizações e conta pessoal. Setup interativo com detecção automática.

Como Funciona

4 passos. Expectativa capturada. Board sincronizado. AI alinhada.

01

Especifique a Feature

Crie a spec com um ID único. SEDD pergunta sua expectativa imediatamente.

$ sedd specify 001 user-auth 🎯 Qual é sua EXPECTATIVA? > User can login with email/password ✓ Feature 001-user-auth criada
02

Clarifica e Gere Tasks

Defina DEVE e NÃO DEVE. SEDD gera tasks e calcula coverage.

/sedd.clarify DEVE: Criar endpoint REST, usar bcrypt NÃO DEVE: Tocar em auth-service-legacy 📊 Coverage: 92% Tasks: T001-001, T001-002, T001-003...
03

Implemente com Validação

A cada task, SEDD valida contra expectativas. Checkpoints automáticos.

/sedd.implement ✓ T001-001 Create user model ✓ T001-002 Add password hashing ⏸ Checkpoint 2/4 - Alinhado? [Y/n]
04

Acompanhe no Board

Conecte ao GitHub Projects e acompanhe tudo em um kanban. Escolha a org, o projeto e as colunas. SEDD sincroniza o status das tasks.

$ sedd github setup Step 5/7: Select organization... 1. kelvin (personal) 2. my-org 3. another-org ✓ Using: my-org $ sedd board ██ Todo ██ In Progress ██ Done
// funciona com qualquer AI assistant

Comece Agora

Uma linha. Expectativas sempre capturadas.

$ npm install -g sedd