# 🎼 TUTORIAL: Orquestração Universal {{USER_NAME}} (v4.0)

## 🚀 Resumo em 3 Pontos
1. **Ponto Único da Verdade:** Tudo o que a IA precisa saber sobre como você trabalha está em `{{USER_HOME}}/.orquestrador`.
2. **Consciência Global:** A IA agora sabe o que acontece em todos os seus projetos (<PRIVATE_TERM>, <PRIVATE_TERM>, etc.) através do `ecosistema.md`.
3. **Sincronia Automática:** Você não precisa configurar nada em novos projetos. O script de sincronia cuida de conectar o projeto ao Orquestrador.

---

## 📖 Guia de Uso Diário

### 1. Criando e Usando Skills
Nunca mais crie documentação técnica dentro de um projeto isolado.
- **Criar:** Crie em `{{USER_HOME}}/.orquestrador\skills\minha-skill\`.
- **Usar:** Em qualquer chat, diga: *"Use a skill global de [nome]"*. A IA saberá onde buscar.

### 2. Consultando o Ecossistema
A IA tem "visão de águia". Se você estiver na <PRIVATE_TERM> e quiser algo do <PRIVATE_TERM>:
- **Comando:** *"IA, veja no meu ecossistema global como eu resolvi o problema X no projeto <PRIVATE_TERM> e aplique aqui."*

### 3. Mantendo as Regras
As leis de código (ex: "proibido usar any", "usar Tailwind") estão em `rules.md`.
- Se quiser mudar o estilo de todos os seus projetos de uma vez, mude apenas esse arquivo global.

### 4. Memória de Decisões (ADR)
O arquivo `memoria.md` guarda o "porquê" das coisas. Se você mudar uma tecnologia padrão, registre lá para que a IA não sugira a tecnologia antiga no futuro.

---

## 📂 Estrutura do Orquestrador
- `rules.md`: A Constituição (Leis).
- `maestro.md`: A Metodologia (Processo).
- `hooks.md`: Gatilhos (Validação).
- `ecosistema.md`: Mapa de Projetos.
- `skills/`: Biblioteca de Conhecimento.
- `memoria.md`: Log de Decisões.

---
*Maestro Engine v4.0 - 2026-01-27*
