Harness Score
01 / 11
GitHub

Harness engineering, sem mistério

Não é só o modelo.
É o sistema ao redor dele.

Uma conversa visual sobre como transformar um agente de IA talentoso em um colaborador previsível.

Começar a conversa ↓ ↓ ou Space para avançar

A pergunta de abertura: você confiaria num ótimo piloto sem instrumentos?

A ideia em 30 segundos

Um piloto excelente ainda precisa de uma cabine.

01

Manual de voo

O agente entende o projeto antes de tocar no código.

AGENTS.md
02

Instrumentos

Ele enxerga rápido quando algo saiu do esperado.

testes · lint · types
03

Caixa-preta

Cada mudança é verificada de novo, fora da conversa.

CI
04

Travas físicas

Ações perigosas podem ser bloqueadas de verdade.

hooks

O mecanismo

Orientar antes. Verificar depois. Proteger sempre.

Antes

Feedforward

Regras, contexto e exemplos reduzem tentativas no escuro.

Durante

Ação

O agente planeja, edita e executa dentro do projeto.

Guardrails

O limite que continua valendo mesmo quando o modelo erra.

O objetivo não é eliminar erros. É encurtar a distância entre errar, perceber e corrigir.

A escala de maturidade

Cinco níveis. Uma evolução observável.

L3

Sensing

Testes, linter, checagem de tipos e CI permitem que o agente comprove a própria mudança com ferramentas determinísticas.

Para chegar aqui Sensors ≥ 60% CI ≥ 50%

O que entra na conta

Seis linhas formam o mapa do harness.

A peça de maior retorno

Um bom AGENTS.md responde quatro perguntas.

  1. 01
    O que é?

    Propósito e fronteiras do projeto.

  2. 02
    Como executar?

    Build, teste, lint e desenvolvimento.

  3. 03
    Como está organizado?

    Arquitetura e caminhos importantes.

  4. 04
    O que não fazer?

    Restrições e decisões irreversíveis.

AGENTS.md
# Projeto
Site estático da palestra.

# Verificação
npm run check
npm run scan:gate

# Regras
- Preserve a ordem dos slides.
- Não adicione dependência de runtime.
- Explique termos antes de usá-los.

Escreva para reduzir descoberta, não para documentar o óbvio.

Progressive disclosure

Contexto certo, na hora certa.

REGRA

Scoped rules

Carregam instruções apenas quando o agente toca em arquivos relacionados.

.cursor/rules/slides.mdc

Quando: ao editar HTML, CSS ou JS

SKILL + AGENT

Procedimento e especialista

Empacota uma sequência reutilizável ou delega uma revisão com foco específico.

.agents/skills/rehearse-demo/

Exemplo: talk-reviewer revisa clareza e fatos

COMANDO

Atalho intencional

Expõe um workflow que a pessoa decide iniciar explicitamente.

.cursor/commands/rehearse.md

Quando: sob demanda

Contexto global
Use pouco.

O restante entra por escopo ou por demanda.

Feedback determinístico

Se o agente pode rodar, ele pode aprender.

npm run check sinais do projeto
T
Testeso comportamento continua correto?
PASS
L
Lintero código segue padrões seguros?
PASS
τ
Tiposas peças ainda se encaixam?
PASS
B
Buildo artefato final ainda nasce?
PASS
Rápido para rodar sempre Objetivo para não negociar fatos Acionável para indicar a correção

A fronteira L3 → L4

Uma regra pede. Um hook impõe.

REGRA · probabilística
“Nunca execute um comando destrutivo.”

O modelo precisa lembrar, interpretar e obedecer.

provavelmente
GATE HOOK · determinístico
git push --force BLOCKED

A máquina intercepta a ação antes da execução.

sempre
←Gate hook bloqueia antes Feedback hook verifica depois→

Agora, no terminal

Um comando. Evidência em segundos.

harness-score-live-demo

$ npm run scan

L3
Sensingrepository maturity
  1. 1
    Escaneie

    Mostre as seis dimensões e as evidências por arquivo.

  2. 2
    Abra o AGENTS.md

    Conecte a pontuação a um artefato legível.

  3. 3
    Mostre a falha de hooks

    Explique por que o resultado é L3, não L4.

  4. 4
    Acione o gate

    npm run scan:gate protege o nível mínimo no CI.

Três ideias para levar

Menos magia.
Mais sistema.

  1. 01

    O modelo é só uma parte do desempenho.

  2. 02

    Contexto orienta; sensores ensinam; guardrails protegem.

  3. 03

    Maturidade é o que o repositório consegue provar.

Comece pelo arquivo de maior retorno.

AGENTS.md Explorar o Harness Score ↗

Visão geral

A palestra em 11 quadros

    Esc fecha · clique em um quadro para navegar

    Comando copiado.