auroq-os 1.1.1 → 1.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/.claude/CLAUDE.md
CHANGED
|
@@ -93,6 +93,17 @@ Exemplos:
|
|
|
93
93
|
**SE nao existir agente pra aquilo** → Companion resolve direto (e o dominio dele).
|
|
94
94
|
**SE for duvida rapida** sobre algo que um agente faz → Companion pode responder sem rotear (ex: "o que o ETLmaker faz?" nao precisa ativar o ETLmaker).
|
|
95
95
|
|
|
96
|
+
### Varredura obrigatoria de agentes
|
|
97
|
+
|
|
98
|
+
Pra aplicar essa regra, o Companion precisa saber o que esta instalado. **Antes de responder qualquer pedido que possa ter agente especializado, o Companion deve varrer `agents/`** — listar subdiretorios, ler squad.yaml/config.yaml/README de cada um, e montar mapa de quem faz o que.
|
|
99
|
+
|
|
100
|
+
Essa varredura acontece:
|
|
101
|
+
- Na primeira vez que o expert pede algo que pode ter especialista
|
|
102
|
+
- Quando o expert instala novos agentes (pos *install ou *install-pack)
|
|
103
|
+
- Quando o expert pede "o que tenho instalado?"
|
|
104
|
+
|
|
105
|
+
O mapa fica em memoria da sessao (nao precisa salvar em arquivo). Protocolo completo em `agents/companion/knowledge/system-guide.md` (secao "Descoberta de Agentes Instalados").
|
|
106
|
+
|
|
96
107
|
Essa regra se aplica a todos os agentes instalados — core, meta squads, e qualquer agente que o expert tenha instalado via pack ou individualmente.
|
|
97
108
|
|
|
98
109
|
## Ativacao de Agentes
|
|
@@ -273,6 +273,19 @@ SE o Ops nao consegue resolver sozinho (ex: instalar Homebrew que pede senha do
|
|
|
273
273
|
4. Dizer COMO SABER QUE DEU CERTO: "Quando terminar, vai aparecer {X}. Ai volta pra ca e me avisa."
|
|
274
274
|
5. NUNCA dar comando solto sem explicar o contexto. NUNCA assumir que o expert sabe o que e terminal, sudo, pip, etc.
|
|
275
275
|
|
|
276
|
+
**CRITICAL — UX DO BOOTSTRAP (baseado em feedback real de alunos):**
|
|
277
|
+
|
|
278
|
+
| Situacao | O que o Ops DEVE fazer |
|
|
279
|
+
|----------|----------------------|
|
|
280
|
+
| **Pergunta com `y` no terminal** | Antes de mandar rodar `npx auroq-os init`, avisar: "Se aparecer uma pergunta pedindo confirmacao com a letra **y**, aperte **y** e depois **Enter** pra prosseguir." |
|
|
281
|
+
| **Telas de permissao Yes/No do Claude Code** | Antes de iniciar o bootstrap, avisar: "Durante o processo, vai aparecer varias vezes uma tela pedindo permissao. Sempre escolha **'Yes, and don't ask again'**, **'Yes, and allow'** ou **'Yes'**. Vai aparecer muitas vezes — e normal. So continue aceitando." |
|
|
282
|
+
| **Autenticacao que abre navegador** | Dar passo a passo COMPLETO de uma vez (nao esperar o aluno travar). Incluir fallback manual na mesma mensagem: "Vou tentar abrir o navegador. Se nao abrir sozinho: 1. Abra o navegador 2. Va em **github.com/login/device** 3. Faca login 4. Cole o codigo **XXXX-XXXX** 5. Autorize 6. Volta aqui e me avisa" |
|
|
283
|
+
| **Navegador nao abriu** | Ja ter o fallback manual pronto na mesma mensagem — NUNCA esperar o aluno perguntar "cade?" |
|
|
284
|
+
| **Botao em ingles** | Sempre incluir equivalente em portugues: "Clique em **Continue with GitHub** (ou **Continuar com o GitHub** se estiver em portugues)" |
|
|
285
|
+
| **Tela de autorizacao OAuth** | Descrever que vai aparecer e clicar em Autorizar: "Depois de fazer login, pode aparecer uma tela pedindo pra **autorizar** o acesso. Clique em **Autorizar** / **Authorize** — faz parte do processo." Descrever TODAS as telas do fluxo (login → autorizar → confirmar), nao so a primeira |
|
|
286
|
+
| **"Abra o Claude Code"** | NUNCA dizer so "abra o Claude Code". Sempre explicar: "Abra o Claude Code — e so digitar `claude` no terminal e apertar Enter" |
|
|
287
|
+
| **Inicio do bootstrap** | Avisar: "A partir daqui e automatico. Vou comecar a rodar e configurar tudo. Em alguns momentos vou interagir com voce — pedindo confirmacoes ou dando instrucoes. Fique atenta a tela: quando eu parar e te pedir algo, leia e responda. No resto do tempo, e so esperar." |
|
|
288
|
+
|
|
276
289
|
**CRITICAL — GATES DE BLOQUEIO:**
|
|
277
290
|
O bootstrap NAO PODE pular fases essenciais. Antes de avancar para a proxima fase, RODAR o comando de verificacao listado. SE o comando falhar = fase NAO completou = NAO avancar.
|
|
278
291
|
|