O que mudou, por que mudou e como sabemos.

Problema: não havia um registro durável do produto.

Hipótese: documentar público, propósito e restrições evitaria decisões inventadas.

Orientação: preservar HTML, CSS, JavaScript, Bootstrap e localStorage.

Resultado: criação de PRODUCT.md.

Evidência: fatos confirmados e comentário de schema presentes no arquivo.

Decisão: manter o escopo sem backend ou banco de dados.

Problema: a implementação tinha identidade, mas não estava formalmente registrada.

Hipótese: um DESIGN.md reduziria deriva entre páginas e agentes.

Orientação: extrair tokens reais do CSS, sem inventar um novo mundo visual.

Resultado: documentação de cores, tipografia, layout, formas e componentes.

Evidência: tokens correspondem ao CSS existente.

Decisão: usar o sistema atual como referência da v1.

Problema: home extensa, fluxo administrativo misturado e visual repetitivo.

Hipótese: priorizar hierarquia, acessibilidade e especificidade produziria uma v2 comprovadamente melhor.

Orientação: avaliar home, formulário e interatividade sem inventar conteúdo.

Resultado: diagnóstico com pontuação inicial de 22/32.

Evidência: achados side-tab, low-contrast, cramped-padding, flat-type-hierarchy e dark-glow.

Decisão: começar por contraste, layout e hierarquia.

Problema: estados de ação, placeholders e foco tinham legibilidade inconsistente.

Hipótese: tokens de hover e foco global corrigiriam os principais riscos sem redesign.

Orientação: manter a paleta e atingir contraste mais seguro nos controles.

Resultado: novos tokens de hover, placeholders mais legíveis e foco visível.

Evidência: os casos mais graves de texto escuro sobre verde desapareceram.

Decisão: preservar a composição e deixar o estado Bootstrap residual para investigação posterior.

Problema: todas as seções tinham peso espacial parecido.

Hipótese: projetos e contato deveriam ser picos da leitura; hobbies e viagens, apoio.

Orientação: manter ordem do conteúdo, navegação e responsividade.

Resultado: mais respiro em projetos/contato, compactação de apoio e cards mais confortáveis.

Evidência: detector sem novos alertas estruturais.

Decisão: manter a hierarquia e separar o formulário para outro ciclo.

Problema: títulos, corpo e metadados tinham diferença insuficiente.

Hipótese: uma escala tipográfica curta criaria voz sem trocar a fonte.

Orientação: preservar Inter, navy/verde e medidas responsivas.

Resultado: display responsivo, cargo com tracking, cards e meta diferenciados.

Evidência: alertas de all-caps-body e wide-tracking eliminados.

Decisão: manter Inter por consistência nesta versão.

Problema: o portfólio ainda se aproximava de templates comuns.

Hipótese: um único gesto composicional forte seria mais memorável que vários efeitos.

Orientação: destacar hero e primeiro projeto sem exagero.

Resultado: moldura fina rotacionada no hero e assimetria editorial no primeiro projeto.

Evidência: o detector rejeitou a borda superior excessiva, que foi removida.

Decisão: manter apenas a moldura e o deslocamento sutil.

Problema: glow, estilos inline, cor isolada e barras laterais criavam ruído de template.

Hipótese: tokens compartilhados e elevação neutra deixariam o sistema mais maduro.

Orientação: não adicionar ornamentos; limpar a implementação atual.

Resultado: estilos inline removidos, sombras normalizadas, barras laterais retiradas e ícones centralizados.

Evidência: busca sem style inline, #eab308 ou border-left de 3px.

Decisão: encerrar o polimento antes da nova crítica.

Problema: era necessário comprovar se a v2 realmente melhorou.

Hipótese: uma nova avaliação mostraria ganhos e pendências sem depender de impressão.

Orientação: comparar com a crítica de 22/32 e considerar todas as páginas.

Resultado: pontuação de 24/32.

Evidência: side-tab, dark-glow e border-accent-on-rounded desapareceram.

Decisão: priorizar agora fluxo administrativo, formulário ou contraste Bootstrap.

Problema: era necessário avaliar tecnicamente a página de registros após o ciclo da v2 e antes do novo commit.

Hipótese: um audit com o detector mecânico separaria pendências reais de falsos positivos herdados do Bootstrap.

Orientação: cobrir acessibilidade, performance, theming, responsividade e integridade sem corrigir nesta passada.

Resultado: score de 16/20 (Good), com contraste, landmarks, responsividade e tokens aprovados nas cinco dimensões.

Evidência: o único achado do detector foi o hover de 2.5:1 (branco sobre #10b981), verificado como herança do Bootstrap sem botões nesta página.

Decisão: registrar o audit e isolar o contraste de hover do Bootstrap como pendência explícita do próximo ciclo.