Visão geral do harness

O que é

O harness da Menos Juros é a máquina de agentes, loops, réguas e memória que transforma uma ideia ou um erro em código em produção com o mínimo de toque humano, mantendo rede de segurança em cada passo.

Dois loops, um mesmo fim

Dois loops movem o trabalho e convergem no mesmo destino (dev → review → PR → merge):

• 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 de novos projetos (to-project, dentro de loop-engineering) — quando um humano puxa uma iniciativa grande: co-cria → PRD → fatia em issues. Interativo, com humano junto.

O que dá liga em volta

• comite-de-agentes — scouts autônomos (ci-scout, ux-scout, backlog-scout, tech-debt-scout, release-scout, deep-search) que não notificam direto: tudo passa pelo attention-gate (o filtro único contra o alert-fatigue). No PR, dois guardians: pr-guardian (juiz de merge, pré-merge) e prod-guardian (cartógrafo do que subiu, pós-merge).
• As 4 réguas de decisão — priorize (o que atacar 1º), estimate (quão grande), criticidade (se quebrar é incidente?) e reguas-modelo-effort (qual modelo Claude e quanto esforço). Objetivas, reusadas por todo o sistema.
• 3 camadas de memória — file-memory (fatos curados do projeto), mem0 (decisões/preferências, semântica, entre sessões) e o knowledge graph (codebase-grafo, a estrutura do código). Não competem — cada uma guarda uma coisa.
• Fluxo de design — o design system vive no código, mantido pelo impeccable (DESIGN.md/PRODUCT.md + shadcn MCP), e é nele que o to-build ancora a UI. Pra prototipar numa tela antes (opcional, sob demanda) tem o Claude Design (via /design-sync).
• Qualidade e docs no automático — testsprite (e2e) no fluxo crítico, e o prod-guardian mantendo grafo, wiki e READMEs em dia no merge.

A ideia de fundo (P1–P8 em loop-engineering): o prompt é commodity; o loop é o diferencial — todo agente tem objetivo verificável, limites, sensor, memória e um gate humano onde a ação não tem Ctrl+Z.

O mapa dos docs-fonte

Doc-fonte	Página do wiki
onboarding.md	onboarding — setup de um dev novo
loop-engineering.md	loop-engineering — teoria (P1–P8) + loop de novos projetos
regenerative-loop.md	engenharia-regenerativa — o loop de issues na prática
committee-agents.md	comite-de-agentes — catálogo dos agentes
skills-catalog.md	skills — catálogo das skills
modelos.md	reguas-modelo-effort — a 4ª régua
codebase.md	codebase-grafo — knowledge graph
mem0.md	mem0 — memória persistente
testsprite.md	testsprite — cobertura e2e
impeccable.md	impeccable — design system

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).

Relacionado

index (landing da área harness)