Spec define o que construir. Harness define como construir. Regras de código, hooks de validação, feedback loops e guardrails projetados sob medida pra cada projeto. O sistema fica mais afinado a cada sprint, sem você gerenciar esse ganho.
Specifications resolvem ambiguidade na intenção. Não resolvem desvio na execução. Sem guardrails ativos, agente pode gerar código tecnicamente plausível que ainda assim foge da convenção, viola contratos ou ignora regra de compliance.
O resultado: revisão humana vira inspeção minuciosa em vez de validação de alto nível. O sênior gasta tempo pegando lixo que poderia ter sido bloqueado em runtime, e a velocidade da squad cai pra ritmo de revisão manual.
Harness Engineering inverte: o ambiente bloqueia desvio antes do humano olhar. Sênior valida decisão, não detalhe. Velocidade preservada, qualidade enforçada.
Lint, formato, convenções, naming. Configuradas no repositório, aplicadas em pre-commit. Padronizam saída independente do agente que gerou.
Verificam aderência à spec, contratos de API, cobertura mínima, presença de documentação, comportamento em casos de borda. Falha bloqueia merge.
Erros, logs e métricas voltam para o agente. A próxima iteração incorpora o aprendizado sem intervenção humana. O sistema se calibra.
O harness é tratado como código: PR, review, testes. Cada sprint deixa a próxima mais rápida. Aprendizado fica enraizado.
# amazing harness · projeto banco # versão 3.4 · evoluído por 11 sprints code_rules: naming: snake_case max_line_length: 100 imports: absolute, agrupados spec_hooks: contract_match: on_pr: block_if_diverges tolerance: strict test_coverage: minimum: 90 on_fail: block_merge audit_trail: required: true retention: 7y feedback_loops: flaky_tests: retry_3x_then_alert slow_endpoints: profile_and_report drift_from_spec: create_issue evolution: sprint_review: add_pattern_if_repeats incident_review: add_hook_if_systemic
O harness é o que faz IA escalar com qualidade consistente. Cada sprint deixa a squad mais rápida, sem comprometer aderência à spec ou ao contrato.
PRs que passam aderem à spec por design. Divergência é exceção.
Sênior gasta menos tempo em detalhe, mais em decisão de alto nível.
Hooks pegam classes inteiras de bug antes do código sair do PR.
Cada sprint deixa a próxima mais barata em esforço de revisão.
Lint é regra genérica. Harness Amazing é projetado pro seu projeto, evolui com ele e fica como propriedade do cliente quando o contrato encerra.
O harness do banco não é o harness da fintech. Cada um reflete regras de negócio, compliance e arquitetura específicos.
Pattern detectado vira regra. Erro recorrente vira hook. O sistema aprende com a operação real do projeto.
Vive no repositório, cresce com PR e review. No fim do contrato, o harness fica com você como qualquer outro código.
No Pix Automático, hooks de compliance bloquearam 17 tentativas de merge que divergiriam da norma BACEN. Auditoria fechou sem ponto aberto.
Ver o caso completoEm 30 minutos a gente desenha o esqueleto do harness Amazing pra sua stack. Você sai com a base pra implementar, mesmo que não feche contrato.
