auroq-os 2.2.0 → 2.2.2
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 +2 -0
- package/AGENTS.md +42 -23
- package/README.md +17 -5
- package/bin/auroq-os.js +5 -14
- package/package.json +1 -1
|
@@ -215,6 +215,8 @@ O Auroq nao mora no computador — mora no GitHub. Cada maquina e so uma cadeira
|
|
|
215
215
|
- Nunca sincronizar por WhatsApp, Drive ou pendrive — cria copia paralela sem dono
|
|
216
216
|
|
|
217
217
|
**Colaborador (pessoa diferente):**
|
|
218
|
+
- Colaborador NAO precisa ser aluno da mentoria (politica oficial, 05/08/2026). O acesso dele e o convite do GitHub; o `npx auroq-os clone` nao pede login de aluno
|
|
219
|
+
- Quem atualiza o SISTEMA e o dono (o *update-auroq exige aluno ativo) — o colaborador recebe as atualizacoes automaticamente via *sync, porque o update vira commit no repo
|
|
218
220
|
- Regra: CONVITE, NUNCA SENHA. GitHub: Settings > Collaborators (repo continua privado). Claude Code: assinatura PROPRIA dele. Vercel/Supabase: convite pro time SO se mexe em infra
|
|
219
221
|
- Credenciais de squad: cofre separado no 1Password (ex: "Equipe") com SO o que ele precisa — nunca o cofre pessoal do expert
|
|
220
222
|
- Avisar o expert ANTES de convidar: quem entra no repo le TUDO, inclusive a memoria do Companion — e o Companion da maquina do colaborador ESCREVE na mesma memoria. Regua: convida pro repo quem pode ler o diario do negocio. Freelancer pontual entrega por Drive, nao entra no repo
|
package/AGENTS.md
CHANGED
|
@@ -1,10 +1,12 @@
|
|
|
1
|
-
# AGENTS.md — Auroq OS (Codex
|
|
1
|
+
# AGENTS.md — Auroq OS (Claude / Codex / Grok)
|
|
2
2
|
|
|
3
|
-
Este arquivo define as instrucoes do projeto para
|
|
3
|
+
Este arquivo define as instrucoes do projeto para qualquer harness CLI
|
|
4
|
+
suportado: **Claude Code**, **Codex CLI** e **Grok Build**.
|
|
4
5
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
6
|
+
- **Claude Code** e **Grok** carregam `.claude/CLAUDE.md`, `.claude/rules/`,
|
|
7
|
+
`.claude/commands/` e este `AGENTS.md` de forma nativa (Grok via compat Claude).
|
|
8
|
+
- **Codex** nao carrega `.claude/*` sozinho — entao este arquivo replica o
|
|
9
|
+
essencial e as skills em `.agents/skills/` (via sync) completam a descoberta.
|
|
8
10
|
|
|
9
11
|
---
|
|
10
12
|
|
|
@@ -26,7 +28,9 @@ terminal, com agentes especializados pra cada coisa. Constitution formal em
|
|
|
26
28
|
|
|
27
29
|
---
|
|
28
30
|
|
|
29
|
-
## Como ativar os agentes
|
|
31
|
+
## Como ativar os agentes por harness
|
|
32
|
+
|
|
33
|
+
### Codex CLI (`$nome`)
|
|
30
34
|
|
|
31
35
|
As skills ativaveis vivem em `.agents/skills/`, local oficial de skills de
|
|
32
36
|
repositorio do Codex, e sao geradas por
|
|
@@ -35,21 +39,36 @@ negocio e evita colisao entre projetos. A instalacao global existe apenas como
|
|
|
35
39
|
opcao explicita em `~/.agents/skills/` via `npm run sync:codex:global`. Digite `$nome` pra ativar. Depois de
|
|
36
40
|
criar ou atualizar um agente, rode o sync de novo pra a skill aparecer.
|
|
37
41
|
|
|
42
|
+
### Claude Code e Grok Build
|
|
43
|
+
|
|
44
|
+
Nao dependem do sync Codex. Use os comandos em `.claude/commands/`
|
|
45
|
+
(`/auroq-companion`, `/auroq-squad-forge`, etc.) ou peca pra ativar pelo nome
|
|
46
|
+
(`@companion`, "ativa o ops"). Fonte de verdade continua o arquivo do comando e
|
|
47
|
+
a persona em `agents/<nome>/` (Ops: `.claude/commands/AuroqOS/agents/ops.md`).
|
|
48
|
+
|
|
49
|
+
**Grok em especial:** le a camada Claude por padrao e **nao** descobre
|
|
50
|
+
`~/.codex/skills` nem exige `sync:codex`. Se algo so existir como skill Codex e
|
|
51
|
+
nao em `.claude/commands/`, rode o sync Codex no projeto (nao muda o Grok) ou
|
|
52
|
+
ative lendo a persona em `agents/<nome>/` direto.
|
|
53
|
+
|
|
54
|
+
### Tabela de agentes
|
|
55
|
+
|
|
38
56
|
| Agente | Ativacao | O que faz |
|
|
39
57
|
|--------|----------|-----------|
|
|
40
|
-
| Companion | `$companion` | parceiro cognitivo — situa, lembra, pensa junto, roteia |
|
|
41
|
-
| Ops | `$ops` | git, commit, push, deploy, ambiente, `*update` do framework |
|
|
42
|
-
| Organizer | `$organizer` | organizacao e backup do sistema |
|
|
43
|
-
| Consultor | `$consultor` | guia do sistema — "como opero?", "como faço X?", duvidas |
|
|
44
|
-
| Squad Forge | `$squad-forge` | cria squads multi-agente |
|
|
45
|
-
| Mind Forge | `$mind-forge` | cria mentes sinteticas |
|
|
46
|
-
| Worker Forge | `$worker-forge` | cria workers |
|
|
47
|
-
| Clone Forge | `$clone-forge` | clona mentes reais |
|
|
48
|
-
| ETLmaker | `$etlmaker` | extrai e estrutura conhecimento |
|
|
49
|
-
|
|
50
|
-
Qualquer squad/agente que voce criar tambem vira skill no proximo sync
|
|
51
|
-
|
|
52
|
-
|
|
58
|
+
| Companion | `$companion` / `/auroq-companion` | parceiro cognitivo — situa, lembra, pensa junto, roteia |
|
|
59
|
+
| Ops | `$ops` / `@ops` | git, commit, push, deploy, ambiente, `*update` do framework |
|
|
60
|
+
| Organizer | `$organizer` / `/auroq-organizer` | organizacao e backup do sistema |
|
|
61
|
+
| Consultor | `$consultor` / `/auroq-consultor` | guia do sistema — "como opero?", "como faço X?", duvidas |
|
|
62
|
+
| Squad Forge | `$squad-forge` / `/auroq-squad-forge` | cria squads multi-agente |
|
|
63
|
+
| Mind Forge | `$mind-forge` / `/auroq-mind-forge` | cria mentes sinteticas |
|
|
64
|
+
| Worker Forge | `$worker-forge` / `/auroq-worker-forge` | cria workers |
|
|
65
|
+
| Clone Forge | `$clone-forge` / `/auroq-clone-forge` | clona mentes reais |
|
|
66
|
+
| ETLmaker | `$etlmaker` / `/auroq-etlmaker` | extrai e estrutura conhecimento |
|
|
67
|
+
|
|
68
|
+
Qualquer squad/agente que voce criar tambem vira skill no proximo sync Codex;
|
|
69
|
+
no Claude/Grok, garanta o comando correspondente em `.claude/commands/`.
|
|
70
|
+
|
|
71
|
+
**Aceite** `$nome`, `/nome`, `/auroq-nome` e `@nome` como ativacao equivalente:
|
|
53
72
|
leia o arquivo em `.claude/commands/auroq-<nome>.md` (ou
|
|
54
73
|
`.claude/commands/AuroqOS/agents/ops.md` pro Ops), adote a persona e siga as
|
|
55
74
|
instrucoes do arquivo ate `*exit`.
|
|
@@ -58,7 +77,7 @@ instrucoes do arquivo ate `*exit`.
|
|
|
58
77
|
|
|
59
78
|
## Constitution — principios inegociaveis (replica de `.auroq-core/constitution.md`)
|
|
60
79
|
|
|
61
|
-
1. **Centro de comando** — toda operacao passa pelo projeto Auroq no terminal, via Claude Code ou
|
|
80
|
+
1. **Centro de comando** — toda operacao passa pelo projeto Auroq no terminal, via Claude Code, Codex ou Grok. Ferramentas externas (Meta Ads, Hotmart, n8n) sao bracos, nao centros. *(NON-NEGOTIABLE)*
|
|
62
81
|
2. **Cada um faz o seu** — `git commit/push/deploy` e o `*update` do framework sao **EXCLUSIVOS do Ops**. Outro agente delega. *(NON-NEGOTIABLE)*
|
|
63
82
|
3. **Documentar = investir** — todo trabalho significativo vira `.md`. O que nao e documentado, morre. *(MUST)*
|
|
64
83
|
4. **Nao inventar** — fundamenta em KB, instrucao ou plano. Nao gera dado/numero/fato sem fonte. Se precisa mudar o plano, PARA e pergunta. *(MUST)*
|
|
@@ -81,11 +100,11 @@ instrucoes do arquivo ate `*exit`.
|
|
|
81
100
|
|
|
82
101
|
## Comportamento com ferramentas
|
|
83
102
|
|
|
84
|
-
- Prefira as ferramentas nativas do Codex pra arquivo, shell e busca local.
|
|
103
|
+
- Prefira as ferramentas nativas do harness em uso (Claude, Codex ou Grok) pra arquivo, shell e busca local.
|
|
85
104
|
- MCP e infra sao responsabilidade do **Ops**.
|
|
86
|
-
- Nunca use API paga no Claude/Codex onde o plano ja resolve — e dinheiro jogado fora.
|
|
105
|
+
- Nunca use API paga no Claude/Codex/Grok onde o plano ja resolve — e dinheiro jogado fora.
|
|
87
106
|
- Em respostas grandes de ferramenta, filtre ruido e preserve so o relevante.
|
|
88
|
-
- Use um runtime por sessao. Antes de trocar entre Claude Code e
|
|
107
|
+
- Use um runtime por sessao. Antes de trocar entre Claude Code, Codex e Grok, finalize ou documente o estado do trabalho.
|
|
89
108
|
|
|
90
109
|
## Gates da camada hibrida
|
|
91
110
|
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Auroq OS — Sistema Operacional de IA para Experts
|
|
2
2
|
|
|
3
|
-
Transforma Claude Code
|
|
3
|
+
Transforma Claude Code, Codex CLI ou Grok Build num centro de comando inteligente para operar seu negocio digital.
|
|
4
4
|
|
|
5
5
|
**Pensar. Fazer. Lembrar.** Tudo com IA.
|
|
6
6
|
|
|
@@ -10,7 +10,7 @@ Transforma Claude Code ou Codex CLI num centro de comando inteligente para opera
|
|
|
10
10
|
- Mac com Apple Silicon (recomendado)
|
|
11
11
|
- Node.js 22+
|
|
12
12
|
- Git
|
|
13
|
-
- Claude Code ou
|
|
13
|
+
- Claude Code, Codex CLI ou Grok Build (um deles basta)
|
|
14
14
|
|
|
15
15
|
### Setup
|
|
16
16
|
|
|
@@ -32,8 +32,18 @@ codex
|
|
|
32
32
|
|
|
33
33
|
# 4B. Ative o Companion
|
|
34
34
|
$companion
|
|
35
|
+
|
|
36
|
+
# OU 3C. Abra o Grok Build (no diretorio do negocio)
|
|
37
|
+
grok
|
|
38
|
+
|
|
39
|
+
# 4C. Ative o Companion (Grok le .claude/commands nativo — mesmo fluxo do Claude)
|
|
40
|
+
/auroq-companion
|
|
35
41
|
```
|
|
36
42
|
|
|
43
|
+
> **Grok:** nao precisa de `sync:codex`. Ele descobre `.claude/commands/`,
|
|
44
|
+
> `.claude/rules/` e `AGENTS.md` sozinho. Use Claude/Grok com slash commands;
|
|
45
|
+
> use Codex com `$nome` apos o sync de skills.
|
|
46
|
+
|
|
37
47
|
> **Acesso exclusivo para alunos da Mentoria Arcane.** O `init` pede o mesmo email + senha
|
|
38
48
|
> que voce usa em [mentoria-arcane.vercel.app](https://mentoria-arcane.vercel.app).
|
|
39
49
|
> A sessao fica salva em `~/.arcane/credentials.json` e renova automaticamente.
|
|
@@ -72,7 +82,9 @@ claude
|
|
|
72
82
|
|
|
73
83
|
Ritual diario em toda maquina: **sentou → `*sync` · levantou → `*commit` + `*push`**.
|
|
74
84
|
Colaborador usa conta propria de tudo (GitHub via convite, assinatura Claude propria,
|
|
75
|
-
cofre 1Password com escopo) — nunca a senha do dono.
|
|
85
|
+
cofre 1Password com escopo) — nunca a senha do dono. **Colaborador nao precisa ser
|
|
86
|
+
aluno**: o acesso dele e o convite do GitHub (o `clone` nao pede login); quem atualiza
|
|
87
|
+
o sistema e o dono, e o colaborador recebe as atualizacoes via `*sync`.
|
|
76
88
|
|
|
77
89
|
## Estrutura
|
|
78
90
|
|
|
@@ -80,7 +92,7 @@ cofre 1Password com escopo) — nunca a senha do dono.
|
|
|
80
92
|
business/ → Sua empresa (campanhas, processos, agentes)
|
|
81
93
|
docs/knowledge/ → Biblioteca ETL (sua mente, seu negocio, conhecimento)
|
|
82
94
|
agents/ → Seu exercito (companion, workers, minds, squads)
|
|
83
|
-
.claude/ → Ponte Claude Code (agentes, rules, hooks)
|
|
95
|
+
.claude/ → Ponte Claude Code + Grok (agentes, rules, hooks, commands)
|
|
84
96
|
.agents/skills/ → Ponte Codex local (skills geradas por projeto)
|
|
85
97
|
.auroq-core/ → Framework (nao modificar)
|
|
86
98
|
```
|
|
@@ -105,7 +117,7 @@ agents/ → Seu exercito (companion, workers, minds, squads)
|
|
|
105
117
|
|
|
106
118
|
## Primeiro uso
|
|
107
119
|
|
|
108
|
-
1. Ative o Companion (`/auroq-companion` no Claude ou `$companion` no Codex)
|
|
120
|
+
1. Ative o Companion (`/auroq-companion` no Claude/Grok ou `$companion` no Codex)
|
|
109
121
|
2. Preencha os templates em `docs/knowledge/expert-mind/` (quem voce e)
|
|
110
122
|
3. Preencha `docs/knowledge/expert-business/` (o que voce faz)
|
|
111
123
|
4. Pronto — o sistema ja te conhece
|
package/bin/auroq-os.js
CHANGED
|
@@ -681,19 +681,10 @@ async function clone(repoArg) {
|
|
|
681
681
|
process.exit(1);
|
|
682
682
|
}
|
|
683
683
|
|
|
684
|
-
//
|
|
685
|
-
|
|
686
|
-
|
|
687
|
-
|
|
688
|
-
success('Gate de acesso ignorado em ambiente de teste');
|
|
689
|
-
} else {
|
|
690
|
-
try {
|
|
691
|
-
await auth.getValidSession();
|
|
692
|
-
} catch (e) {
|
|
693
|
-
error(`Falha na autenticacao: ${e.message}`);
|
|
694
|
-
process.exit(1);
|
|
695
|
-
}
|
|
696
|
-
}
|
|
684
|
+
// Sem gate de aluno aqui — decisao de produto (05/08/2026): colaborador NAO
|
|
685
|
+
// precisa ser aluno. O gate real do clone e o convite do GitHub (repo privado);
|
|
686
|
+
// um git clone puro ja entregaria o mesmo conteudo. Os gates de aluno ficam
|
|
687
|
+
// onde ha valor do framework: init (criar do zero) e *update-auroq (atualizar).
|
|
697
688
|
|
|
698
689
|
// ─── Fase 2: Resolver o repositorio
|
|
699
690
|
let repoRef = repoArg;
|
|
@@ -810,7 +801,7 @@ ${DIM} Uma vez so, nesta maquina:${RESET}
|
|
|
810
801
|
${CYAN}claude${RESET} ${DIM}ou${RESET} ${CYAN}codex${RESET}
|
|
811
802
|
${CYAN}/AuroqOS:agents:ops${RESET}
|
|
812
803
|
${CYAN}*conectar-1password${RESET} ${DIM}— reconectar o cofre de senhas${RESET}
|
|
813
|
-
${DIM}(se pedir login
|
|
804
|
+
${DIM}(dono do negocio: se o sistema pedir login em algum momento, ${RESET}${CYAN}npx auroq-os login${RESET}${DIM})${RESET}
|
|
814
805
|
|
|
815
806
|
${DIM} Ritual de todo dia, em toda maquina:${RESET}
|
|
816
807
|
|