auroq-os 2.1.4 → 2.1.6
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
|
@@ -258,6 +258,19 @@ O Auroq OS carrega regras de `.claude/rules/` automaticamente.
|
|
|
258
258
|
| `commit-inteligente.md` | Ritual de checkpoint do negocio |
|
|
259
259
|
| `tool-response-filtering.md` | Reducao de tokens em respostas MCP |
|
|
260
260
|
| `natural-language-first.md` | Linguagem natural como interface primaria — nunca exigir comandos |
|
|
261
|
+
| `custom-do-aluno.md` | **Suas regras** — sobrevive a updates, nunca e sobrescrito |
|
|
262
|
+
|
|
263
|
+
### Onde customizar (sobrevive a updates)
|
|
264
|
+
|
|
265
|
+
O update do Auroq OS atualiza o framework — `CLAUDE.md`, as rules acima, o companion.
|
|
266
|
+
Se voce editar esses arquivos direto, sua mudanca e perdida no proximo update.
|
|
267
|
+
|
|
268
|
+
Os UNICOS lugares de config que o update **preserva** sao:
|
|
269
|
+
|
|
270
|
+
- **`.claude/rules/custom-do-aluno.md`** — regras de comportamento e overrides seus
|
|
271
|
+
- **`.claude/settings.local.json`** — suas configuracoes locais
|
|
272
|
+
|
|
273
|
+
Coloque suas customizacoes la. O Auroq carrega tudo de `.claude/rules/` automaticamente.
|
|
261
274
|
|
|
262
275
|
## Niveis de Sofisticacao (N0-N3)
|
|
263
276
|
|
|
@@ -883,26 +883,44 @@ Conexoes extras — OPCIONAL, RECOMENDADO. Roda depois do bootstrap principal, q
|
|
|
883
883
|
|
|
884
884
|
#### 1. Cloudflare — dominio proprio
|
|
885
885
|
|
|
886
|
-
**O que e:** o Cloudflare gerencia
|
|
886
|
+
**O que e:** o Cloudflare gerencia o(s) dominio(s) do negocio (o endereco, tipo seunegocio.com). Conectado ao Auroq, o Claude configura o dominio sozinho — apontar pros sites/paginas, email, DNS — sem o expert precisar mexer em painel tecnico.
|
|
887
887
|
|
|
888
|
-
**
|
|
888
|
+
**O que o aluno entende ANTES de comecar (explicar com calma):** esse dominio e o endereco proprio dos sites dele (a marca dele no ar, no lugar de um link generico). Ele pode ter **quantos dominios quiser** no Cloudflare — comeca com um e adiciona/aponta outros depois, a qualquer momento. Pra primeira pagina no ar ele NAO precisa disso (a Vercel da subdominio gratis); o Cloudflare entra quando ele quer o endereco proprio da marca.
|
|
889
889
|
|
|
890
|
-
|
|
891
|
-
|
|
892
|
-
|
|
893
|
-
|
|
894
|
-
|
|
895
|
-
|
|
896
|
-
|
|
897
|
-
|
|
898
|
-
|
|
890
|
+
---
|
|
891
|
+
|
|
892
|
+
**PASSO 1 — Criar conta no Cloudflare**
|
|
893
|
+
|
|
894
|
+
Guiar o aluno a criar a conta em cloudflare.com (email + senha, confirmar email). Linguagem de leigo, um clique por vez. Se travar, pedir print da tela.
|
|
895
|
+
|
|
896
|
+
**PASSO 2 — Colocar um dominio na conta (dois caminhos)**
|
|
897
|
+
|
|
898
|
+
Perguntar primeiro: **"Voce ja tem um dominio que importa pra voce, ou prefere comprar um novo agora?"**
|
|
899
|
+
|
|
900
|
+
**Caminho A — Ja tem um dominio (apontar pra Cloudflare):**
|
|
901
|
+
- Esse caminho e GUIADO VIA UI, com o aluno **tirando print da tela e mandando aqui no Claude Code**. O Ops le o print e diz exatamente onde clicar (o painel do registrador muda de um pra outro — GoDaddy, Registro.br, Hostinger — entao guiar pela imagem, nao de cabeca).
|
|
902
|
+
- Fluxo: no Cloudflare, "Add a site" → digitar o dominio → Cloudflare mostra **2 nameservers** → o aluno entra no painel ONDE o dominio foi comprado (o registrador) e **troca os nameservers** pelos do Cloudflare → volta no Cloudflare e confirma. A propagacao pode levar de minutos a algumas horas.
|
|
903
|
+
- **IMPORTANTE — o Ops nao clica por ele aqui.** O painel do registrador e FORA do MCP. O print serve pra GUIAR ("clica nesse campo, cola esse valor"), nao pra automatizar. Depois que o dominio cai na Cloudflare, o MCP assume o resto.
|
|
904
|
+
|
|
905
|
+
**Caminho B — Comprar um dominio novo (RECOMENDADO, mais rapido):**
|
|
906
|
+
- Comprar o dominio **direto no Cloudflare** (Registrar) — preco de custo, sem marcacao na renovacao, e ja nasce conectado (PULA o passo dos nameservers). Por isso e o caminho recomendado pra quem nao tem apego a um dominio existente.
|
|
907
|
+
- Explicar que esse e o dominio que vai ser usado **pros sites dele** — e que ele pode comprar mais de um aqui mesmo, ou apontar outros que ele tenha (Caminho A) depois.
|
|
908
|
+
- **LIMITE QUE PRECISA SER DITO:** o Cloudflare Registrar vende `.com`, `.net`, `.io`, `.co`, etc. — mas **NAO vende `.com.br` (nem ccTLD brasileiro)**. Se o aluno quer especificamente um `.com.br`, ele compra no Registro.br e cai no Caminho A (apontar). Confirmar a disponibilidade do TLD na hora antes de prometer.
|
|
909
|
+
|
|
910
|
+
> Se o aluno nao tem dominio e nao quer comprar agora: pular o Cloudflare (faz quando tiver). Nao bloqueia nada.
|
|
911
|
+
|
|
912
|
+
**PASSO 3 — Conectar ao Claude Code via MCP oficial do Cloudflare**
|
|
913
|
+
- Registrar com `claude mcp add` apontando pro servidor MCP **oficial** do Cloudflare (endpoint atual em developers.cloudflare.com — secao Agents/MCP). NUNCA editar o JSON de config na mao; sempre `claude mcp add`.
|
|
914
|
+
- Depois o expert digita `/mcp` e aperta Enter → abre o navegador pra logar no Cloudflare e autorizar.
|
|
915
|
+
|
|
916
|
+
**PASSO 4 — Salvar o status** em `business/vault/cloudflare.md` (conta criada, dominio(s) na conta, MCP conectado).
|
|
899
917
|
|
|
900
918
|
**GATE DE VERIFICACAO (BLOCKING):**
|
|
901
919
|
1. `claude mcp list` mostra o cloudflare
|
|
902
|
-
2. O Claude consegue listar as zonas/dominios da conta (teste real)
|
|
920
|
+
2. O Claude consegue listar as zonas/dominios da conta (teste real) — e o(s) dominio(s) esperado(s) aparecem
|
|
903
921
|
→ SE falhar: re-autenticar via `/mcp`; se persistir, conferir o endpoint do MCP nas docs do Cloudflare.
|
|
904
922
|
|
|
905
|
-
→ Check: "Cloudflare conectado" ou "Pulado (sem dominio ainda)"
|
|
923
|
+
→ Check: "Cloudflare conectado ({N} dominio(s) na conta)" ou "Pulado (sem dominio ainda)"
|
|
906
924
|
|
|
907
925
|
---
|
|
908
926
|
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# Suas Customizações — Sobrevivem a Updates
|
|
2
|
+
|
|
3
|
+
> Este arquivo é SEU. O update do Auroq OS (e do Pack Arcane) **nunca** sobrescreve ele.
|
|
4
|
+
> Tudo que você quer que valha pra sempre — regras de comportamento, preferências,
|
|
5
|
+
> overrides — escreve AQUI, não no CLAUDE.md nem nas outras rules.
|
|
6
|
+
|
|
7
|
+
## Por que aqui e não no CLAUDE.md?
|
|
8
|
+
|
|
9
|
+
O `CLAUDE.md` e as outras rules (`agent-authority.md`, `natural-language-first.md`, etc.)
|
|
10
|
+
são **framework** — toda atualização do Auroq atualiza elas pra trazer melhorias. Se você
|
|
11
|
+
editar uma delas direto, sua mudança é perdida no próximo update.
|
|
12
|
+
|
|
13
|
+
Este arquivo (`custom-do-aluno.md`) e o `settings.local.json` são os únicos lugares de
|
|
14
|
+
config que o update **preserva**. Coloque suas regras aqui.
|
|
15
|
+
|
|
16
|
+
## Como escrever uma regra
|
|
17
|
+
|
|
18
|
+
Linguagem natural, direto. O Auroq carrega este arquivo automaticamente junto com as
|
|
19
|
+
outras rules. Exemplos:
|
|
20
|
+
|
|
21
|
+
- "Quando eu pedir pra rodar algo, executa direto sem ficar pedindo confirmação a cada passo."
|
|
22
|
+
- "Nunca commita sem eu mandar."
|
|
23
|
+
- "Responde sempre em português, casual."
|
|
24
|
+
|
|
25
|
+
## Suas regras
|
|
26
|
+
|
|
27
|
+
<!-- Escreva abaixo. Apague estes exemplos quando colocar as suas. -->
|
package/bin/auroq-os.js
CHANGED
|
@@ -194,6 +194,7 @@ async function init() {
|
|
|
194
194
|
'.claude/rules/project-tracker.md',
|
|
195
195
|
'.claude/rules/tool-response-filtering.md',
|
|
196
196
|
'.claude/rules/natural-language-first.md',
|
|
197
|
+
'.claude/rules/custom-do-aluno.md',
|
|
197
198
|
|
|
198
199
|
// Hooks
|
|
199
200
|
'.claude/hooks/synapse-engine.cjs',
|
|
@@ -267,6 +268,10 @@ async function init() {
|
|
|
267
268
|
|
|
268
269
|
// Arquivos do ALUNO — nunca sobrescrever se ja existem
|
|
269
270
|
const studentFiles = [
|
|
271
|
+
// Config/customizacao pessoal — o lugar oficial pra regras e overrides do aluno.
|
|
272
|
+
// O update do framework cria a semente na 1a vez e NUNCA mais toca.
|
|
273
|
+
'.claude/rules/custom-do-aluno.md',
|
|
274
|
+
'.claude/settings.local.json',
|
|
270
275
|
'agents/companion/data/contexto-dinamico.md',
|
|
271
276
|
'agents/companion/data/log-decisoes.md',
|
|
272
277
|
'agents/companion/data/padroes-observados.md',
|
|
@@ -503,6 +508,10 @@ ${DIM} Proximo passo:${RESET}
|
|
|
503
508
|
|
|
504
509
|
${DIM} O Companion vai te receber e guiar a partir daqui.${RESET}
|
|
505
510
|
|
|
511
|
+
${DIM} Suas customizacoes (sobrevivem a todo update):${RESET}
|
|
512
|
+
${CYAN}.claude/rules/custom-do-aluno.md${RESET} ${DIM}— suas regras e overrides${RESET}
|
|
513
|
+
${CYAN}.claude/settings.local.json${RESET} ${DIM}— suas configuracoes locais${RESET}
|
|
514
|
+
|
|
506
515
|
${DIM} Agentes core disponiveis:${RESET}
|
|
507
516
|
${PURPLE}/companion${RESET} ${DIM}— Parceiro cognitivo${RESET}
|
|
508
517
|
${PURPLE}/AuroqOS:agents:ops${RESET} ${DIM}— Git, deploy, ambiente${RESET}
|