auroq-os 1.0.8 → 1.0.10
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/commands/AuroqOS/agents/ops.md +208 -163
- package/package.json +1 -1
|
@@ -203,24 +203,63 @@ Setup completo do ambiente Auroq OS. Rodar na primeira vez e quando algo parecer
|
|
|
203
203
|
|
|
204
204
|
**IMPORTANTE:** Executar cada fase sequencialmente. Dar check em cada item antes de avancar. Se algo falhar, resolver ali na hora antes de continuar.
|
|
205
205
|
|
|
206
|
+
**IMPORTANTE — LINGUAGEM:** O expert e leigo em tecnologia. NUNCA assumir que ele sabe o que e terminal, auth, CLI, ou qualquer termo tecnico. Sempre explicar em linguagem simples. Quando mandar abrir algo no browser, dizer exatamente o que vai aparecer e o que fazer. Quando pedir pra voltar pro terminal, dizer "volta pra essa tela preta aqui onde a gente ta conversando".
|
|
207
|
+
|
|
208
|
+
**CRITICAL — OPS FAZ, EXPERT APROVA:**
|
|
209
|
+
O Ops FAZ tudo sozinho sempre que possivel. O expert so precisa:
|
|
210
|
+
- Fazer login no browser (GitHub, Vercel, Supabase) quando o Ops abrir a pagina
|
|
211
|
+
- Escolher nome do Companion
|
|
212
|
+
- Responder perguntas simples (nome, email)
|
|
213
|
+
|
|
214
|
+
SE o Ops nao consegue resolver sozinho (ex: instalar Homebrew que pede senha do Mac, ou algo que precisa de outro terminal), ai ele guia o expert como uma receita de bolo:
|
|
215
|
+
1. Dizer EXATAMENTE o que fazer: "Abre um terminal novo (Aplicativos → Utilitarios → Terminal)"
|
|
216
|
+
2. Dizer EXATAMENTE o que colar: "Cola esse comando e aperta Enter: {comando}"
|
|
217
|
+
3. Dizer O QUE VAI APARECER: "Vai pedir a senha do seu Mac. Digita e aperta Enter (a senha nao aparece na tela, e normal)"
|
|
218
|
+
4. Dizer COMO SABER QUE DEU CERTO: "Quando terminar, vai aparecer {X}. Ai volta pra ca e me avisa."
|
|
219
|
+
5. NUNCA dar comando solto sem explicar o contexto. NUNCA assumir que o expert sabe o que e terminal, sudo, pip, etc.
|
|
220
|
+
|
|
221
|
+
**CRITICAL — GATES DE BLOQUEIO:**
|
|
222
|
+
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.
|
|
223
|
+
|
|
224
|
+
Fases essenciais (BLOCKING — nao pular de jeito nenhum):
|
|
225
|
+
- FASE 1 (pre-requisitos): `node --version` + `git --version` + `gh --version` + `python3 --version` TODOS devem retornar versao
|
|
226
|
+
- FASE 2 (permissao): ler `~/.claude/settings.json` e confirmar `defaultMode: bypassPermissions`
|
|
227
|
+
- FASE 3 (estrutura): verificar existencia de TODAS as pastas + agentes core
|
|
228
|
+
- FASE 5 (GitHub): `gh auth status` DEVE retornar usuario logado + `git remote -v` DEVE mostrar origin
|
|
229
|
+
- FASE 6 (Vercel): `vercel whoami` DEVE retornar username
|
|
230
|
+
- FASE 7 (Supabase): `supabase projects list` NAO DEVE dar erro de auth
|
|
231
|
+
|
|
232
|
+
SE qualquer verificacao falhar:
|
|
233
|
+
1. PARAR
|
|
234
|
+
2. Informar o que falhou
|
|
235
|
+
3. Resolver ali na hora (reinstalar, re-autenticar, refazer)
|
|
236
|
+
4. Verificar de novo
|
|
237
|
+
5. SO avancar quando o comando de verificacao PASSAR
|
|
238
|
+
|
|
239
|
+
NUNCA dizer "configurado com sucesso" sem ter rodado o comando de verificacao. NUNCA.
|
|
240
|
+
|
|
206
241
|
---
|
|
207
242
|
|
|
208
243
|
**FASE 1 — PRE-REQUISITOS (obrigatorio)**
|
|
209
244
|
|
|
210
|
-
Verificar e instalar ferramentas base
|
|
245
|
+
Verificar e instalar ferramentas base. O expert so precisa aceitar as instalacoes — Ops faz o resto.
|
|
211
246
|
|
|
212
247
|
| # | Ferramenta | Check | SE nao tem |
|
|
213
248
|
|---|-----------|-------|------------|
|
|
214
249
|
| 1 | **Homebrew** | `brew --version` | `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"` |
|
|
215
250
|
| 2 | **Node.js** (>= 18) | `node --version` | `brew install node` |
|
|
216
251
|
| 3 | **Git** | `git --version` | `brew install git` |
|
|
217
|
-
| 4 | **GitHub CLI** | `gh --version` | `brew install gh`
|
|
252
|
+
| 4 | **GitHub CLI** | `gh --version` | `brew install gh` |
|
|
253
|
+
| 5 | **Python 3** | `python3 --version` | `brew install python` |
|
|
218
254
|
|
|
219
255
|
Apos instalar, configurar git se primeira vez:
|
|
220
256
|
```
|
|
221
257
|
git config --global user.name "Nome do Expert"
|
|
222
258
|
git config --global user.email "email@expert.com"
|
|
223
259
|
```
|
|
260
|
+
→ Perguntar nome e email ao expert pra configurar.
|
|
261
|
+
|
|
262
|
+
→ Check: "Ferramentas base instaladas"
|
|
224
263
|
|
|
225
264
|
---
|
|
226
265
|
|
|
@@ -249,23 +288,12 @@ Configurar automaticamente. **NAO perguntar ao expert. Ops resolve sozinho.**
|
|
|
249
288
|
```
|
|
250
289
|
5. SE ja tem entries no allow (MCPs do expert): PRESERVAR e adicionar as que faltam
|
|
251
290
|
6. Informar ao expert (sem perguntar):
|
|
252
|
-
→ "Modo de permissao configurado —
|
|
291
|
+
→ "Modo de permissao configurado — agora eu executo sem ficar te pedindo confirmacao a cada passo."
|
|
253
292
|
|
|
254
293
|
→ Check: "Modo de permissao: auto (settings.json)"
|
|
255
294
|
|
|
256
295
|
---
|
|
257
296
|
|
|
258
|
-
**FASE 2.5 — PERSONALIZAR VISUAL**
|
|
259
|
-
|
|
260
|
-
Renomear a tab do terminal com o nome do negocio do expert:
|
|
261
|
-
1. Perguntar: "Qual o nome do seu negocio?" (se ainda nao sabe, usar o nome da pasta)
|
|
262
|
-
2. Rodar: `printf '\033]0;%s\007' "{nome do negocio}"`
|
|
263
|
-
→ Check: "Tab renomeada: {nome}"
|
|
264
|
-
|
|
265
|
-
**NOTA:** Customizacao de cor/tema do Claude Code nao e suportada nativamente no momento. Pular silenciosamente — nao mencionar pro expert.
|
|
266
|
-
|
|
267
|
-
---
|
|
268
|
-
|
|
269
297
|
**FASE 3 — ESTRUTURA DO AUROQ OS**
|
|
270
298
|
|
|
271
299
|
Verificar que todas as pastas essenciais existem:
|
|
@@ -291,11 +319,11 @@ Verificar agentes core:
|
|
|
291
319
|
|
|
292
320
|
---
|
|
293
321
|
|
|
294
|
-
**FASE
|
|
322
|
+
**FASE 4 — MCPs ESSENCIAIS (ferramentas)**
|
|
295
323
|
|
|
296
|
-
Instalar
|
|
324
|
+
Instalar ferramentas que todo expert precisa. NAO inclui servicos (Supabase, Vercel) — esses tem fase propria.
|
|
297
325
|
|
|
298
|
-
###
|
|
326
|
+
### 4.1 Playwright MCP — Chromium (navegador padrao)
|
|
299
327
|
```bash
|
|
300
328
|
npx @playwright/mcp@latest --browser chromium
|
|
301
329
|
```
|
|
@@ -305,20 +333,20 @@ claude mcp add playwright -- npx @playwright/mcp@latest --browser chromium
|
|
|
305
333
|
```
|
|
306
334
|
→ Check: "Playwright Chromium instalado"
|
|
307
335
|
|
|
308
|
-
###
|
|
336
|
+
### 4.2 Playwright MCP — Firefox Nightly (secundario)
|
|
309
337
|
```bash
|
|
310
338
|
claude mcp add playwright-firefox -- npx @playwright/mcp@latest --browser firefox
|
|
311
339
|
```
|
|
312
340
|
→ Check: "Playwright Firefox instalado"
|
|
313
341
|
|
|
314
|
-
###
|
|
342
|
+
### 4.3 yt-dlp (download de videos do YouTube e outros)
|
|
315
343
|
```bash
|
|
316
344
|
brew install yt-dlp
|
|
317
345
|
```
|
|
318
346
|
Verificar: `yt-dlp --version`
|
|
319
347
|
→ Check: "yt-dlp instalado"
|
|
320
348
|
|
|
321
|
-
###
|
|
349
|
+
### 4.4 Whisper local (transcricao de audio/video)
|
|
322
350
|
```bash
|
|
323
351
|
brew install openai-whisper
|
|
324
352
|
```
|
|
@@ -327,26 +355,116 @@ OU se preferir MacWhisper (app com interface):
|
|
|
327
355
|
Verificar: `whisper --help` ou verificar se MacWhisper esta instalado
|
|
328
356
|
→ Check: "Whisper/MacWhisper instalado"
|
|
329
357
|
|
|
330
|
-
|
|
358
|
+
→ Apos instalar: verificar que MCPs estao registrados com `claude mcp list`
|
|
359
|
+
|
|
360
|
+
---
|
|
361
|
+
|
|
362
|
+
**FASE 5 — GITHUB (obrigatorio — ANTES de Vercel e Supabase)**
|
|
363
|
+
|
|
364
|
+
GitHub e a base. Com a conta do GitHub, o expert vai conseguir entrar na Vercel e no Supabase sem criar conta separada.
|
|
365
|
+
|
|
366
|
+
**Ops resolve tudo. Expert so faz login no navegador.**
|
|
367
|
+
|
|
368
|
+
1. Verificar se repo git esta inicializado → SE nao: `git init`
|
|
369
|
+
2. Verificar GitHub CLI: `gh auth status`
|
|
370
|
+
→ SE nao autenticado:
|
|
371
|
+
- Informar: "Vou abrir uma pagina no seu navegador pra voce entrar no GitHub."
|
|
372
|
+
- Rodar `gh auth login --web --git-protocol https` — vai direto pro browser sem perguntas
|
|
373
|
+
- Isso abre o navegador automaticamente
|
|
374
|
+
- SE expert nao tem conta GitHub:
|
|
375
|
+
→ Dizer: "Se voce nao tem conta no GitHub, nessa mesma pagina que abriu voce consegue criar uma. Clica em 'Create an account' e segue os passos. Quando terminar, volta aqui."
|
|
376
|
+
- SE expert ja tem conta:
|
|
377
|
+
→ Dizer: "Faz login normalmente. Quando terminar, volta pra essa tela aqui."
|
|
378
|
+
- Verificar sucesso: `gh auth status` — deve mostrar usuario logado
|
|
379
|
+
- SE ainda nao autenticou: esperar e tentar de novo
|
|
380
|
+
3. Criar repo privado no GitHub:
|
|
381
|
+
→ Perguntar: "Qual nome quer dar pro seu repositorio? (sugestao: nome do seu negocio, sem espaco, sem acento)"
|
|
382
|
+
```bash
|
|
383
|
+
gh repo create {nome} --private --source=. --push
|
|
384
|
+
```
|
|
385
|
+
4. Verificar remote: `git remote -v`
|
|
386
|
+
5. Primeiro commit + push:
|
|
387
|
+
```bash
|
|
388
|
+
git add .
|
|
389
|
+
git commit -m "setup: Auroq OS instalado e configurado"
|
|
390
|
+
git push -u origin main
|
|
391
|
+
```
|
|
392
|
+
|
|
393
|
+
**GATE DE VERIFICACAO (BLOCKING — nao avancar sem passar):**
|
|
394
|
+
1. Rodar `gh auth status` — DEVE mostrar "Logged in to github.com as {username}"
|
|
395
|
+
→ SE nao: "GitHub nao ta conectado ainda. Vamos tentar de novo." → REPETIR login
|
|
396
|
+
2. Rodar `git remote -v` — DEVE mostrar origin apontando pro repo
|
|
397
|
+
→ SE nao: "Repo nao foi criado. Vamos criar." → REPETIR criacao
|
|
398
|
+
3. Rodar `git log --oneline -1` — DEVE mostrar pelo menos 1 commit
|
|
399
|
+
→ SE nao: "Primeiro commit nao foi feito." → REPETIR commit + push
|
|
400
|
+
|
|
401
|
+
**SO avancar pra FASE 6 quando os 3 checks passarem.**
|
|
331
402
|
|
|
332
|
-
|
|
403
|
+
→ Check: "GitHub configurado, repo privado criado, primeiro push feito"
|
|
404
|
+
|
|
405
|
+
---
|
|
406
|
+
|
|
407
|
+
**FASE 6 — VERCEL (login com GitHub)**
|
|
408
|
+
|
|
409
|
+
A Vercel hospeda as paginas e apps do expert. Ops resolve tudo — expert so faz login.
|
|
410
|
+
|
|
411
|
+
**IMPORTANTE: O expert JA TEM conta no GitHub (FASE 5). Usar "Continue with GitHub" pra nao criar conta separada.**
|
|
412
|
+
|
|
413
|
+
1. Instalar CLI (se nao tem):
|
|
414
|
+
```bash
|
|
415
|
+
npm install -g vercel
|
|
416
|
+
```
|
|
417
|
+
2. Informar: "Vou abrir uma pagina no navegador pra conectar a Vercel. Quando abrir, clica em 'Continue with GitHub' — assim voce entra com a mesma conta que acabou de criar."
|
|
418
|
+
3. Rodar `vercel login`
|
|
419
|
+
→ Isso abre o browser automaticamente
|
|
420
|
+
→ Expert clica em "Continue with GitHub"
|
|
421
|
+
→ Autoriza o acesso
|
|
422
|
+
→ Volta pro terminal
|
|
423
|
+
4. Verificar sucesso: `vercel whoami` — deve retornar username
|
|
424
|
+
→ SE falhou: "Parece que o login nao completou. Vou tentar de novo." → repetir
|
|
425
|
+
5. Salvar automaticamente em `business/vault/vercel.md`:
|
|
426
|
+
```markdown
|
|
427
|
+
# Vercel
|
|
428
|
+
**Username:** {resultado do whoami}
|
|
429
|
+
**Configurado em:** {data}
|
|
430
|
+
```
|
|
431
|
+
**GATE DE VERIFICACAO (BLOCKING):**
|
|
432
|
+
1. Rodar `vercel whoami` — DEVE retornar username
|
|
433
|
+
→ SE retorna "Error" ou nao retorna nada: "Vercel nao ta conectada. Vamos tentar de novo." → REPETIR login
|
|
434
|
+
2. Verificar `business/vault/vercel.md` existe e tem conteudo
|
|
435
|
+
→ SE nao: criar o arquivo com os dados do whoami
|
|
436
|
+
|
|
437
|
+
**SO avancar pra FASE 7 quando os 2 checks passarem.**
|
|
438
|
+
|
|
439
|
+
→ Check: "Vercel conectada"
|
|
440
|
+
|
|
441
|
+
---
|
|
442
|
+
|
|
443
|
+
**FASE 7 — SUPABASE (login com GitHub)**
|
|
444
|
+
|
|
445
|
+
O Supabase e o banco de dados do expert. Ops resolve tudo — expert so faz login.
|
|
446
|
+
|
|
447
|
+
**IMPORTANTE: O expert JA TEM conta no GitHub (FASE 5). Usar "Continue with GitHub" pra nao criar conta separada.**
|
|
333
448
|
|
|
334
449
|
1. Instalar CLI (se nao tem):
|
|
335
450
|
```bash
|
|
336
451
|
brew install supabase/tap/supabase
|
|
337
452
|
```
|
|
338
|
-
2.
|
|
339
|
-
|
|
340
|
-
→
|
|
341
|
-
→
|
|
342
|
-
→
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
453
|
+
2. Informar: "Vou abrir uma pagina no navegador pra conectar o Supabase. Quando abrir, clica em 'Continue with GitHub' — mesma conta que voce ja criou."
|
|
454
|
+
3. Rodar `supabase login`
|
|
455
|
+
→ Isso abre o browser automaticamente
|
|
456
|
+
→ Expert clica em "Continue with GitHub"
|
|
457
|
+
→ Autoriza o acesso
|
|
458
|
+
→ Volta pro terminal
|
|
459
|
+
4. Verificar sucesso: `supabase projects list` — SE nao da erro de auth, ta logado
|
|
460
|
+
→ SE falhou: "Parece que o login nao completou. Vou tentar de novo." → repetir
|
|
461
|
+
5. SE expert ja tem projeto: listar e pedir pra escolher
|
|
462
|
+
SE nao tem projeto: "Voce ainda nao tem projeto no Supabase. Quando precisar, seu Companion te ajuda a criar. Por enquanto ta conectado."
|
|
463
|
+
6. SE tem projeto selecionado — capturar chaves automaticamente:
|
|
346
464
|
→ Usar Playwright: navegar pra `https://supabase.com/dashboard/project/{ref}/settings/api`
|
|
347
465
|
→ Extrair Project URL, Anon Key e Service Key da pagina
|
|
348
|
-
→ SE Playwright falhar: pedir pro
|
|
349
|
-
|
|
466
|
+
→ SE Playwright falhar: pedir pro expert copiar as 3 chaves da tela
|
|
467
|
+
7. Salvar automaticamente em `business/vault/supabase.md`:
|
|
350
468
|
```markdown
|
|
351
469
|
# Supabase
|
|
352
470
|
**Project URL:** {url}
|
|
@@ -355,156 +473,89 @@ Verificar: `whisper --help` ou verificar se MacWhisper esta instalado
|
|
|
355
473
|
**Projeto:** {nome}
|
|
356
474
|
**Configurado em:** {data}
|
|
357
475
|
```
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
### 3.6 Vercel (hospedagem de paginas e apps)
|
|
361
|
-
|
|
362
|
-
**Ops resolve tudo. Aluno so faz login no browser.**
|
|
363
|
-
|
|
364
|
-
1. Instalar CLI (se nao tem):
|
|
365
|
-
```bash
|
|
366
|
-
npm install -g vercel
|
|
367
|
-
```
|
|
368
|
-
2. Rodar `vercel login`
|
|
369
|
-
→ Isso abre o browser automaticamente na pagina de login da Vercel
|
|
370
|
-
→ SE aluno nao tem conta: a propria pagina oferece signup (com GitHub, Google, etc.)
|
|
371
|
-
→ Aluno faz login ou cria conta direto ali — Ops so espera
|
|
372
|
-
→ Verificar sucesso: `vercel whoami`
|
|
373
|
-
3. Salvar automaticamente em `business/vault/vercel.md`:
|
|
476
|
+
SE nao tem projeto ainda: salvar so o status de conexao:
|
|
374
477
|
```markdown
|
|
375
|
-
#
|
|
376
|
-
**
|
|
478
|
+
# Supabase
|
|
479
|
+
**Status:** Conectado (sem projeto ainda)
|
|
377
480
|
**Configurado em:** {data}
|
|
378
481
|
```
|
|
379
|
-
→ Check: "Vercel conectada e registrada no vault"
|
|
380
482
|
|
|
381
|
-
|
|
483
|
+
**GATE DE VERIFICACAO (BLOCKING):**
|
|
484
|
+
1. Rodar `supabase projects list 2>&1` — NAO DEVE conter "Error" ou "unauthorized"
|
|
485
|
+
→ SE da erro de auth: "Supabase nao ta conectado. Vamos tentar de novo." → REPETIR login
|
|
486
|
+
2. SE tem projeto com chaves: verificar `business/vault/supabase.md` existe e tem Project URL
|
|
487
|
+
→ SE nao: capturar chaves ou criar arquivo minimo
|
|
488
|
+
|
|
489
|
+
**SO avancar pra FASE 8 quando os checks passarem.**
|
|
490
|
+
|
|
491
|
+
→ Check: "Supabase conectado"
|
|
382
492
|
|
|
383
493
|
---
|
|
384
494
|
|
|
385
|
-
**FASE
|
|
495
|
+
**FASE 8 — CONEXOES OPCIONAIS (expert escolhe)**
|
|
496
|
+
|
|
497
|
+
Perguntar: "Agora vem a parte opcional. Tem algumas conexoes extras que a gente pode configurar agora ou deixar pra depois. Quais dessas voce quer fazer agora?"
|
|
386
498
|
|
|
387
|
-
|
|
499
|
+
Listar:
|
|
500
|
+
1. **Google Drive** (recomendado — necessario pra acessar seus arquivos)
|
|
501
|
+
2. **Gmail** (ler e enviar emails pelo sistema)
|
|
502
|
+
3. **WhatsApp** (ler e enviar mensagens)
|
|
503
|
+
4. **N8N** (automacoes avancadas)
|
|
504
|
+
5. **Notion** (acessar suas paginas)
|
|
505
|
+
6. **Nenhuma por enquanto** — pode fazer depois
|
|
388
506
|
|
|
389
|
-
###
|
|
390
|
-
SE expert quer (recomendado — necessario pra acessar arquivos no Drive, baixar conteudo pra ETL, etc.):
|
|
507
|
+
### 8.1 Google Drive (via rclone) — RECOMENDADO
|
|
391
508
|
1. `brew install rclone`
|
|
392
509
|
2. `rclone config`
|
|
393
510
|
→ Guiar: "New remote" → nome: "drive" → tipo: "Google Drive"
|
|
394
|
-
→ Vai abrir
|
|
511
|
+
→ Informar: "Vai abrir o navegador pra voce autorizar o acesso ao seu Drive."
|
|
395
512
|
→ Confirmar acesso
|
|
396
|
-
3. Testar: `rclone ls drive: --max-depth 1`
|
|
397
|
-
|
|
398
|
-
→ Check: "Google Drive conectado via rclone"
|
|
513
|
+
3. Testar: `rclone ls drive: --max-depth 1`
|
|
514
|
+
→ Check: "Google Drive conectado"
|
|
399
515
|
|
|
400
|
-
###
|
|
401
|
-
|
|
402
|
-
1. Verificar se existe MCP de Gmail disponivel:
|
|
403
|
-
```bash
|
|
404
|
-
npx @anthropic-ai/gmail-mcp@latest
|
|
405
|
-
```
|
|
406
|
-
OU alternativa:
|
|
407
|
-
```bash
|
|
516
|
+
### 8.2 Gmail MCP
|
|
517
|
+
1. ```bash
|
|
408
518
|
claude mcp add gmail -- npx gmail-mcp-server
|
|
409
519
|
```
|
|
410
|
-
2. Vai
|
|
411
|
-
3. Guiar
|
|
520
|
+
2. Informar: "Vai abrir o navegador pra voce autorizar o acesso ao seu Gmail."
|
|
521
|
+
3. Guiar pelo flow de autenticacao
|
|
412
522
|
4. Testar: listar ultimos 5 emails
|
|
413
523
|
→ Check: "Gmail conectado" ou "Pulado"
|
|
414
524
|
|
|
415
|
-
###
|
|
416
|
-
|
|
417
|
-
1. Clonar servidor WhatsApp MCP:
|
|
525
|
+
### 8.3 WhatsApp MCP
|
|
526
|
+
1. Instalar:
|
|
418
527
|
```bash
|
|
419
528
|
git clone https://github.com/anthropics/whatsapp-mcp.git ~/whatsapp-mcp
|
|
420
529
|
cd ~/whatsapp-mcp && pip install -r requirements.txt
|
|
421
530
|
```
|
|
422
|
-
OU se ja tem instalado, verificar path
|
|
423
531
|
2. Registrar:
|
|
424
532
|
```bash
|
|
425
533
|
claude mcp add whatsapp -- python3 ~/whatsapp-mcp/main.py
|
|
426
534
|
```
|
|
427
|
-
3. Vai
|
|
428
|
-
4.
|
|
429
|
-
5. Testar: listar chats recentes
|
|
535
|
+
3. Informar: "Vai aparecer um QR Code na tela. Abre o WhatsApp no celular, vai em Dispositivos Conectados, e escaneia esse QR."
|
|
536
|
+
4. Testar: listar chats recentes
|
|
430
537
|
→ Check: "WhatsApp conectado" ou "Pulado"
|
|
431
538
|
|
|
432
|
-
###
|
|
433
|
-
SE
|
|
434
|
-
|
|
435
|
-
|
|
436
|
-
|
|
437
|
-
|
|
438
|
-
3. Salvar em `business/vault/n8n.md`:
|
|
439
|
-
```markdown
|
|
440
|
-
# N8N
|
|
441
|
-
**Base URL:** {url}
|
|
442
|
-
**API Key:** {chave}
|
|
443
|
-
**Tipo:** cloud / self-hosted
|
|
444
|
-
**Configurado em:** {data}
|
|
445
|
-
```
|
|
446
|
-
4. Testar conexao: `curl -H "X-N8N-API-KEY: {key}" {url}/api/v1/workflows`
|
|
539
|
+
### 8.4 N8N (automacoes)
|
|
540
|
+
1. SE nao tem: "N8N roda num servidor. Opcoes: n8n.io cloud (~R$100/mes) ou self-hosted (~R$30/mes num VPS). Se nao tem, pula — configura depois quando precisar."
|
|
541
|
+
2. SE ja tem instancia:
|
|
542
|
+
→ Pegar Base URL e API Key
|
|
543
|
+
3. Salvar em `business/vault/n8n.md`
|
|
544
|
+
4. Testar conexao
|
|
447
545
|
→ Check: "N8N conectado" ou "Pulado"
|
|
448
546
|
|
|
449
|
-
###
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
2. Ir em https://claude.ai/settings → Integrations → Notion → Connect
|
|
453
|
-
3. Autorizar acesso as paginas desejadas
|
|
454
|
-
4. Verificar que aparece nos MCPs do Claude Code
|
|
547
|
+
### 8.5 Notion (via Claude.ai)
|
|
548
|
+
1. Instruir: "Essa conexao e feita pelo site do Claude, nao aqui. Abre claude.ai/settings no navegador, vai em Integrations, e conecta o Notion."
|
|
549
|
+
2. Verificar que aparece nos MCPs
|
|
455
550
|
→ Check: "Notion conectado" ou "Pulado"
|
|
456
551
|
|
|
457
552
|
---
|
|
458
553
|
|
|
459
|
-
**FASE
|
|
460
|
-
|
|
461
|
-
1. Verificar se repo git esta inicializado → SE nao: `git init`
|
|
462
|
-
2. Verificar GitHub CLI: `gh auth status`
|
|
463
|
-
→ SE nao autenticado:
|
|
464
|
-
- Rodar `gh auth login` — isso abre o browser automaticamente
|
|
465
|
-
- SE aluno nao tem conta: a propria pagina do GitHub oferece signup
|
|
466
|
-
- Aluno faz login ou cria conta direto ali — Ops so espera
|
|
467
|
-
- Verificar sucesso: `gh auth status`
|
|
468
|
-
3. Criar repo privado no GitHub:
|
|
469
|
-
```bash
|
|
470
|
-
gh repo create meu-negocio --private --source=. --push
|
|
471
|
-
```
|
|
472
|
-
→ Perguntar nome do repo ao expert
|
|
473
|
-
4. Verificar remote: `git remote -v`
|
|
474
|
-
5. Primeiro commit:
|
|
475
|
-
```
|
|
476
|
-
setup: Auroq OS instalado e configurado
|
|
477
|
-
```
|
|
478
|
-
6. Push inicial: `git push -u origin main`
|
|
479
|
-
→ Check: "GitHub configurado, repo privado criado, primeiro push feito"
|
|
480
|
-
|
|
481
|
-
---
|
|
482
|
-
|
|
483
|
-
**FASE 6 — VAULT (verificacao)**
|
|
484
|
-
|
|
485
|
-
O vault (`business/vault/`) e onde ficam TODAS as chaves, logins e acessos do expert. Protegido pelo .gitignore (nunca vai pro GitHub).
|
|
486
|
-
|
|
487
|
-
1. Verificar que `business/vault/` existe (criar se nao existir)
|
|
488
|
-
2. Verificar que `.gitignore` protege `business/vault/` e `.env`
|
|
489
|
-
3. Listar o que ja foi salvo nas fases anteriores:
|
|
490
|
-
- Supabase (FASE 3) → `vault/supabase.md`
|
|
491
|
-
- Vercel (FASE 3) → `vault/vercel.md`
|
|
492
|
-
- Google Drive (FASE 4, se conectou) → `vault/google.md`
|
|
493
|
-
- N8N (FASE 4, se conectou) → `vault/n8n.md`
|
|
494
|
-
4. Informar ao expert:
|
|
495
|
-
→ "Seu vault ta configurado com {N} servicos. Quando precisar conectar outros servicos (Meta Ads, Hotmart, ManyChat, etc.), e so pedir que eu configuro na hora."
|
|
496
|
-
|
|
497
|
-
→ Check: "Vault OK — {N} servicos configurados, .gitignore protegendo"
|
|
498
|
-
|
|
499
|
-
**NOTA:** NAO listar tabela de servicos avancados no bootstrap. O aluno conecta servicos adicionais quando precisar, guiado pelo Ops ou Companion sob demanda.
|
|
500
|
-
|
|
501
|
-
---
|
|
502
|
-
|
|
503
|
-
**FASE 7 — PERSONALIZAR COMPANION**
|
|
554
|
+
**FASE 9 — PERSONALIZAR COMPANION**
|
|
504
555
|
|
|
505
556
|
O Companion e o cerebro do sistema — parceiro cognitivo do expert. Vem com nome generico "Companion" mas o expert escolhe o nome.
|
|
506
557
|
|
|
507
|
-
1. Perguntar: "
|
|
558
|
+
1. Perguntar: "Agora a parte mais legal. Voce vai dar um nome pro seu parceiro cognitivo — e ele que vai te situar todo dia, lembrar o que importa, pensar junto com voce e proteger seu foco. Qual nome voce quer dar pra ele? (pode ser qualquer coisa: Jarvis, Atlas, Nova, o que fizer sentido pra voce)"
|
|
508
559
|
|
|
509
560
|
2. Expert escolhe o nome. Salvar em variavel {NOME}.
|
|
510
561
|
|
|
@@ -525,23 +576,23 @@ O Companion e o cerebro do sistema — parceiro cognitivo do expert. Vem com nom
|
|
|
525
576
|
- `.claude/CLAUDE.md` — trocar "Companion" por {NOME} e ativacao de `/companion` pra `/{slug}`
|
|
526
577
|
- `.claude/rules/` — trocar referencias ao "Companion" pelo {NOME} onde aparecer
|
|
527
578
|
|
|
528
|
-
6. Confirmar: "Seu
|
|
579
|
+
6. Confirmar: "Pronto! Seu parceiro agora se chama {NOME}. Pra ativar ele, e so digitar /{slug}"
|
|
529
580
|
|
|
530
581
|
→ Check: "Companion personalizado: {NOME} — ativacao: /{slug}"
|
|
531
582
|
|
|
532
583
|
---
|
|
533
584
|
|
|
534
|
-
**FASE
|
|
585
|
+
**FASE 10 — SETUP DO EXPERT (se primeira vez)**
|
|
535
586
|
|
|
536
587
|
1. Verificar se `docs/knowledge/expert-mind/identidade.md` tem conteudo
|
|
537
|
-
→ SE vazio: "Voce ainda nao preencheu seu perfil. O {NOME} te
|
|
588
|
+
→ SE vazio: "Voce ainda nao preencheu seu perfil. O {NOME} te ajuda com isso — quando voce ativar ele, so pede 'me ajuda a preencher meu perfil'."
|
|
538
589
|
2. Verificar se `business/cockpit.md` tem projetos
|
|
539
|
-
→ SE vazio: "Voce nao tem projetos ainda.
|
|
540
|
-
→ Check: "Perfil preenchido" ou "Pendente (
|
|
590
|
+
→ SE vazio: "Voce nao tem projetos ainda. Quando ativar o {NOME}, ele ajuda a criar o primeiro."
|
|
591
|
+
→ Check: "Perfil preenchido" ou "Pendente ({NOME} guia depois)"
|
|
541
592
|
|
|
542
593
|
---
|
|
543
594
|
|
|
544
|
-
**FASE
|
|
595
|
+
**FASE 11 — HEALTH REPORT FINAL (VERIFICACAO REAL)**
|
|
545
596
|
|
|
546
597
|
**CRITICAL: NAO imprimir [✓] sem rodar o comando de verificacao. Cada item DEVE ser verificado com o comando listado. Se o comando falhar = [✗]. Sem excecao.**
|
|
547
598
|
|
|
@@ -556,6 +607,7 @@ PRE-REQUISITOS:
|
|
|
556
607
|
| Node.js | `node --version` | retorna v18+ |
|
|
557
608
|
| Git | `git --version` | retorna versao |
|
|
558
609
|
| GitHub CLI | `gh --version` | retorna versao |
|
|
610
|
+
| Python 3 | `python3 --version` | retorna versao |
|
|
559
611
|
|
|
560
612
|
```
|
|
561
613
|
ESTRUTURA:
|
|
@@ -566,6 +618,7 @@ ESTRUTURA:
|
|
|
566
618
|
| Hooks registrados | ler `.claude/settings.local.json` e verificar `hooks.UserPromptSubmit` | hook existe |
|
|
567
619
|
| Synapse Engine | verificar `.auroq-core/core/synapse/` existe e tem arquivos | existe |
|
|
568
620
|
| Agentes core | verificar `.claude/commands/` tem ops.md + forge.md + {slug do companion}.md | todos existem |
|
|
621
|
+
| Vault protegido | verificar `.gitignore` contem `business/vault/` | contem |
|
|
569
622
|
|
|
570
623
|
```
|
|
571
624
|
CONEXOES:
|
|
@@ -574,11 +627,10 @@ CONEXOES:
|
|
|
574
627
|
|------|----------------------|------|
|
|
575
628
|
| GitHub autenticado | `gh auth status` | mostra usuario logado |
|
|
576
629
|
| GitHub repo criado | `git remote -v` | mostra origin apontando pro repo |
|
|
577
|
-
| Supabase CLI | `supabase --version` | retorna versao |
|
|
578
|
-
| Supabase logado | `supabase projects list 2>/dev/null` | lista projetos (nao da erro de auth) |
|
|
579
|
-
| Supabase chaves | verificar `business/vault/supabase.md` existe e tem conteudo | arquivo tem Project URL + keys |
|
|
580
630
|
| Vercel CLI | `vercel --version 2>/dev/null` | retorna versao |
|
|
581
631
|
| Vercel logada | `vercel whoami 2>/dev/null` | retorna username |
|
|
632
|
+
| Supabase CLI | `supabase --version` | retorna versao |
|
|
633
|
+
| Supabase logado | `supabase projects list 2>/dev/null` | nao da erro de auth |
|
|
582
634
|
|
|
583
635
|
```
|
|
584
636
|
FERRAMENTAS:
|
|
@@ -597,14 +649,6 @@ PERMISSAO:
|
|
|
597
649
|
|------|----------------------|------|
|
|
598
650
|
| Modo auto | ler `~/.claude/settings.json` e verificar `permissions.defaultMode` | valor = "bypassPermissions" |
|
|
599
651
|
|
|
600
|
-
```
|
|
601
|
-
VAULT:
|
|
602
|
-
```
|
|
603
|
-
| Item | Comando de verificacao | ✓ se |
|
|
604
|
-
|------|----------------------|------|
|
|
605
|
-
| Vault existe | verificar `business/vault/` existe | existe |
|
|
606
|
-
| Vault protegido | verificar `.gitignore` contem `business/vault/` | contem |
|
|
607
|
-
|
|
608
652
|
**MONTAR O REPORT:**
|
|
609
653
|
|
|
610
654
|
Depois de rodar TODOS os comandos, apresentar:
|
|
@@ -619,7 +663,7 @@ Depois de rodar TODOS os comandos, apresentar:
|
|
|
619
663
|
RESULTADO: {X} de {total} verificacoes OK
|
|
620
664
|
```
|
|
621
665
|
|
|
622
|
-
**SE tem algum [✗] em item essencial (pre-requisitos,
|
|
666
|
+
**SE tem algum [✗] em item essencial (pre-requisitos, estrutura, conexoes GitHub/Vercel/Supabase):**
|
|
623
667
|
→ NAO dizer que o sistema ta pronto
|
|
624
668
|
→ Dizer: "Tem {N} itens que precisam ser resolvidos antes de comecar. Quer resolver agora?"
|
|
625
669
|
→ Listar os itens com [✗] e oferecer corrigir cada um
|
|
@@ -639,7 +683,8 @@ Salvar report em `.auroq/bootstrap-report.md` pra referencia futura.
|
|
|
639
683
|
| Playwright nao registra | npx nao encontra pacote | `npm cache clean --force` e tentar de novo |
|
|
640
684
|
| `gh auth login` falha | Problema de rede ou browser | Tentar `gh auth login --web` |
|
|
641
685
|
| `supabase login` falha | CLI desatualizada | `brew upgrade supabase` |
|
|
642
|
-
| `
|
|
686
|
+
| `vercel login` falha | CLI desatualizada | `npm update -g vercel` |
|
|
687
|
+
| `rclone config` trava | Problema com OAuth do Google | Tentar em browser diferente |
|
|
643
688
|
| MCP nao aparece em `claude mcp list` | Registro falhou | Verificar .mcp.json e settings.local.json manualmente |
|
|
644
689
|
| Git push rejeitado | Remote nao configurado ou auth expirada | `gh auth refresh` ou `git remote set-url origin {url}` |
|
|
645
690
|
|