Pular para conteúdo

Harness — como o time trabalha

O harness é a máquina de agentes, loops, réguas e memória que faz uma ideia ou um erro virar código em produção com o mínimo de toque humano — e com rede de segurança em cada passo. Esta área é meta (como o time trabalha), separada do wiki de produto (funcionalidades/, conceitos/, contextos/). A fonte completa e hand-authored continua em docs/harness/*.md — estas páginas são uma re-expressão enxuta, no formato do wiki.

Os dois loops

  • engenharia-regenerativa — loop de issues: um comitê de agentes vigia produção e o backlog sozinho, groma o que aparece e entrega em Deep Search pra aprovação humana. Autônomo até o ponto de não-retorno.
  • loop-engineering — a teoria (princípios P1–P8) por trás dos loops, e o loop de novos projetos (to-project), interativo, com humano junto.

O que dá liga

  • comite-de-agentes — o catálogo dos scouts, o attention-gate e os dois guardians (pr-guardian/prod-guardian).
  • skills — o catálogo das skills do repo, o que cada uma faz e de quem depende.
  • reguas-modelo-effort — qual modelo Claude (Opus/Sonnet/Haiku) e quanto esforço roda cada coisa.
  • codebase-grafo — o knowledge graph do código (gerado pelo graphify, consultado pelo codebase).
  • mem0 — a camada de memória semântica entre sessões.
  • testsprite — a cobertura e2e: dev gera, a Action roda, o Guardian lê.
  • impeccable — o design system no código, fonte única de UI.
  • onboarding — o setup de um dev novo: o que o git clone não te dá.

Visão de conjunto

Ver visao-geral para o mapa completo (o "comece por aqui" do harness).

Por onde começar

  1. Ligar a máquina → onboarding.
  2. Entender a filosofia → loop-engineering (P1–P8).
  3. Ver o loop rodando na prática → engenharia-regenerativa.
  4. Consultar quem faz o quê → comite-de-agentes (agentes) e skills (skills).