Skip to content

docs: por que só as telas principais no protótipo, e o que fazer com as demais - #12

Open
ronifabio wants to merge 1 commit into
mainfrom
chore/prototipo-telas-principais
Open

ronifabio wants to merge 1 commit into
mainfrom
chore/prototipo-telas-principais

Conversation

@ronifabio

Copy link
Copy Markdown
Contributor

O que este PR faz e por quê

Traz para o template de Angular a orientação do utf-sdd-template (utfpr-gp/utf-sdd-template#18), adaptada a uma diferença importante: aqui não existe documento de jornadas, porque o protótipo navegável é a jornada e é avaliado (ID1). O template pedia "de três a cinco telas" sem dizer por que não todas, e o modelo-spec.md afirmava que "as telas desta história estão no protótipo" — o que não vale para as histórias que não estão entre as principais. Num uso real, as telas geradas pela IA também inventaram regras que o PRD tinha recusado (preço, "disponível imediatamente", "certificado", filtros fora de escopo).

O PR acrescenta, sem mudar o fluxo:

  • guia §3.5 — por que três a cinco e não todas (a tela envelhece antes da spec; a coerência vem dos tokens), quais escolher, o aviso de que a ferramenta de protótipo inventa regra de negócio e a regra de precedência: vale o documento, e o protótipo, que é entrega avaliada, é corrigido para concordar com ele.
  • /utf-design, Passo 1.3 — explicar o porquê, conferir o texto das telas contra o prd.md (pelo MCP, quando houver) e registrar contradições como pendência do protótipo.
  • /utf-issue e modelo-spec.md — a referência visual da história é o design-tokens.md; tela que não está no protótipo nasce no ciclo; tela que está tem o texto conferido contra a spec.
  • docs/design-tokens.md — a frase de precedência no cabeçalho.

Apontamentos da revisão

Não se aplica (manutenção do template).

Aceitos:

Recusados (com o motivo):

🤖 Generated with Claude Code

…as demais

Adapta ao template de Angular a mesma orientação do utf-sdd-template (PR #18),
respeitando que aqui o protótipo navegável é a jornada e é avaliado (ID1):

- guia §3.5: por que três a cinco telas e não todas, quais escolher, e o aviso
  de que a ferramenta de protótipo inventa regra de negócio — com a regra de
  precedência (vale o documento) e a correção do protótipo, que é entrega;
- /utf-design: explicar o porquê, conferir o texto das telas contra o PRD e
  registrar contradições como pendência do protótipo;
- /utf-issue e modelo-spec: a referência visual é o design-tokens.md; tela que
  não está no protótipo nasce no ciclo; a que está tem o texto conferido;
- design-tokens.md: quando protótipo e documento divergirem, vale o documento.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@ronifabio ronifabio added the manutencao PR tecnico, sem spec label Oct 15, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

manutencao PR tecnico, sem spec

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant