Um comando determinístico mede o harness de código com IA — funciona com Cursor, Claude Code, Windsurf e outras ferramentas. Escaneia AGENTS.md, rules, hooks, testes, CI. Sem IA no scan. Sem rede. Mesma pontuação sempre.
O problema
Dois repositórios podem usar o mesmo modelo e ter resultados muito diferentes. Um tem guias que orientam o agente, sensores que verificam o trabalho e guardrails que evitam danos — o outro não tem nada disso. O Harness Score mede esse harness em segundos, em qualquer ferramenta de IA, e mostra o que corrigir em seguida.
Como funciona
Execute npx harness-score no repositório. A CLI lê o filesystem — 36 checks, zero chamadas a LLM, zero rede.
Receba um nível de maturidade L0–L4, a pontuação em 108 pontos em seis dimensões e exatamente o que falta para o próximo nível.
Cada check que falha aponta para uma receita de remediação no guia — ou use o comando /harness-audit do plugin para aplicar as correções.
Exemplo de saída
Determinístico: mesmo commit, mesma pontuação — no seu laptop ou no CI. Bloqueie merges com --min-level 3 para a maturidade só subir.
Executar o scanner → harness-score v1.0.0 ~/my-app
Maturity: L2 · Guided Score: 70/108 (65%)
Detected: Cursor, Claude Code
Context & Guides ████████████████░░░░ 80%
Skills & Commands █████████████░░░░░░░ 65%
Hooks & Guardrails ░░░░░░░░░░░░░░░░░░░░ 0%
Sensors & Feedback ████████████████░░░░ 80%
CI Feedback ██████████████░░░░░░ 71%
Hygiene & Safety ███████████████░░░░░ 74%
To reach L3: sensors ≥ 60%; ci ≥ 50%Começar
npx harness-scoreSem instalar. Aponte para qualquer repositório.npm i -g harness-scorev1.2.0 no npmjs.org/harness-auditNo repositório — Marketplace ainda não publicadopaladini/harness-score/actionGate de CI + badge no READMEnpx jsr add @paladini/harness-scoreUsuários Deno e BunEscada de maturidade
Os níveis dependem da forma do harness — não só da pontuação. Oitenta pontos de documentação sem testes é L1, não L3.
L0 · Sem harnessRecomeça do zero a cada sessão
L1 · DocumentadoAGENTS.md orienta o agente
L2 · OrientadoRules, skills, higiene
L3 · Com sensoresTestes, tipos e CI verificam
L4 · AutocorretivoHooks fecham o loopFunciona com
Um harness, um modelo de maturidade, várias ferramentas. Configure Cursor, Claude Code, Windsurf ou outra — o Harness Score mede todas da mesma forma.
Mostre sua pontuação
Pílula 112×20 para fileiras de shields. O CI regenera, ou fixe um badge-lN.svg estático. Copie embeds em Markdown, HTML, iframe e JSX.
O que este repositório entrega
8 capítulos sobre engenharia de harness para agentes de código — feedforward, sensores, guardrails.
harness-score — saída JSON, markdown e badge. Zero deps em runtime.
Comando /harness-audit + skill para corrigir cada gap encontrado.
Escaneia a cada push, emite o badge, falha abaixo de --min-level.