Framework
Docs

03 — Fluxo Spec → Implementação

Princípio: Spec Before Code

Toda feature não trivial (módulo novo, contrato novo) começa com spec.md aprovado.

Go-horse (decisão do projeto): prompts de correção, polish e hotfix não passam pelo Spec Kit — implementação direta. Detalhes e faixas 1–3: PLAYBOOK — Spec vs go-horse.

Modo BDFU (padrão neste repo): especificar todo o produto v1 em specs/ (índice em specs/README.md) antes de iniciar implementação em massa (Fase 4). Ver PLAYBOOK.md Fases 3–4.

Pipeline (dia a dia com IA)

# 1. Sempre primeiro — nunca mkdir manual em specs/
pnpm spec:new -- --short-name "nome" "Descrição"

# 2. Chat 1 ou /speckit.specify — spec completa de uma vez
#    spec.md + plan.md + tasks.md + checklists/requirements.md

# 3. Gates (produção: auth, billing)
# /speckit.clarify → /speckit.checklist security → /speckit.analyze

# 4. Implement
# /speckit.implement → código + tasks [x]

Fluxo resumido:

pnpm spec:new  →  Chat 1 (spec completa)  →  /speckit.analyze (prod)  →  /speckit.implement

Regra Cursor: .cursor/rules/spec-kit.mdc · Spec ativa exemplo: specs/001-setup-initial/ · Referência shipped: specs/002-auth-module/

Onde vive cada artefato

ArtefatoPath
Constitution.specify/memory/constitution.md
Templates.specify/templates/
Feature specsspecs/NNN-nome-curto/
Regras de negócio (macro)docs/product/
Arquiteturadocs/development/01-architecture-stack.md

Conteúdo da spec

  • O quê e por quê — nunca detalhe de implementação
  • User stories com prioridade P1, P2, …
  • Requisitos funcionais FR-xxx mensuráveis
  • Edge cases e [NEEDS CLARIFICATION] (máx. 3)

Quality gates (antes de implement)

  1. checklists/requirements.md completo (gerado por Chat 1 ou /speckit.specify)
  2. Checklists de domínio relevantes via /speckit.checklist (ex.: security, ux) — todos [x]
  3. plan.md com paths reais do monorepo
  4. tasks.md com IDs, dependências e arquivos explícitos
  5. /speckit.analyze sem gaps críticos (prod)

Checklists ≠ implementação: validam qualidade dos requisitos. Status de código (spec retroativa): implementation-status.md ou tasks.md.

Ligação com produto

Antes de especificar:

  1. Módulo listado em product/04-features-modules.md?
  2. Critério de pilar em product/03-pillars-criteria.md?
  3. No roadmap product/05-roadmap-prioritization.md?

Após ship: atualizar status do módulo + 08-changelog.

Multi-agentes (Cursor + Spec Kit)

Guia completo: 09-cursor-multi-agents-spec-kit · Atalho: CURSOR.md

Scripts úteis

pnpm spec:new -- --short-name "nome" "Descrição"
pnpm spec:use -- 6                    # feature ativa → specs/006-*/
pnpm spec:check     # valida feature ativa e artefatos

Links relacionados