Documentado 14/04/2026 fim sessão noturna. Visão completa do que Harry deve se tornar, a ordem de execução e os pontos de liberação.

🎯 Visão central

Harrison (Harry) é o chefe de uma crew de agents especialistas. Bruno chama Harry, Harry delega, executa, documenta, audita, e entrega. Mas o diferencial é que Harry aprende com cada missão. Ele não nasce sabendo tudo — ele ganha competências, skills e conhecimento conforme trabalha.

Princípios fundamentais:

1. Harry pesquisa antes de reinventar. Feature nova? Ele primeiro avalia se existe pacote open source maduro, licença permissiva, manutenção ativa. Decide: usar ou fazer do zero, com justificativa documentada.
2. Harry pergunta quando não sabe. Sem contexto suficiente? Ele para e pergunta pro Bruno. Não adivinha, não implementa com suposição.
3. Harry documenta tudo. Cada missão gera: arquitetura, ADRs, fluxos, diagramas, skills aprendidas. Tudo registrado. Nada some.
4. Harry evolui continuamente. Skills acumuladas viram base de conhecimento reutilizável. Próxima vez que precisa de API, ele já sabe — porque aprendeu da última vez.
5. Harry pode rodar autônomo quando autorizado. Bruno fala "pode seguir", Harry segue. Bruno fala "aguarde minha palavra", Harry para em checkpoints.

📋 Roadmap — 6 estágios em ordem cirúrgica

Estágio 1 — Bug 32 fix (prompt agent frontend) ~1-2h

Gargalo atual. Ampliar AGENT_RULES.frontend em orchestrator/agents/index.ts:45 para instruir explicitamente: "gere apenas componentes React em arquivos .tsx, NÃO arquivos de configuração". Adicionar exemplo shadcn concreto como referência. Sem isso, V1-004 nunca fecha sozinho.

Estágio 2 — Bug 29 fix (retry com feedback) ~30-45min

Arquitetural. Injetar issues do Stewardship no retry prompt via buildExecutePrompt(task, plan, context, { previousIssues }). Beneficia todas task_types, não só frontend. Builder aprende dentro da própria tentativa.

Estágio 3 — Validação empírica V1-004 + Phase 1 inteira ~30min-1h

Rodar BUILDER_USE_SPAWN=1 pnpm start -- --resume --max-tasks 1. Se passar, rodar --max-tasks 20 pra validar Phase 1 completa. Expectativa: V1-004 → V1-046 todas completed autonomamente.

🚦 Ponto de liberação básico: Após Estágio 3, Builder funciona sozinho. Tecnicamente já dá pra apontar pro UNA, mas ainda sem identidade Harry.

Estágio 4 — Reorganização Opção 3 + codinomes Harry ~3-5h

Reorganizar filesystem pra espelhar hierarquia mental e já entrar com codinomes:

luiz-llm/
├── CLAUDE.md
├── .claude/
│   ├── settings.json
│   ├── agents/
│   │   ├── harrison-boss.md         ← CTO/orchestrator
│   │   ├── atlas-architect.md
│   │   ├── forge-backend.md
│   │   ├── nova-frontend.md
│   │   ├── ledger-database.md
│   │   ├── sentinel-security.md
│   │   ├── echo-qa.md
│   │   ├── graves-auditor.md        ← auditor qualidade novo
│   │   ├── quill-docs.md
│   │   └── switch-deploy.md
│   ├── commands/
│   │   ├── harry-build.md           ← slash command principal
│   │   ├── harry-fix.md
│   │   └── harry-review.md
│   ├── skills/                       ← base de competências que Harry acumula
│   │   ├── research-opensource.md
│   │   ├── api-design.md
│   │   ├── documentation-generation.md
│   │   ├── architecture-flows.md
│   │   └── ...
│   └── rules/
│       ├── cost-first.md
│       ├── research-before-build.md
│       ├── ask-when-unsure.md
│       └── document-everything.md
├── orchestrator/
│   ├── core/
│   ├── routing/
│   └── validation/
└── packages/
    └── cascade/                      ← placeholder