auroq-os 2.2.1 → 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/AGENTS.md +42 -23
- package/README.md +14 -4
- package/package.json +1 -1
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.
|
|
@@ -82,7 +92,7 @@ o sistema e o dono, e o colaborador recebe as atualizacoes via `*sync`.
|
|
|
82
92
|
business/ → Sua empresa (campanhas, processos, agentes)
|
|
83
93
|
docs/knowledge/ → Biblioteca ETL (sua mente, seu negocio, conhecimento)
|
|
84
94
|
agents/ → Seu exercito (companion, workers, minds, squads)
|
|
85
|
-
.claude/ → Ponte Claude Code (agentes, rules, hooks)
|
|
95
|
+
.claude/ → Ponte Claude Code + Grok (agentes, rules, hooks, commands)
|
|
86
96
|
.agents/skills/ → Ponte Codex local (skills geradas por projeto)
|
|
87
97
|
.auroq-core/ → Framework (nao modificar)
|
|
88
98
|
```
|
|
@@ -107,7 +117,7 @@ agents/ → Seu exercito (companion, workers, minds, squads)
|
|
|
107
117
|
|
|
108
118
|
## Primeiro uso
|
|
109
119
|
|
|
110
|
-
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)
|
|
111
121
|
2. Preencha os templates em `docs/knowledge/expert-mind/` (quem voce e)
|
|
112
122
|
3. Preencha `docs/knowledge/expert-business/` (o que voce faz)
|
|
113
123
|
4. Pronto — o sistema ja te conhece
|