O que é a Yuhoo

A Yuhoo é uma fábrica de software local-first com agentes de IA. Você descreve em linguagem natural o que quer; a Yuhoo decompõe o pedido em objetivos e peças pequenas e passa cada peça pelo Gauntlet Loop — builder, QA, crítico e validador —, em que quem constrói nunca aprova o próprio trabalho.

Tudo é observável em tempo real: quem está com a peça, o veredito de cada revisor, o motivo de cada devolução e quanto cada passo custou. Ela trabalha sobre os repositórios reais dos seus projetos, inclusive os que já existem, e mede os próprios gargalos: observa onde os agentes tropeçam, sugere melhorias, versiona os agentes e testa versões novas em paralelo — só troca quando você aprova.

Nada aqui é simulação — os agentes rodam de verdade, e cada execução gasta uso da sua conta.

Como funciona o Gauntlet Loop

É o método da Yuhoo pra construir uma peça: quatro papéis diferentes, cada um independente, um depois do outro.

Se alguma etapa reprova, a peça volta pro Builder ajustar e recomeça — isso é uma rodada ("round"). O limite padrão é 5 rodadas. Quando passa nas quatro, a peça fica aprovada.

A Yuhoo também roda três "meta-loops" sobre si mesma: observar (achar padrões na própria performance), diagnosticar (a causa provável de um padrão) e comparar versões de agente antes de trocar. Isso tudo vive na Saúde da Yuhoo.

Guias por tarefa

Glossário

Artefatos do projeto

Os arquivos que os agentes produziram no projeto selecionado — relatórios, specs, docs — agrupados por tipo. Clique em "abrir" pra ver o conteúdo.

Para desenvolvedores

Este repositório é a Yuhoo Platform. Node ≥ 20; npm install compila o better-sqlite3 (build nativo).

Subir

npm start                          # gera o painel + servidor + auto-migrate + auto-seed (porta 4317)

Abra http://localhost:4317/ — o próprio servidor serve o painel. A forma antiga (cd design-reference && python3 -m http.server 8899 e http://localhost:8899/painel-agentes-v2.html) continua funcionando. Num servidor, com HTTPS e Nginx: docs/servidor.md.

Autorizar um projeto novo

Por segurança (§40), a Yuhoo só aceita projetos cuja pasta está numa allowlist: o array project_registry em .gauntlet/config.json. O botão "＋ Novo projeto" e o form de onboarding falham com 403 se a pasta não estiver lá (nem numa subpasta de uma pasta listada).

Para liberar uma pasta, adicione uma entrada e reinicie o npm start:

// .gauntlet/config.json
{
  "project_registry": [
    { "id": "meu-projeto", "name": "Meu Projeto", "path": "/Users/voce/projetos/meu-projeto" }
  ]
}

Depois disso o form de "＋ Novo projeto" grava a linha no banco (POST /api/projects). O path precisa existir no disco e ser absoluto.

Comandos

Como o Gauntlet Loop roda

server/orchestrator/ é a autoridade do fluxo. POST /api/runs {piece_id} (ou o botão ▶ Rodar Gauntlet, ou npm run gauntlet:run) dispara builder → QA → critic → validator, gerencia as tabelas via server/domain/ e persiste cada transição no Event Store. Só existe uma state machine: server/domain/stateMachine.js.

O slash command /gauntlet coexiste como a forma interativa via subagentes — não alimenta o painel (sem estado persistido).

Telemetria

.claude/settings.json liga os hooks do Claude Code ao pipeline de eventos via .claude/hooks/emit-event.js. Sem o servidor no ar, os hooks falham em silêncio — o Claude Code funciona normalmente, só não há telemetria.

Onde olhar

• server/README.md — servidor + DB/migrations
• server/api/README.md — o Control Plane HTTP sob /api/ (rotas, filtros, enums, erros)
• server/domain/README.md — modelo de domínio e repositórios
• server/orchestrator/README.md — runner do Gauntlet Loop
• docs/decisions.md — decisões de arquitetura
• .claude/PROJECT.md — a spec · .claude/ARCHITECTURE.md — o estado atual

Limitações conhecidas

• Sem loop de aprovação do cliente; sem publicação automática ("Entregue" é rótulo).
• Estatísticas de sessão não persistem — só o histórico de Entregas é salvo.
• Sem autenticação nas rotas de escrita — seguro em localhost; precisaria de auth se exposto pra fora da máquina.