Speckit: a Esteira de Specs

O toolkit oficial do GitHub que transforma a spec
no motor versionado do projeto.

Canal Sandeco

O mapa do capítulo

Três ferramentas, duas categorias: você escolhe um framework e soma o harness.

BMAD e Speckit disputam a mesma vaga

O Harness é de outra natureza: vale para qualquer escolha.

Duas categorias, não três papéis

BMAD

Speckit

Harness

Você escolhe um

A planta baixa antes do primeiro tijolo

Nenhum pedreiro sério levanta uma parede sem a planta na mão.

Speckit é a planta baixa e o contrato de obra

O SDD do Capítulo 6 deixa de ser mentalidade e vira ferramenta.

Da intenção formalizada ao tijolo

Contrato de obra

Planta baixa

Sem improviso

Rastreável

A spec, a única fonte da verdade

Cada comando lê a spec, atualiza a spec ou deriva algo dela.

A spec vira o eixo do projeto

Sem fonte única, o projeto deriva em silêncio; com ela, o desvio aparece.

Tudo deriva da spec

Executável

Versionada

Fonte da verdade

Anti-deriva

A deriva silenciosa

Sem fonte única, cada conversa empurra o projeto um pouco para um lado.

O problema mais corrosivo do desenvolvimento com IA

Com a spec como fonte única, qualquer desvio aparece.

O código é cobrado contra um contrato que não muda

Sem fonte única

Deriva em silêncio

Contrato escrito

Desvio aparece

O specify: a esteira começa a girar

Instala a CLI, inicializa o projeto, e os comandos viram slash commands.

uv tool install specify-cli

specify init agente-tarefas, e a esteira do SDD gira por baixo.

Você continua onde já trabalhava

uv ou pipx

specify init

Slash commands

Multi-agente

Onde moram os artefatos

Não é tudo na mesma pasta: o núcleo em .specify, os artefatos em specs/.

A estrutura que o specify cria

Núcleo do framework versus artefatos por funcionalidade.

Cada coisa no seu lugar

.specify

specs/

constitution.md

skills

A constituição: as leis inegociáveis

Os princípios que nenhuma implementação pode violar, no espírito do RULES.md.

/speckit-constitution define o ponto de partida

constitution.md mora em .specify/memory.

As leis que o projeto inteiro honra

constitution.md

Princípios inegociáveis

Espírito do RULES.md

Nenhuma viola

Do constitution ao implement, sem pular etapa

Cinco comandos do núcleo, três skills opcionais de qualidade.

A potência do Speckit está na ordem

Cada etapa se apoia na anterior; pular o plan é implementar improviso.

A esteira do núcleo, na ordem

constitution

specify

plan

tasks

implement

/speckit-constitution: os princípios

Define as leis inegociáveis que nenhuma implementação pode violar.

Etapa 1 de 5

Entra: a intenção. Sai: constitution.md.

As leis que o projeto inteiro honra

Princípios

Inegociável

constitution.md

Ponto de partida

/speckit-specify: o que construir

Descreve o sistema em comportamento observável, a partir de um pedido em linguagem natural.

Etapa 2 de 5

Entra: constitution.md. Sai: spec.md.

A intenção vira contrato escrito

Comportamento observável

Linguagem natural

spec.md

O quê

/speckit-plan: o como técnico

Traduz o quê em como: linguagem, estrutura de pastas, persistência.

Etapa 3 de 5

Entra: spec.md. Sai: plan.md.

Quem pula o plan implementa improviso

Linguagem

Estrutura de pastas

Persistência

plan.md

/speckit-tasks: fatia em tarefas

Quebra o plano em tarefas pequenas e ordenadas, prontas para atacar uma a uma.

Etapa 4 de 5

Entra: plan.md. Sai: tasks.md.

Prontas para serem atacadas em sequência

Tarefas pequenas

Ordenadas

Uma a uma

tasks.md

/speckit-implement: implementa contra a spec

Codifica tarefa por tarefa, sempre contra a spec e o plano que vieram antes.

Etapa 5 de 5

Entra: tasks.md (e a spec). Sai: o código-fonte.

A esteira entrega software pronto na outra ponta

Tarefa por tarefa

Contra a spec

Testes verdes

Código-fonte

As três redes de segurança

Skills opcionais de qualidade que entram entre as etapas quando o projeto pede rigor.

Nenhuma é obrigatória, todas evitam derivar

O tipo de rigor que o vibe coding nunca teve.

clarify e checklist antes do plan; analyze antes do implement

/speckit-clarify

/speckit-checklist

/speckit-analyze

BMAD ou Speckit: qual escolher

Duas filosofias para o mesmo fim; você escolhe uma.

BMAD

pelas pessoas, time de personas

VS

SPECKIT

pelo documento, esteira de specs

Time ágil de personas

Metáfora central

Esteira de specs versionadas

Pelas pessoas

Eixo

Pelo documento (a spec)

A persona (PM, Dev, QA)

Unidade de trabalho

O comando (specify, plan)

A revolução ágil (Cap. 2)

Herança

O Spec-Driven Development (Cap. 6)

npx bmad-method install

Instalação

uv tool install specify-cli

Projeto open-source da comunidade

Origem

Toolkit oficial do GitHub

Você quer papéis e ritmo de sprint

Brilha quando

Você quer contrato formal e rastreável

Escolha um, reforce com testes e harness

Escolha um

Some testes por cima

Some harness por cima