HARNESS
O system prompt que evolui
A IA não erra porque é burra. Ela erra porque está cega: vê o fragmento que você colou e nada além dele. O problema não é inteligência. É ausência de contexto — e contexto se constrói.
PDF · 102 páginas · 10 capítulos · R$ 9,90
São três da tarde de uma terça.
Um endpoint começou a devolver 500 em produção. Você copia o stack trace, cola na IA, pede a correção. Em quarenta segundos vem uma resposta limpa, bem escrita, com tratamento de erro e tudo. Você aplica, testa, sobe. Funciona.
Dois dias depois, o time de mobile abre um chamado: a tela de perfil parou de mostrar a foto padrão. Ninguém mexeu no mobile.
O endpoint quebra sem foto de perfil. O modelo devolve um avatar padrão no lugar do nulo. Tecnicamente impecável.
O app mobile quebra. Ele contava com o nulo para mostrar as iniciais do usuário. Você cola o erro. O modelo corrige.
Aparece um terceiro problema. Você já não tem certeza de qual mudança gerou o quê.
A conclusão que quase todo mundo tira é a mesma: “a IA ainda não serve para manutenção”. Este livro mostra por que essa conclusão está errada — e o que ela está confundindo.
O modelo é o mesmo
dos dois lados.
A diferença é o contexto.
| System Prompt | Harness | |
|---|---|---|
| Quando é escrito | Uma vez | Cresce a cada sprint |
| Do que trata | O que é igual em todo projeto | O que é único neste projeto |
| De onde vem | De quem fez a ferramenta | Do seu time |
| Para que serve | Gerar do zero | Gerar e manter |
| Com o tempo | Envelhece | Melhora |
O system prompt é fixo: escrito uma vez, genérico por design, bom para gerar do zero. O Harness é evolutivo: cresce a cada sprint, captura as decisões do time, é específico do seu projeto e serve para gerar e manter.
As ferramentas que impressionam não usam um modelo melhor que o seu. Usam o mesmo modelo, com alguma coisa na frente do pedido. O livro mostra o que é essa coisa, por que ela não resolve o seu projeto — e o que resolve.
O que o agent pensa,
antes e depois.
- “Não sei como isto está organizado — vou supor.”
- “Vou aplicar o padrão mais comum do mercado.”
- “Não conheço esta parte, então reescrevo do zero.”
- “Terminei. Acho que está certo.”
- “Quebrou? Não faço ideia do porquê.”
- “A estrutura está descrita; sigo ela.”
- “O padrão deste projeto é outro; aplico o daqui.”
- “Isto já existe; evoluo o que está aí.”
- “Terminei, e sei o que precisa ser testado.”
- “Isto depende daquilo — por isso não toquei.”
Não é leitura. É o esqueleto do seu Harness, pronto para colar.
O capítulo 5 entrega os dois artefatos que resolvem a maior parte do problema, com template e prompt prontos. Ao fim dele você tem uma SPEC, um CLAUDE.md e o contexto protegido — no seu projeto, não num exemplo.
Template da SPEC enxuta
O contrato que o agent recebe no lugar de uma intenção.
Entrevista de requisitos
O agent te entrevista. Você não escreve a SPEC na mão.
Template do arquivo de contexto
Stack, estrutura e convenções, com a seção “Nunca fazer”.
CLAUDE.md a partir da SPEC
Gera o arquivo de contexto sem inventar proibição — essa parte é sua.
Bloqueio de leitura
Segredo e ruído ficam fora da janela de contexto.
7 perguntas para a SPEC
Avalie antes de entregar ao agent. Corrigir cedo é barato.
O Harness mínimo em uma tarde
Cinco blocos, em torno de duas horas e meia.
| Bloco | Você faz | Sai | Como verificar |
|---|---|---|---|
| 1 · 45 min | Roda a entrevista de requisitos | SPEC.md | As 7 perguntas, todas com “sim” |
| 2 · 20 min | Gera o arquivo de contexto a partir da SPEC | CLAUDE.md | Sessão nova: “como se trabalha neste projeto?” |
| 3 · 20 min | Escreve o “Nunca fazer” à mão | CLAUDE.md revisado | 5 proibições específicas, nenhuma genérica |
| 4 · 10 min | Configura o bloqueio de leitura | Permissões | Pede para ler o arquivo de variáveis de ambiente. Ele recusa |
| 5 · 45 min | Executa um trabalho real com tudo ligado | — | Compara com a semana passada |
O teste final: abra uma sessão nova, não explique nada e peça uma mudança pequena. Se o agent citar uma decisão do seu projeto sem você ter falado dela, o Harness está de pé.
Dez capítulos. Do porquê ao primeiro passo.
- 01
A IA está cega no seu projeto
Você corrige um bug com IA e dois dias depois algo distante quebra. O defeito não está no modelo — está no processo.
- 02
A IA não pensa, ela prediz
Por que um parágrafo no lugar certo muda mais o resultado do que trocar para um modelo maior. Curto e sem academicismo.
- 03
Harness: o system prompt que evolui
O que as ferramentas que impressionam põem na frente do pedido, por que isso não resolve o seu projeto — e o que resolve.
- 04
O mapa dos artefatos
Nove peças formam um Harness completo. O que cada uma resolve e quando ela entra. O mapa, não o território.
- 05
Seu primeiro Harness
SPEC, CLAUDE.md e contexto protegido, com template e prompt prontos. No seu projeto, não num exemplo.
- 06
O contrato de execução
O agent começou pelo fim, decidiu a arquitetura sozinho e avisou que terminou. O documento que impede isso.
- 07
Quando um agent não basta
Passado certo tamanho, o trabalho vira decompor, delegar e verificar. As quatro peças que tornam isso possível.
- 08
Harness em projeto legado
Dez anos, mil arquivos, nenhum teste. O cenário em que a IA mais falha — e o que mais muda quando o contexto existe.
- 09
O Harness mínimo em uma tarde
Cinco blocos, com o que fazer, o que sai e como verificar. A página para imprimir e deixar do lado do teclado.
- 10
Até onde este livro vai
O que você tem agora, o que ficou de fora de propósito — e por que isso não é o mesmo que “o que faltou”.
“As demonstrações que impressionam não usam um modelo melhor que o seu. Elas usam o mesmo modelo, com um contexto muito melhor na frente. Esse contexto é um ativo — construído, versionado, mantido. Ele tem nome, tem formato e pode ser copiado.”
— Adriano Santos
Sendo honesto dos dois lados,
porque isso poupa o seu tempo.
É para você se…
- ▸ você programa, em qualquer linguagem;
- ▸ a IA funciona bem para gerar código novo e mal para mexer no que já existe;
- ▸ cada correção que ela faz quebra alguma coisa longe dali;
- ▸ você explica o mesmo projeto do zero a cada sessão;
- ▸ você mantém um sistema legado e quer operar com bisturi, não com trator.
Não é para você se…
- ▸ você não programa. O livro é técnico do começo ao fim, e eu prefiro dizer isso agora;
- ▸ você procura a ferramenta mágica que dispensa método. Ela não existe — e o livro inteiro é sobre por quê;
- ▸ você quer promessa de produtividade. Aqui não tem: tem argumento técnico e o primeiro passo pronto;
- ▸ você espera a operação completa de múltiplos agents num livro de entrada.
Cinco vezes, ao longo do livro, eu escrevi a mesma frase: isto não cabe aqui.
Ele cobre o conceito inteiro e entrega a base executável. Não cobre a operação completa — e não por falta de espaço.
Não é volume de texto, é ordem de execução com ponto de verificação. Cada peça pressupõe a anterior funcionando no seu projeto — não lida, funcionando. Ler sobre isso é como aprender a dirigir lendo: você entende tudo e trava na primeira ladeira.
Ficou de fora, de propósito:
- Execução
- o plano completo, com fases, dependências reais e teste de contrato.
- Orquestração
- o arquivo de um agent por dentro, o script de hook que bloqueia de verdade, um agent despachando trabalho e outro revisando em contexto isolado.
- Escala do contexto
- rules por módulo e skills que o agent realmente encontra.
- Memória
- o que foi aprendido numa sessão chegando sozinho na seguinte.
- Legado a fundo
- a sequência completa para entrar num sistema antigo sem quebrar o que funciona.
Desenvolvimento Acelerado com IA
O livro é o mapa. A imersão é o território: dois dias construindo do zero um sistema completo — um gerenciador de projetos, com quadros, tasks, sprints e fluxo de status — enquanto o Harness é montado em cima dele, peça por peça, na ordem em que cada uma passa a fazer sentido.
Você constrói o seu em paralelo, no seu projeto, com a sua stack. Qualquer linguagem, qualquer ferramenta de IA. O pré-requisito é um só: saber programar.
- 27 e 28 de novembro · sexta e sábado, das 9h às 17h
- 16 horas ao vivo, online
- Material da 1ª edição liberado no momento da compra
- Grupo fechado por 30 dias depois do treinamento
- R$ 399, em até 12x · garantia de 7 dias
E se a resposta for não, tudo bem mesmo. O capítulo 9 resolve a maior parte do problema sozinho. Este livro não foi escrito para ser um folheto: foi escrito para funcionar mesmo que você nunca compre nada meu.
Por que eu escrevi este livro
“Vi bons desenvolvedores desistirem da IA por um motivo errado. Concluíram que a ferramenta não servia para o trabalho deles quando, na verdade, faltava contexto. Este livro é a resposta mais curta que eu consegui dar para essa conclusão apressada.”
Adriano Santos
- ▸ Programa há mais de vinte anos, profissionalmente — e continua programando.
- ▸ Pós-graduação em Inteligência Artificial e Negócios na PUC-Campinas.
- ▸ Levou treinamento de desenvolvimento assistido por IA a mais de dez empresas brasileiras.
Harness
O system prompt que evolui
- ✓ 102 páginas em formato de livro, 10 capítulos
- ✓ Templates de SPEC e CLAUDE.md prontos para copiar
- ✓ Prompts de entrevista de requisitos e de geração do contexto
- ✓ Bloco de permissões e checklist de 7 perguntas
- ✓ Roteiro do Harness mínimo em uma tarde
Pagamento pela Hotmart · PDF liberado por e-mail logo após a confirmação
Garantia de 7 dias
Leia, aplique no seu projeto. Se não fizer sentido nos primeiros 7 dias, peça reembolso direto na Hotmart.
Antes de comprar
O modelo é o mesmo dos dois lados.
A diferença é o contexto —
e ele se constrói.
Comprar o eBook →
PDF · 102 páginas · R$ 9,90
Depois de ler, fecha o livro e vai escrever o seu CLAUDE.md.
É onde isso tudo começa a valer alguma coisa.