Spec
Consolida business.md e technical.md numa spec.md única, auto-suficiente e sem código.
makuco-specify
Função
Consolida o business.md e o technical.md de um PBI em uma spec.md auto-suficiente e
não-ambígua. Produz apenas o documento de spec. Nunca escreve código.
Entradas e gatilhos
- Lê:
business.md+technical.mddo PBI. - Gatilhos: escrever spec, consolidar spec, especificar PBI.
- Subagentes:
makuco-copy-writer,Explore.
Skills carregadas
makuco-workspace-detection— localiza a raiz.makuco/.makuco-artifact-spec— formato do artefato (segue ospec-template).
Exemplo de saída — spec.md
---
stage: spec
feature: gestao-cupons
pbi: aplicar-cupom
created_at: 2026-06-15
status: done
---
# Spec — Aplicar cupom
## Objetivo
Aplicar cupom válido no checkout, refletindo o desconto no total.
## Quem acessa
Cliente autenticado no checkout.
## Histórias de usuário
### HU-01 — Aplicar cupom
Como cliente, quero aplicar um cupom para obter desconto.
## Regras de negócio
- RN-01: Cupom expirado não pode ser aplicado.
## Contrato técnico
`POST /carts/{id}/coupon` → 200 `{ total, discount }`.
## Requisitos não funcionais
Resposta < 300ms; rate limit por carrinho.
## Casos de teste
- Cupom válido aplica desconto; cupom expirado retorna 422.
## Critérios de aceite
- CA-01: desconto reflete no total.
## Critério de sucesso
Aumento de conversão no checkout.
## Fora de escopo
Cupons acumulativos.Modelos sugeridos
| Perfil | Modelo | Quando usar |
|---|---|---|
| Recomendado | Sonnet 4.6 | Consolidação fiel de insumos já estruturados. |
| Econômico | Haiku 4.5 | PBIs pequenos, insumos já muito completos. |
| Máxima qualidade | Opus 4.8 | Specs longas com muitas regras a reconciliar. |