Code Reality · Amostra pública · não é o livro completo
O que existe de verdade no código / What actually exists in the code

CODE
REALITY

A IA não matou o código. Ela tirou o peso de gerar.

Gerar código ficou fácil. Decidir o que merece sobreviver ficou caro.

Uma amostra pública controlada do livro bilíngue sobre Code Review, Reality Check e governança em projetos AI-first.

Public sample · controlled excerpt
Pergunta central

O que existe de verdade no código?

Não o que a landing page promete. Não o que o README descreve. Não o que o agente disse que implementou. O que existe.

O método

Quatro realidades, duas extensões operacionais e uma camada de decisão.

  1. Code Reality
  2. Flow Reality
  3. Memory Reality
  4. Promise vs Reality
  5. Secrets Reality
  6. Graph Reality
  7. Nex

Sumário / Contents

Parte I · A ilusão e o novo papel

  1. Introdução / Introduction
  2. O código que parece produto / Code That Looks Like a Product
  3. O colapso do code review tradicional
  4. O engenheiro como garantidor

Parte II · As realidades do sistema

  1. Code Reality
  2. Flow Reality
  3. Memory Reality
  4. Secrets Reality
  5. Graph Reality

Parte III · Decisão, governança e aplicação

  1. Nex
  2. Agentes revisando agentes
  3. Protocolos de revisão
  4. Promise vs Reality
  5. Field Kit
  6. Fechamento

Apêndices · Autópsias e Case Files

  1. Apêndice A · Autópsia da Sintaxe
  2. Apêndice B · Code Reality Case Files
Sample 1 · Capítulo 4 · Code Reality

Escrito não é existente

Um arquivo pode existir no repositório e ainda não existir no produto. Um componente pode estar bem escrito e nunca ser renderizado. Uma rota pode estar declarada e nunca ser alcançada. Um provider pode estar configurado e nunca ser usado. Um endpoint pode responder em ambiente local e não participar do fluxo real. Um teste pode existir e ainda não proteger nada importante.

O erro comum é tratar presença como prova.

Presença é só inventário.

Realidade exige participação.

Código participa quando tem relação verificável com algum fluxo real: é chamado, renderizado, alcançado, recebe dados, transforma estado, entrega consequência, trata erro, sustenta uma promessa, protege uma regra ou remove uma ambiguidade.

Se nada disso acontece, talvez ele seja útil um dia. Talvez seja uma ideia. Talvez seja um rascunho. Talvez seja resíduo. Talvez seja decoração. Mas não é, ainda, realidade operacional.

Sample 2 · Capítulo 5 · Flow Reality

O caminho feliz não basta

Muitos produtos parecem funcionar porque alguém testou o caminho feliz.

O caminho feliz é simples: usuário correto, dado correto, ambiente correto, conexão correta, chave correta, resposta correta, expectativa correta.

Mas produto real vive fora desse conforto.

O usuário erra. O navegador recarrega. O pagamento demora. O e-mail cai no spam. O campo vem vazio. A chave expira. A integração responde tarde. O endpoint falha. O usuário não entende se acabou. O admin não recebe nada. O founder acha que está funcionando porque uma vez funcionou.

Um sistema que só funciona no caminho feliz ainda não foi revisado. Ele foi demonstrado.

Field Kit preview

Code Reality Check

Use quando uma feature, arquivo, rota, componente, provider, integração ou teste parece existir, mas você precisa confirmar se aquilo participa do produto real.

What actually exists in the code?

  1. Escolha uma promessa ou feature.
  2. Encontre onde ela aparece publicamente.
  3. Encontre o caminho correspondente no código.
  4. Confirme se cria consequência.
  5. Classifique o estado.
  6. Decida o que fazer.

Esta amostra não é o livro completo.

Code Reality não vende apenas um arquivo. Ele entrega um método para revisar realidade em software AI-first.

A IA gera. O Nex decide. Você responde.

Edição completa: 583 páginas, 14 capítulos, dois apêndices, glossário bilíngue com 62 termos e 372 definições, PDF, EPUB e Field Kit com 33 arquivos controlados.

Cópia licenciada individual com licença nominal, watermark e caminho de atualização. Leitor protegido online: evolução futura.