Claude Code Harness Lite: uma base pequena para mudanças seguras

O primeiro erro ao usar Claude Code em um repositório real raramente é só um prompt ruim. É deixar o agente tocar coisas demais antes de existir um marco. Harness Lite é esse marco mínimo: ler, editar, provar, abrir a URL pública e revisar o CTA de receita.

Esta é a versão inicial de Claude Code harness engineering. Em um repositório desconhecido, combine com repo map first pass e permission receipt pattern para manter o escopo explicável.

Escreva o limite antes da tarefa

Harness Lite não deixa Claude Code mais fraco. Ele deixa a mudança explicável. Antes da edição, defina quais arquivos ler, quais arquivos editar, quais áreas excluir, qual comando prova o resultado e qual página pública verificar depois.

Em site de conteúdo ou produto, essa ordem importa. Artigo, formulário de PDF grátis, link Gumroad e consulta costumam estar próximos. Uma pequena alteração de texto pode quebrar o caminho entre busca, cadastro, compra e contato.

harness_lite:
  owner: "Masa"
  scope:
    allowed:
      - "read repository"
      - "edit selected files"
      - "run build or test"
    blocked:
      - "delete unrelated files"
      - "touch secrets"
      - "hide failed verification"
  proof:
    - "git diff reviewed"
    - "build command recorded"
    - "public URL opened"
    - "CTA path checked"

Prompt inicial copiável

Quero fazer exatamente uma mudança pequena e segura neste repositório.
Ainda não edite arquivos.
Retorne:
1. arquivos que precisa ler
2. arquivos seguros para editar
3. áreas fora do escopo
4. menor comando de prova
5. checks de URL pública para h1, canonical, hero image e CTA
6. notas para preservar PDF grátis, Gumroad e consulta

O ponto central é pedir limite, não implementação. Quando o limite estiver claro, o próximo pedido pode ser estreito: uma mudança, um comando de prova e um recibo.

Transforme a prova em objeto pequeno

Depois da mudança, peça a Claude Code para preencher um proof receipt. O JavaScript abaixo é simples de propósito: torna visível a definição mínima de pronto antes do commit.

const proof = {
  goal: "change one small thing",
  filesChanged: 2,
  commands: ["npm run build"],
  publicUrlChecked: true,
  ctaChecked: true,
};

export function isReadyToCommit(receipt) {
  return receipt.filesChanged <= 3 &&
    receipt.commands.length > 0 &&
    receipt.publicUrlChecked &&
    receipt.ctaChecked;
}

console.log(isReadyToCommit(proof)); // true significa que passou o portão mínimo de commit

Isso revela estados pela metade: build aprovado sem URL pública, página com 200 OK mas artigo errado, corpo correto com CTA de Gumroad ou consulta apontando para o destino errado.

Três casos reais

• Em artigo Astro, limite o escopo a um MDX, uma imagem hero e uma página de produto relacionada. Depois do deploy revise h1, início do texto, canonical, formulário PDF, botão Gumroad e link de consulta.
• Em correção React pequena, mantenha componente alvo, teste próximo e screenshot ou Storybook. Auth, billing, secrets e migrations ficam fora da primeira passagem.
• Em adoção de equipe, registre em CLAUDE.md comandos seguros, áreas protegidas, formato de recibo e nota de rollback. A próxima pessoa não recomeça do zero.

Falhas comuns

A falha comum é começar com “verifique e corrija tudo”. Claude Code ajuda de forma ampla, o diff cresce e a prova fica vaga. Outra falha é tratar build local como publicação. Uma rota pública pode devolver HTTP 200 e ainda mostrar fallback ou artigo antigo.

A rota de receita também quebra. O corpo recomenda PDF grátis, mas o CTA final leva a outro produto. O artigo multilíngue não explica que Gumroad hoje é principalmente o caminho em inglês. Existe link de consulta, mas o texto não diz quando uma chamada vale mais que um guia. Harness Lite coloca esses checks dentro da tarefa.

PDF grátis, Gumroad e consulta

Use o free cheatsheet se ainda está aprendendo comandos e hábitos seguros. Use 50 Prompt Templates se repete prompts de review, debug e refactor. Use o Setup Guide se permissões, CLAUDE.md, hooks, MCP ou CI/CD bloqueiam. Use consultoria quando workflow, equipe ou receita exigirem decisão.

O que foi verificado neste artigo

Este artigo inclui objeto de prova executável, links internos para harness, repo map e permission receipt, além da rota PDF grátis, Gumroad e consulta. Os próximos números são inícios de PDF, cliques Gumroad e visitas à consulta deste slug.

Nota operacional depois da publicação

Em produção, não pare em “o arquivo existe”. O trabalho termina quando a URL pública permite que o leitor escolha o próximo passo. Em largura mobile, revise h1, início do corpo, hero image, formulário PDF grátis, links Gumroad e consulta. Se o corpo está certo mas o CTA final aponta para produto errado, a rota de receita ainda está incompleta.

Em artigos localizados, slug igual não basta. Verifique início do corpo e CTA em japonês, inglês, chinês, coreano, espanhol, francês, alemão, português, hindi e indonésio. Título traduzido com corpo ou CTA em inglês é localização falha, porque o leitor não confia no próximo passo.

Na próxima melhoria, olhe além de PV. Coloque no mesmo brief inícios de signup PDF, cliques Gumroad, visitas Products, visitas Training, países e fonte de busca. Claude Code decide melhor quando a métrica mostra se deve reforçar o ativo grátis, Prompt Templates, Setup Guide ou consultoria.