auroq-os 1.0.8 → 1.0.9
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 +202 -163
- package/package.json +1 -1
|
@@ -203,24 +203,57 @@ 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. 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
|
+
O Ops NUNCA manda o expert rodar comando no terminal. O Ops NUNCA pede pro expert configurar algo tecnico. Se e tecnico, o Ops resolve.
|
|
214
|
+
|
|
215
|
+
**CRITICAL — GATES DE BLOQUEIO:**
|
|
216
|
+
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.
|
|
217
|
+
|
|
218
|
+
Fases essenciais (BLOCKING — nao pular de jeito nenhum):
|
|
219
|
+
- FASE 1 (pre-requisitos): `node --version` + `git --version` + `gh --version` + `python3 --version` TODOS devem retornar versao
|
|
220
|
+
- FASE 2 (permissao): ler `~/.claude/settings.json` e confirmar `defaultMode: bypassPermissions`
|
|
221
|
+
- FASE 3 (estrutura): verificar existencia de TODAS as pastas + agentes core
|
|
222
|
+
- FASE 5 (GitHub): `gh auth status` DEVE retornar usuario logado + `git remote -v` DEVE mostrar origin
|
|
223
|
+
- FASE 6 (Vercel): `vercel whoami` DEVE retornar username
|
|
224
|
+
- FASE 7 (Supabase): `supabase projects list` NAO DEVE dar erro de auth
|
|
225
|
+
|
|
226
|
+
SE qualquer verificacao falhar:
|
|
227
|
+
1. PARAR
|
|
228
|
+
2. Informar o que falhou
|
|
229
|
+
3. Resolver ali na hora (reinstalar, re-autenticar, refazer)
|
|
230
|
+
4. Verificar de novo
|
|
231
|
+
5. SO avancar quando o comando de verificacao PASSAR
|
|
232
|
+
|
|
233
|
+
NUNCA dizer "configurado com sucesso" sem ter rodado o comando de verificacao. NUNCA.
|
|
234
|
+
|
|
206
235
|
---
|
|
207
236
|
|
|
208
237
|
**FASE 1 — PRE-REQUISITOS (obrigatorio)**
|
|
209
238
|
|
|
210
|
-
Verificar e instalar ferramentas base
|
|
239
|
+
Verificar e instalar ferramentas base. O expert so precisa aceitar as instalacoes — Ops faz o resto.
|
|
211
240
|
|
|
212
241
|
| # | Ferramenta | Check | SE nao tem |
|
|
213
242
|
|---|-----------|-------|------------|
|
|
214
243
|
| 1 | **Homebrew** | `brew --version` | `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"` |
|
|
215
244
|
| 2 | **Node.js** (>= 18) | `node --version` | `brew install node` |
|
|
216
245
|
| 3 | **Git** | `git --version` | `brew install git` |
|
|
217
|
-
| 4 | **GitHub CLI** | `gh --version` | `brew install gh`
|
|
246
|
+
| 4 | **GitHub CLI** | `gh --version` | `brew install gh` |
|
|
247
|
+
| 5 | **Python 3** | `python3 --version` | `brew install python` |
|
|
218
248
|
|
|
219
249
|
Apos instalar, configurar git se primeira vez:
|
|
220
250
|
```
|
|
221
251
|
git config --global user.name "Nome do Expert"
|
|
222
252
|
git config --global user.email "email@expert.com"
|
|
223
253
|
```
|
|
254
|
+
→ Perguntar nome e email ao expert pra configurar.
|
|
255
|
+
|
|
256
|
+
→ Check: "Ferramentas base instaladas"
|
|
224
257
|
|
|
225
258
|
---
|
|
226
259
|
|
|
@@ -249,23 +282,12 @@ Configurar automaticamente. **NAO perguntar ao expert. Ops resolve sozinho.**
|
|
|
249
282
|
```
|
|
250
283
|
5. SE ja tem entries no allow (MCPs do expert): PRESERVAR e adicionar as que faltam
|
|
251
284
|
6. Informar ao expert (sem perguntar):
|
|
252
|
-
→ "Modo de permissao configurado —
|
|
285
|
+
→ "Modo de permissao configurado — agora eu executo sem ficar te pedindo confirmacao a cada passo."
|
|
253
286
|
|
|
254
287
|
→ Check: "Modo de permissao: auto (settings.json)"
|
|
255
288
|
|
|
256
289
|
---
|
|
257
290
|
|
|
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
291
|
**FASE 3 — ESTRUTURA DO AUROQ OS**
|
|
270
292
|
|
|
271
293
|
Verificar que todas as pastas essenciais existem:
|
|
@@ -291,11 +313,11 @@ Verificar agentes core:
|
|
|
291
313
|
|
|
292
314
|
---
|
|
293
315
|
|
|
294
|
-
**FASE
|
|
316
|
+
**FASE 4 — MCPs ESSENCIAIS (ferramentas)**
|
|
295
317
|
|
|
296
|
-
Instalar
|
|
318
|
+
Instalar ferramentas que todo expert precisa. NAO inclui servicos (Supabase, Vercel) — esses tem fase propria.
|
|
297
319
|
|
|
298
|
-
###
|
|
320
|
+
### 4.1 Playwright MCP — Chromium (navegador padrao)
|
|
299
321
|
```bash
|
|
300
322
|
npx @playwright/mcp@latest --browser chromium
|
|
301
323
|
```
|
|
@@ -305,20 +327,20 @@ claude mcp add playwright -- npx @playwright/mcp@latest --browser chromium
|
|
|
305
327
|
```
|
|
306
328
|
→ Check: "Playwright Chromium instalado"
|
|
307
329
|
|
|
308
|
-
###
|
|
330
|
+
### 4.2 Playwright MCP — Firefox Nightly (secundario)
|
|
309
331
|
```bash
|
|
310
332
|
claude mcp add playwright-firefox -- npx @playwright/mcp@latest --browser firefox
|
|
311
333
|
```
|
|
312
334
|
→ Check: "Playwright Firefox instalado"
|
|
313
335
|
|
|
314
|
-
###
|
|
336
|
+
### 4.3 yt-dlp (download de videos do YouTube e outros)
|
|
315
337
|
```bash
|
|
316
338
|
brew install yt-dlp
|
|
317
339
|
```
|
|
318
340
|
Verificar: `yt-dlp --version`
|
|
319
341
|
→ Check: "yt-dlp instalado"
|
|
320
342
|
|
|
321
|
-
###
|
|
343
|
+
### 4.4 Whisper local (transcricao de audio/video)
|
|
322
344
|
```bash
|
|
323
345
|
brew install openai-whisper
|
|
324
346
|
```
|
|
@@ -327,26 +349,116 @@ OU se preferir MacWhisper (app com interface):
|
|
|
327
349
|
Verificar: `whisper --help` ou verificar se MacWhisper esta instalado
|
|
328
350
|
→ Check: "Whisper/MacWhisper instalado"
|
|
329
351
|
|
|
330
|
-
|
|
352
|
+
→ Apos instalar: verificar que MCPs estao registrados com `claude mcp list`
|
|
353
|
+
|
|
354
|
+
---
|
|
355
|
+
|
|
356
|
+
**FASE 5 — GITHUB (obrigatorio — ANTES de Vercel e Supabase)**
|
|
357
|
+
|
|
358
|
+
GitHub e a base. Com a conta do GitHub, o expert vai conseguir entrar na Vercel e no Supabase sem criar conta separada.
|
|
359
|
+
|
|
360
|
+
**Ops resolve tudo. Expert so faz login no navegador.**
|
|
361
|
+
|
|
362
|
+
1. Verificar se repo git esta inicializado → SE nao: `git init`
|
|
363
|
+
2. Verificar GitHub CLI: `gh auth status`
|
|
364
|
+
→ SE nao autenticado:
|
|
365
|
+
- Informar: "Vou abrir uma pagina no seu navegador pra voce entrar no GitHub."
|
|
366
|
+
- Rodar `gh auth login --web --git-protocol https` — vai direto pro browser sem perguntas
|
|
367
|
+
- Isso abre o navegador automaticamente
|
|
368
|
+
- SE expert nao tem conta GitHub:
|
|
369
|
+
→ 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."
|
|
370
|
+
- SE expert ja tem conta:
|
|
371
|
+
→ Dizer: "Faz login normalmente. Quando terminar, volta pra essa tela aqui."
|
|
372
|
+
- Verificar sucesso: `gh auth status` — deve mostrar usuario logado
|
|
373
|
+
- SE ainda nao autenticou: esperar e tentar de novo
|
|
374
|
+
3. Criar repo privado no GitHub:
|
|
375
|
+
→ Perguntar: "Qual nome quer dar pro seu repositorio? (sugestao: nome do seu negocio, sem espaco, sem acento)"
|
|
376
|
+
```bash
|
|
377
|
+
gh repo create {nome} --private --source=. --push
|
|
378
|
+
```
|
|
379
|
+
4. Verificar remote: `git remote -v`
|
|
380
|
+
5. Primeiro commit + push:
|
|
381
|
+
```bash
|
|
382
|
+
git add .
|
|
383
|
+
git commit -m "setup: Auroq OS instalado e configurado"
|
|
384
|
+
git push -u origin main
|
|
385
|
+
```
|
|
386
|
+
|
|
387
|
+
**GATE DE VERIFICACAO (BLOCKING — nao avancar sem passar):**
|
|
388
|
+
1. Rodar `gh auth status` — DEVE mostrar "Logged in to github.com as {username}"
|
|
389
|
+
→ SE nao: "GitHub nao ta conectado ainda. Vamos tentar de novo." → REPETIR login
|
|
390
|
+
2. Rodar `git remote -v` — DEVE mostrar origin apontando pro repo
|
|
391
|
+
→ SE nao: "Repo nao foi criado. Vamos criar." → REPETIR criacao
|
|
392
|
+
3. Rodar `git log --oneline -1` — DEVE mostrar pelo menos 1 commit
|
|
393
|
+
→ SE nao: "Primeiro commit nao foi feito." → REPETIR commit + push
|
|
394
|
+
|
|
395
|
+
**SO avancar pra FASE 6 quando os 3 checks passarem.**
|
|
331
396
|
|
|
332
|
-
|
|
397
|
+
→ Check: "GitHub configurado, repo privado criado, primeiro push feito"
|
|
398
|
+
|
|
399
|
+
---
|
|
400
|
+
|
|
401
|
+
**FASE 6 — VERCEL (login com GitHub)**
|
|
402
|
+
|
|
403
|
+
A Vercel hospeda as paginas e apps do expert. Ops resolve tudo — expert so faz login.
|
|
404
|
+
|
|
405
|
+
**IMPORTANTE: O expert JA TEM conta no GitHub (FASE 5). Usar "Continue with GitHub" pra nao criar conta separada.**
|
|
406
|
+
|
|
407
|
+
1. Instalar CLI (se nao tem):
|
|
408
|
+
```bash
|
|
409
|
+
npm install -g vercel
|
|
410
|
+
```
|
|
411
|
+
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."
|
|
412
|
+
3. Rodar `vercel login`
|
|
413
|
+
→ Isso abre o browser automaticamente
|
|
414
|
+
→ Expert clica em "Continue with GitHub"
|
|
415
|
+
→ Autoriza o acesso
|
|
416
|
+
→ Volta pro terminal
|
|
417
|
+
4. Verificar sucesso: `vercel whoami` — deve retornar username
|
|
418
|
+
→ SE falhou: "Parece que o login nao completou. Vou tentar de novo." → repetir
|
|
419
|
+
5. Salvar automaticamente em `business/vault/vercel.md`:
|
|
420
|
+
```markdown
|
|
421
|
+
# Vercel
|
|
422
|
+
**Username:** {resultado do whoami}
|
|
423
|
+
**Configurado em:** {data}
|
|
424
|
+
```
|
|
425
|
+
**GATE DE VERIFICACAO (BLOCKING):**
|
|
426
|
+
1. Rodar `vercel whoami` — DEVE retornar username
|
|
427
|
+
→ SE retorna "Error" ou nao retorna nada: "Vercel nao ta conectada. Vamos tentar de novo." → REPETIR login
|
|
428
|
+
2. Verificar `business/vault/vercel.md` existe e tem conteudo
|
|
429
|
+
→ SE nao: criar o arquivo com os dados do whoami
|
|
430
|
+
|
|
431
|
+
**SO avancar pra FASE 7 quando os 2 checks passarem.**
|
|
432
|
+
|
|
433
|
+
→ Check: "Vercel conectada"
|
|
434
|
+
|
|
435
|
+
---
|
|
436
|
+
|
|
437
|
+
**FASE 7 — SUPABASE (login com GitHub)**
|
|
438
|
+
|
|
439
|
+
O Supabase e o banco de dados do expert. Ops resolve tudo — expert so faz login.
|
|
440
|
+
|
|
441
|
+
**IMPORTANTE: O expert JA TEM conta no GitHub (FASE 5). Usar "Continue with GitHub" pra nao criar conta separada.**
|
|
333
442
|
|
|
334
443
|
1. Instalar CLI (se nao tem):
|
|
335
444
|
```bash
|
|
336
445
|
brew install supabase/tap/supabase
|
|
337
446
|
```
|
|
338
|
-
2.
|
|
339
|
-
|
|
340
|
-
→
|
|
341
|
-
→
|
|
342
|
-
→
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
447
|
+
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."
|
|
448
|
+
3. Rodar `supabase login`
|
|
449
|
+
→ Isso abre o browser automaticamente
|
|
450
|
+
→ Expert clica em "Continue with GitHub"
|
|
451
|
+
→ Autoriza o acesso
|
|
452
|
+
→ Volta pro terminal
|
|
453
|
+
4. Verificar sucesso: `supabase projects list` — SE nao da erro de auth, ta logado
|
|
454
|
+
→ SE falhou: "Parece que o login nao completou. Vou tentar de novo." → repetir
|
|
455
|
+
5. SE expert ja tem projeto: listar e pedir pra escolher
|
|
456
|
+
SE nao tem projeto: "Voce ainda nao tem projeto no Supabase. Quando precisar, seu Companion te ajuda a criar. Por enquanto ta conectado."
|
|
457
|
+
6. SE tem projeto selecionado — capturar chaves automaticamente:
|
|
346
458
|
→ Usar Playwright: navegar pra `https://supabase.com/dashboard/project/{ref}/settings/api`
|
|
347
459
|
→ Extrair Project URL, Anon Key e Service Key da pagina
|
|
348
|
-
→ SE Playwright falhar: pedir pro
|
|
349
|
-
|
|
460
|
+
→ SE Playwright falhar: pedir pro expert copiar as 3 chaves da tela
|
|
461
|
+
7. Salvar automaticamente em `business/vault/supabase.md`:
|
|
350
462
|
```markdown
|
|
351
463
|
# Supabase
|
|
352
464
|
**Project URL:** {url}
|
|
@@ -355,156 +467,89 @@ Verificar: `whisper --help` ou verificar se MacWhisper esta instalado
|
|
|
355
467
|
**Projeto:** {nome}
|
|
356
468
|
**Configurado em:** {data}
|
|
357
469
|
```
|
|
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`:
|
|
470
|
+
SE nao tem projeto ainda: salvar so o status de conexao:
|
|
374
471
|
```markdown
|
|
375
|
-
#
|
|
376
|
-
**
|
|
472
|
+
# Supabase
|
|
473
|
+
**Status:** Conectado (sem projeto ainda)
|
|
377
474
|
**Configurado em:** {data}
|
|
378
475
|
```
|
|
379
|
-
→ Check: "Vercel conectada e registrada no vault"
|
|
380
476
|
|
|
381
|
-
|
|
477
|
+
**GATE DE VERIFICACAO (BLOCKING):**
|
|
478
|
+
1. Rodar `supabase projects list 2>&1` — NAO DEVE conter "Error" ou "unauthorized"
|
|
479
|
+
→ SE da erro de auth: "Supabase nao ta conectado. Vamos tentar de novo." → REPETIR login
|
|
480
|
+
2. SE tem projeto com chaves: verificar `business/vault/supabase.md` existe e tem Project URL
|
|
481
|
+
→ SE nao: capturar chaves ou criar arquivo minimo
|
|
482
|
+
|
|
483
|
+
**SO avancar pra FASE 8 quando os checks passarem.**
|
|
484
|
+
|
|
485
|
+
→ Check: "Supabase conectado"
|
|
382
486
|
|
|
383
487
|
---
|
|
384
488
|
|
|
385
|
-
**FASE
|
|
489
|
+
**FASE 8 — CONEXOES OPCIONAIS (expert escolhe)**
|
|
490
|
+
|
|
491
|
+
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
492
|
|
|
387
|
-
|
|
493
|
+
Listar:
|
|
494
|
+
1. **Google Drive** (recomendado — necessario pra acessar seus arquivos)
|
|
495
|
+
2. **Gmail** (ler e enviar emails pelo sistema)
|
|
496
|
+
3. **WhatsApp** (ler e enviar mensagens)
|
|
497
|
+
4. **N8N** (automacoes avancadas)
|
|
498
|
+
5. **Notion** (acessar suas paginas)
|
|
499
|
+
6. **Nenhuma por enquanto** — pode fazer depois
|
|
388
500
|
|
|
389
|
-
###
|
|
390
|
-
SE expert quer (recomendado — necessario pra acessar arquivos no Drive, baixar conteudo pra ETL, etc.):
|
|
501
|
+
### 8.1 Google Drive (via rclone) — RECOMENDADO
|
|
391
502
|
1. `brew install rclone`
|
|
392
503
|
2. `rclone config`
|
|
393
504
|
→ Guiar: "New remote" → nome: "drive" → tipo: "Google Drive"
|
|
394
|
-
→ Vai abrir
|
|
505
|
+
→ Informar: "Vai abrir o navegador pra voce autorizar o acesso ao seu Drive."
|
|
395
506
|
→ Confirmar acesso
|
|
396
|
-
3. Testar: `rclone ls drive: --max-depth 1`
|
|
397
|
-
|
|
398
|
-
→ Check: "Google Drive conectado via rclone"
|
|
507
|
+
3. Testar: `rclone ls drive: --max-depth 1`
|
|
508
|
+
→ Check: "Google Drive conectado"
|
|
399
509
|
|
|
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
|
|
510
|
+
### 8.2 Gmail MCP
|
|
511
|
+
1. ```bash
|
|
408
512
|
claude mcp add gmail -- npx gmail-mcp-server
|
|
409
513
|
```
|
|
410
|
-
2. Vai
|
|
411
|
-
3. Guiar
|
|
514
|
+
2. Informar: "Vai abrir o navegador pra voce autorizar o acesso ao seu Gmail."
|
|
515
|
+
3. Guiar pelo flow de autenticacao
|
|
412
516
|
4. Testar: listar ultimos 5 emails
|
|
413
517
|
→ Check: "Gmail conectado" ou "Pulado"
|
|
414
518
|
|
|
415
|
-
###
|
|
416
|
-
|
|
417
|
-
1. Clonar servidor WhatsApp MCP:
|
|
519
|
+
### 8.3 WhatsApp MCP
|
|
520
|
+
1. Instalar:
|
|
418
521
|
```bash
|
|
419
522
|
git clone https://github.com/anthropics/whatsapp-mcp.git ~/whatsapp-mcp
|
|
420
523
|
cd ~/whatsapp-mcp && pip install -r requirements.txt
|
|
421
524
|
```
|
|
422
|
-
OU se ja tem instalado, verificar path
|
|
423
525
|
2. Registrar:
|
|
424
526
|
```bash
|
|
425
527
|
claude mcp add whatsapp -- python3 ~/whatsapp-mcp/main.py
|
|
426
528
|
```
|
|
427
|
-
3. Vai
|
|
428
|
-
4.
|
|
429
|
-
5. Testar: listar chats recentes
|
|
529
|
+
3. Informar: "Vai aparecer um QR Code na tela. Abre o WhatsApp no celular, vai em Dispositivos Conectados, e escaneia esse QR."
|
|
530
|
+
4. Testar: listar chats recentes
|
|
430
531
|
→ Check: "WhatsApp conectado" ou "Pulado"
|
|
431
532
|
|
|
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`
|
|
533
|
+
### 8.4 N8N (automacoes)
|
|
534
|
+
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."
|
|
535
|
+
2. SE ja tem instancia:
|
|
536
|
+
→ Pegar Base URL e API Key
|
|
537
|
+
3. Salvar em `business/vault/n8n.md`
|
|
538
|
+
4. Testar conexao
|
|
447
539
|
→ Check: "N8N conectado" ou "Pulado"
|
|
448
540
|
|
|
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
|
|
541
|
+
### 8.5 Notion (via Claude.ai)
|
|
542
|
+
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."
|
|
543
|
+
2. Verificar que aparece nos MCPs
|
|
455
544
|
→ Check: "Notion conectado" ou "Pulado"
|
|
456
545
|
|
|
457
546
|
---
|
|
458
547
|
|
|
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**
|
|
548
|
+
**FASE 9 — PERSONALIZAR COMPANION**
|
|
504
549
|
|
|
505
550
|
O Companion e o cerebro do sistema — parceiro cognitivo do expert. Vem com nome generico "Companion" mas o expert escolhe o nome.
|
|
506
551
|
|
|
507
|
-
1. Perguntar: "
|
|
552
|
+
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
553
|
|
|
509
554
|
2. Expert escolhe o nome. Salvar em variavel {NOME}.
|
|
510
555
|
|
|
@@ -525,23 +570,23 @@ O Companion e o cerebro do sistema — parceiro cognitivo do expert. Vem com nom
|
|
|
525
570
|
- `.claude/CLAUDE.md` — trocar "Companion" por {NOME} e ativacao de `/companion` pra `/{slug}`
|
|
526
571
|
- `.claude/rules/` — trocar referencias ao "Companion" pelo {NOME} onde aparecer
|
|
527
572
|
|
|
528
|
-
6. Confirmar: "Seu
|
|
573
|
+
6. Confirmar: "Pronto! Seu parceiro agora se chama {NOME}. Pra ativar ele, e so digitar /{slug}"
|
|
529
574
|
|
|
530
575
|
→ Check: "Companion personalizado: {NOME} — ativacao: /{slug}"
|
|
531
576
|
|
|
532
577
|
---
|
|
533
578
|
|
|
534
|
-
**FASE
|
|
579
|
+
**FASE 10 — SETUP DO EXPERT (se primeira vez)**
|
|
535
580
|
|
|
536
581
|
1. Verificar se `docs/knowledge/expert-mind/identidade.md` tem conteudo
|
|
537
|
-
→ SE vazio: "Voce ainda nao preencheu seu perfil. O {NOME} te
|
|
582
|
+
→ 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
583
|
2. Verificar se `business/cockpit.md` tem projetos
|
|
539
|
-
→ SE vazio: "Voce nao tem projetos ainda.
|
|
540
|
-
→ Check: "Perfil preenchido" ou "Pendente (
|
|
584
|
+
→ SE vazio: "Voce nao tem projetos ainda. Quando ativar o {NOME}, ele ajuda a criar o primeiro."
|
|
585
|
+
→ Check: "Perfil preenchido" ou "Pendente ({NOME} guia depois)"
|
|
541
586
|
|
|
542
587
|
---
|
|
543
588
|
|
|
544
|
-
**FASE
|
|
589
|
+
**FASE 11 — HEALTH REPORT FINAL (VERIFICACAO REAL)**
|
|
545
590
|
|
|
546
591
|
**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
592
|
|
|
@@ -556,6 +601,7 @@ PRE-REQUISITOS:
|
|
|
556
601
|
| Node.js | `node --version` | retorna v18+ |
|
|
557
602
|
| Git | `git --version` | retorna versao |
|
|
558
603
|
| GitHub CLI | `gh --version` | retorna versao |
|
|
604
|
+
| Python 3 | `python3 --version` | retorna versao |
|
|
559
605
|
|
|
560
606
|
```
|
|
561
607
|
ESTRUTURA:
|
|
@@ -566,6 +612,7 @@ ESTRUTURA:
|
|
|
566
612
|
| Hooks registrados | ler `.claude/settings.local.json` e verificar `hooks.UserPromptSubmit` | hook existe |
|
|
567
613
|
| Synapse Engine | verificar `.auroq-core/core/synapse/` existe e tem arquivos | existe |
|
|
568
614
|
| Agentes core | verificar `.claude/commands/` tem ops.md + forge.md + {slug do companion}.md | todos existem |
|
|
615
|
+
| Vault protegido | verificar `.gitignore` contem `business/vault/` | contem |
|
|
569
616
|
|
|
570
617
|
```
|
|
571
618
|
CONEXOES:
|
|
@@ -574,11 +621,10 @@ CONEXOES:
|
|
|
574
621
|
|------|----------------------|------|
|
|
575
622
|
| GitHub autenticado | `gh auth status` | mostra usuario logado |
|
|
576
623
|
| 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
624
|
| Vercel CLI | `vercel --version 2>/dev/null` | retorna versao |
|
|
581
625
|
| Vercel logada | `vercel whoami 2>/dev/null` | retorna username |
|
|
626
|
+
| Supabase CLI | `supabase --version` | retorna versao |
|
|
627
|
+
| Supabase logado | `supabase projects list 2>/dev/null` | nao da erro de auth |
|
|
582
628
|
|
|
583
629
|
```
|
|
584
630
|
FERRAMENTAS:
|
|
@@ -597,14 +643,6 @@ PERMISSAO:
|
|
|
597
643
|
|------|----------------------|------|
|
|
598
644
|
| Modo auto | ler `~/.claude/settings.json` e verificar `permissions.defaultMode` | valor = "bypassPermissions" |
|
|
599
645
|
|
|
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
646
|
**MONTAR O REPORT:**
|
|
609
647
|
|
|
610
648
|
Depois de rodar TODOS os comandos, apresentar:
|
|
@@ -619,7 +657,7 @@ Depois de rodar TODOS os comandos, apresentar:
|
|
|
619
657
|
RESULTADO: {X} de {total} verificacoes OK
|
|
620
658
|
```
|
|
621
659
|
|
|
622
|
-
**SE tem algum [✗] em item essencial (pre-requisitos,
|
|
660
|
+
**SE tem algum [✗] em item essencial (pre-requisitos, estrutura, conexoes GitHub/Vercel/Supabase):**
|
|
623
661
|
→ NAO dizer que o sistema ta pronto
|
|
624
662
|
→ Dizer: "Tem {N} itens que precisam ser resolvidos antes de comecar. Quer resolver agora?"
|
|
625
663
|
→ Listar os itens com [✗] e oferecer corrigir cada um
|
|
@@ -639,7 +677,8 @@ Salvar report em `.auroq/bootstrap-report.md` pra referencia futura.
|
|
|
639
677
|
| Playwright nao registra | npx nao encontra pacote | `npm cache clean --force` e tentar de novo |
|
|
640
678
|
| `gh auth login` falha | Problema de rede ou browser | Tentar `gh auth login --web` |
|
|
641
679
|
| `supabase login` falha | CLI desatualizada | `brew upgrade supabase` |
|
|
642
|
-
| `
|
|
680
|
+
| `vercel login` falha | CLI desatualizada | `npm update -g vercel` |
|
|
681
|
+
| `rclone config` trava | Problema com OAuth do Google | Tentar em browser diferente |
|
|
643
682
|
| MCP nao aparece em `claude mcp list` | Registro falhou | Verificar .mcp.json e settings.local.json manualmente |
|
|
644
683
|
| Git push rejeitado | Remote nao configurado ou auth expirada | `gh auth refresh` ou `git remote set-url origin {url}` |
|
|
645
684
|
|