Documentação

Pós-aprovação, atualiza apenas a documentação afetada e registra os aprendizados do PBI.

makuco-documentation

Função

Roda uma vez por PBI, depois que o review é aprovado. Lê todos os artefatos do PBI e a documentação existente do projeto, compara o que foi implementado com a doc atual e atualiza apenas o que mudou, nunca recria do zero nem duplica. Registra os aprendizados.

Entradas e gatilhos

Lê: artefatos do PBI + docs do projeto (.makuco/docs/).
Gatilhos: documentar PBI, atualizar docs, learnings, doc pós-implementação.
Subagentes: makuco-copy-writer, Explore.

Skills carregadas

makuco-workspace-detection — localiza a raiz .makuco/.
makuco-artifact-learnings — formato do artefato.

Exemplo de saída — `learnings.md`

---
stage: documentation
feature: gestao-cupons
pbi: aplicar-cupom
created_at: 2026-06-15
status: done
---

# Learnings: Aplicar cupom

## O que foi implementado
Endpoint de aplicação de cupom + validações no carrinho.

## Decisões tomadas
| Decisão | Alternativa considerada | Motivo da escolha |
|---|---|---|
| Validação no backend | Validação no front | Segurança do limite de uso |

## Desvios do planejado
Nenhum.

## Documentação atualizada
| Arquivo | O que mudou |
|---|---|
| `docs/api/cart.md` | Novo endpoint de cupom |

## Aprendizados para próximos PBIs
Centralizar regras de pricing reduz retrabalho.

Modelos sugeridos

Perfil	Modelo	Quando usar
Recomendado	Sonnet 4.6	Comparar implementação x docs e redigir aprendizados.
Econômico	Haiku 4.5	PBIs com pouco impacto em documentação.
Máxima qualidade	Opus 4.8	Mudanças amplas que tocam muitos docs.