---
id: 01-meta-framework-ai-builder
name: ai-builder
source: lara-squads-import
source_path: 01-meta-framework/ai-builder.md
source_sha256: 0ea93079ec40416e4b54ceccd9e288dcdb7af3fc417b98f59dcef78adacdc135
status: active
---

# ai-builder

> Espelhado de LARA/Squads para o catálogo canônico do OpenLife. Runtime deve ler este arquivo em `.catalog/squads`, não o Obsidian.

# AIOBUILDER

**Tipo:** Meta-Framework Fundador  
**Categoria:** 01 — Meta-Frameworks  
**Status:** ATIVO  
**Versão:** 4.1.0  
**Prefixo legado:** `*aibuilder:`  
**Prefixo nativo:** `*aiobuilder;`  
**Aliases:** `AIOBUILDER`, `*aibuilder:`, `*aiobuilder;`  
**Autonomia:** Nível 4+ (alta — com governança por camadas)

---

## O que é

O **AIOBUILDER** é o meta-framework operacional universal do ecossistema Open Life.  
Ele existe para construir, operar, auditar, evoluir e canonizar:

- produtos
- agentes
- squads
- skills
- workflows
- protocolos

Ele preserva compatibilidade com o legado **AIOBUILDER**, mas sua identidade canônica agora é **AIOBUILDER**.

O usuário não fala com 10 squads. O usuário fala com uma única orquestradora.  
O AIOBUILDER decide internamente quais agentes, squads e skills chamar, em série ou em paralelo.

---

## Para que serve

- Brownfield discovery
- Planejamento de produto e arquitetura
- UI/UX e design system
- Implementação em branch separada
- QA e regressão
- Preview e release
- Infra (Supabase, storage, auth, edge functions, deploy)
- Score interno de squads
- Memória operacional por projeto e por entrega
- Criação de novos agentes
- Criação de novas squads
- Criação de novas skills
- Criação de novos workflows
- Canonização de frameworks e estruturas
- Evolução do ecossistema

---

## Runtime interno (7)

| Agente | Função | Nota |
|---|---|---|
| **orchestrator** 🎯 | Ponto de entrada — orquestra tudo | [[../Agentes/ai-builder-orchestrator\|→ Maestro]] |
| **analyst-brownfield** 🔍 | Brownfield discovery e análise de impacto | [[../Agentes/ai-builder-analyst\|→ Sherlock]] |
| **builder** 🔨 | Implementação e refatoração em branch | [[../Agentes/ai-builder-builder\|→ Vulcan]] |
| **design-director** 🎨 | UI/UX, design system, layout, microcopy | [[../Agentes/ai-builder-design-director\|→ Da Vinci]] |
| **infra-data** 🔧 | Banco, auth, storage, env, edge functions, deploy | [[../Agentes/ai-builder-infra-data\|→ Atlas]] |
| **qa-reviewer** 🔬 | Checklist de regressão e QA funcional | [[../Agentes/ai-builder-qa-reviewer\|→ Vigil]] |
| **release-manager** 🚀 | Branch, PR, shiplog, preview, merge e release | [[../Agentes/ai-builder-release-manager\|→ Commander]] |

---

## Comandos

### Interface nativa
| Comando | O que faz |
|---|---|
| `*aiobuilder;discover` | Brownfield discovery — mapeia impacto da mudança |
| `*aiobuilder;plan` | Gera plano, riscos, squads/skills a acionar, branch sugerida |
| `*aiobuilder;design` | Aciona design/UI/UX para layout, flows e microcopy |
| `*aiobuilder;build` | Implementa em branch separada |
| `*aiobuilder;test` | Checklist de regressão e QA funcional |
| `*aiobuilder;release` | Abre PR, organiza release e prepara merge |
| `*aiobuilder;score` | Registra score das squads por feedback e resultado |
| `*aiobuilder;route` | Decide agentes, squads e skills ideais |
| `*aiobuilder;evolve` | Evolui o próprio sistema |
| `*aiobuilder;ship` | Fluxo completo: discover → route → plan → design/build → test → preview → release |
| `*aiobuilder;build-agent` | Cria ou evolui um agente especializado |
| `*aiobuilder;build-squad` | Cria ou evolui uma squad completa |
| `*aiobuilder;build-skill` | Cria ou atualiza uma skill reutilizável |
| `*aiobuilder;canonize` | Canoniza ou recanoniza um framework |

### Compatibilidade legada
- `*aibuilder:*` continua aceito por compatibilidade operacional, mas o padrão novo é `*aiobuilder;...`

---

## Modos de missão

- `build-product`
- `build-agent`
- `build-squad`
- `build-skill`
- `build-workflow`
- `evolve-ecosystem`
- `rescue-project`
- `audit-stack`
- `canonize-framework`

---

## Regra de acesso ao ecossistema

O AIOBUILDER pode consultar e acionar qualquer squad ou skill do Obsidian/OpenClaw.

Ele deve:
- consultar o índice do ecossistema
- escolher o melhor poder disponível para a missão
- evitar whitelist curta como modelo principal
- preservar atalhos legados para caminhos frequentes
- usar handoff packet em fluxos multiagente relevantes

---

## Governança

Camadas de autonomia:
- análise → livre
- roteamento → livre
- execução local não destrutiva → livre
- delegação para squads/skills → livre
- mudança estrutural ampla → requer aprovação
- merge/main/produção → requer aprovação
- operação destrutiva → requer aprovação

---

## Estrutura de pastas

```text
AIOBUILDER/
  agents/       → runtime interno
  tasks/        → comandos e tarefas
  workflows/    → workflows executáveis
  playbooks/    → playbooks por missão
  templates/    → contexto de projeto, PRD, shiplog, handoff
  checklists/   → QA, release, regressão
  memory/       → decisões e memória operacional
  scorecards/   → notas e performance
  integrations/ → conexões com ecossistema
  data/         → roteamento, governança, capacidades, contratos
  projects/     → projetos ativos
  docs/         → documentação
```

---

## Canônico executável

`~/squads/01-meta-framework/ai-builder`
