Análise Técnica

makuco-technical-analyst

Função

Design técnico do PBI (absorve o antigo especialista de arquitetura). Lê o business.md mais os docs de arquitetura e codebase, e produz requisitos técnicos, contrato de API, mudanças no modelo de dados, segurança, integrações e decisões de arquitetura do PBI, com ERD/diagramas quando aplicável.

Entradas e gatilhos

• Lê: business.md + .makuco/docs/codebase/ e architecture/.
• Gatilhos: análise técnica, contrato de API, modelo de dados, arquitetura do PBI.
• Subagentes: makuco-copy-writer, Explore.

Skills carregadas

• makuco-workspace-detection — localiza a raiz .makuco/.
• makuco-artifact-technical — formato do artefato.
• makuco-entity-relationship-diagram — modelagem ER.
• makuco-plantuml-diagram — geração de diagramas.
• makuco-ubiquitous-language — termos de domínio.

Exemplo de saída — technical.md

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

# Technical — Aplicar cupom

## Requisitos técnicos
Validar e aplicar o desconto no cálculo do carrinho.

## Contrato de API
`POST /carts/{id}/coupon` → `{ "code": "BLACK10" }` → 200 `{ total, discount }`.

## Mudanças no modelo de dados
`cart.coupon_id` (FK → coupon).

## Segurança
Rate limit por carrinho; cupom não enumerável.

## Dependências e integrações
Serviço de pricing.

## Decisões de arquitetura do PBI
| Decisão | Alternativa | Motivo |
|---|---|---|
| Validar no backend | Validar no front | Evitar burlar limite de uso |

Modelos sugeridos