auroq-os 2.2.2 → 2.3.0

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.
Files changed (215) hide show
  1. package/.auroq-core/constitution.md +11 -151
  2. package/.auroq-core/core-config.yaml +1 -1
  3. package/.auroq-core/dna-operacional.md +9 -131
  4. package/.claude/CLAUDE.md +5 -466
  5. package/.claude/commands/AuroqOS/agents/ops.md +4 -1781
  6. package/.claude/commands/auroq-clone-forge.md +3 -3
  7. package/.claude/commands/auroq-companion.md +3 -3
  8. package/.claude/commands/auroq-consultor.md +4 -4
  9. package/.claude/commands/auroq-etlmaker.md +3 -3
  10. package/.claude/commands/auroq-mind-forge.md +4 -4
  11. package/.claude/commands/auroq-squad-forge.md +3 -3
  12. package/.claude/commands/auroq-worker-forge.md +4 -4
  13. package/.claude/hooks/auroq-sync.cjs +127 -0
  14. package/.claude/output-styles/direto.md +19 -0
  15. package/.claude/rules/agent-authority.md +8 -6
  16. package/.claude/rules/evolucao-incremental.md +8 -20
  17. package/.claude/rules/mcp-usage.md +10 -18
  18. package/.claude/rules/operacao-autonoma.md +29 -0
  19. package/.claude/rules/puxar-e-entregar.md +31 -0
  20. package/.claude/settings.json +22 -1
  21. package/.gitignore +4 -0
  22. package/AGENTS.md +10 -119
  23. package/README.md +8 -7
  24. package/bin/auroq-os.js +68 -18
  25. package/lib/auth.js +6 -6
  26. package/lib/credentials.js +13 -1
  27. package/package.json +18 -8
  28. package/scripts/postpack-casca.mjs +32 -0
  29. package/scripts/prepack-casca.mjs +47 -0
  30. package/scripts/validate-hybrid.mjs +2 -0
  31. package/.auroq-core/development/sistema-gestao-projetos.md +0 -193
  32. package/.auroq-core/development/sistema-memoria.md +0 -157
  33. package/agents/clone-forge/.state.json +0 -7
  34. package/agents/clone-forge/README.md +0 -81
  35. package/agents/clone-forge/agents/clone-forge-chief.md +0 -885
  36. package/agents/clone-forge/agents/cognitive-motor.md +0 -384
  37. package/agents/clone-forge/agents/innerlens.md +0 -453
  38. package/agents/clone-forge/checklists/clone-forge-validation.md +0 -160
  39. package/agents/clone-forge/checklists/driver-quality-gate.md +0 -79
  40. package/agents/clone-forge/checklists/miu-quality-gate.md +0 -86
  41. package/agents/clone-forge/checklists/psychometric-quality-gate.md +0 -76
  42. package/agents/clone-forge/checklists/smoke-test-clone.md +0 -313
  43. package/agents/clone-forge/config.yaml +0 -221
  44. package/agents/clone-forge/data/clone-anti-patterns.yaml +0 -148
  45. package/agents/clone-forge/data/clone-forge-kb.md +0 -106
  46. package/agents/clone-forge/data/clone-validation.yaml +0 -190
  47. package/agents/clone-forge/data/driver-catalog.yaml +0 -2595
  48. package/agents/clone-forge/data/driver-relationship-templates.yaml +0 -242
  49. package/agents/clone-forge/data/miu-classification-taxonomy.yaml +0 -273
  50. package/agents/clone-forge/data/output-examples.yaml +0 -102
  51. package/agents/clone-forge/data/poc-schema.yaml +0 -320
  52. package/agents/clone-forge/data/psychometric-systems.yaml +0 -1514
  53. package/agents/clone-forge/data/source-tiers.yaml +0 -119
  54. package/agents/clone-forge/data/source-type-handlers.yaml +0 -282
  55. package/agents/clone-forge/tasks/aggregate-profile.md +0 -519
  56. package/agents/clone-forge/tasks/clone-review.md +0 -105
  57. package/agents/clone-forge/tasks/collect-and-merge-sources.md +0 -621
  58. package/agents/clone-forge/tasks/deep-interview.md +0 -737
  59. package/agents/clone-forge/tasks/extract-dna-enriched.md +0 -371
  60. package/agents/clone-forge/tasks/extract-mius.md +0 -1018
  61. package/agents/clone-forge/tasks/extract-thinking-dna.md +0 -654
  62. package/agents/clone-forge/tasks/extract-voice-dna.md +0 -620
  63. package/agents/clone-forge/tasks/fidelity-score.md +0 -109
  64. package/agents/clone-forge/tasks/gap-analysis-questionnaire.md +0 -517
  65. package/agents/clone-forge/tasks/generate-agent-from-profile.md +0 -874
  66. package/agents/clone-forge/tasks/infer-drivers.md +0 -431
  67. package/agents/clone-forge/tasks/ingest-local-content.md +0 -578
  68. package/agents/clone-forge/tasks/map-psychometrics.md +0 -459
  69. package/agents/clone-forge/tasks/start.md +0 -805
  70. package/agents/clone-forge/tasks/validate-clone-forge.md +0 -743
  71. package/agents/clone-forge/tasks/validate-clone.md +0 -130
  72. package/agents/clone-forge/templates/driver-profile-tmpl.yaml +0 -137
  73. package/agents/clone-forge/templates/manifest-tmpl.yaml +0 -161
  74. package/agents/clone-forge/templates/miu-tmpl.yaml +0 -109
  75. package/agents/clone-forge/templates/poc-module-tmpl.yaml +0 -259
  76. package/agents/clone-forge/templates/quality-dashboard-360-tmpl.md +0 -218
  77. package/agents/clone-forge/workflows/wf-clone-forge-full.yaml +0 -678
  78. package/agents/clone-forge/workflows/wf-clone-forge-quick.yaml +0 -320
  79. package/agents/companion/agents/companion.md +0 -326
  80. package/agents/companion/knowledge/arcane-method.md +0 -247
  81. package/agents/companion/knowledge/companion-foundation.md +0 -57
  82. package/agents/companion/knowledge/modus-operandi.md +0 -161
  83. package/agents/companion/knowledge/system-guide.md +0 -380
  84. package/agents/companion/tasks/new-project.md +0 -111
  85. package/agents/companion/tasks/save-memory.md +0 -73
  86. package/agents/companion/tasks/start.md +0 -159
  87. package/agents/companion/tasks/weekly-review.md +0 -82
  88. package/agents/consultor/agents/consultor.md +0 -185
  89. package/agents/consultor/knowledge/01-arquitetura-e-engenharia.md +0 -157
  90. package/agents/consultor/knowledge/02-operar-o-negocio.md +0 -136
  91. package/agents/consultor/knowledge/03-os-8-agentes.md +0 -96
  92. package/agents/consultor/knowledge/04-filosofia-e-didatica.md +0 -131
  93. package/agents/consultor/knowledge/05-fazer-no-dia-a-dia.md +0 -99
  94. package/agents/consultor/knowledge/06-quando-criar-agente-ou-squad.md +0 -109
  95. package/agents/consultor/knowledge/07-logicas-de-uso-e-higiene.md +0 -87
  96. package/agents/consultor/tasks/start.md +0 -26
  97. package/agents/etlmaker/agents/analyst.md +0 -189
  98. package/agents/etlmaker/agents/architect.md +0 -173
  99. package/agents/etlmaker/agents/auditor.md +0 -217
  100. package/agents/etlmaker/agents/composer.md +0 -201
  101. package/agents/etlmaker/agents/etl-chief.md +0 -259
  102. package/agents/etlmaker/agents/extractor.md +0 -184
  103. package/agents/etlmaker/data/archive/extraction-lenses.yaml +0 -178
  104. package/agents/etlmaker/data/archive/miu-types.yaml +0 -128
  105. package/agents/etlmaker/data/etlmaker-kb.md +0 -175
  106. package/agents/etlmaker/data/quality-gates.yaml +0 -208
  107. package/agents/etlmaker/skill.md +0 -230
  108. package/agents/etlmaker/squad.yaml +0 -182
  109. package/agents/etlmaker/tasks/compose-volume.md +0 -292
  110. package/agents/etlmaker/tasks/ingest-sources.md +0 -157
  111. package/agents/etlmaker/tasks/integrate-package.md +0 -357
  112. package/agents/etlmaker/tasks/map-territory.md +0 -394
  113. package/agents/etlmaker/tasks/start.md +0 -225
  114. package/agents/etlmaker/tasks/validate-final.md +0 -471
  115. package/agents/etlmaker/templates/kb-template.md +0 -180
  116. package/agents/etlmaker/workflows/wf-knowledge-etl.yaml +0 -371
  117. package/agents/mind-forge/README.md +0 -64
  118. package/agents/mind-forge/agents/forge-chief.md +0 -293
  119. package/agents/mind-forge/agents/knowledge-miner.md +0 -280
  120. package/agents/mind-forge/agents/mind-smith.md +0 -306
  121. package/agents/mind-forge/checklists/analysis-completeness.md +0 -34
  122. package/agents/mind-forge/checklists/mind-quality.md +0 -55
  123. package/agents/mind-forge/data/extraction-lenses.yaml +0 -229
  124. package/agents/mind-forge/data/forge-kb.md +0 -182
  125. package/agents/mind-forge/data/kf-classification.yaml +0 -307
  126. package/agents/mind-forge/skill.md +0 -7
  127. package/agents/mind-forge/squad.yaml +0 -167
  128. package/agents/mind-forge/tasks/analyze-knowledge.md +0 -278
  129. package/agents/mind-forge/tasks/forge-mind.md +0 -199
  130. package/agents/mind-forge/tasks/ingest-sources.md +0 -130
  131. package/agents/mind-forge/tasks/playback-validate.md +0 -146
  132. package/agents/mind-forge/tasks/start.md +0 -137
  133. package/agents/mind-forge/tasks/validate-mind.md +0 -237
  134. package/agents/mind-forge/templates/agent-tmpl.md +0 -124
  135. package/agents/mind-forge/templates/config-tmpl.yaml +0 -17
  136. package/agents/mind-forge/templates/kb-tmpl.md +0 -66
  137. package/agents/mind-forge/workflows/wf-mind-forge.yaml +0 -168
  138. package/agents/squad-forge/README.md +0 -110
  139. package/agents/squad-forge/agents/forge-chief.md +0 -297
  140. package/agents/squad-forge/agents/forge-smith.md +0 -535
  141. package/agents/squad-forge/agents/process-archaeologist.md +0 -398
  142. package/agents/squad-forge/checklists/architecture-coherence.md +0 -28
  143. package/agents/squad-forge/checklists/extraction-completeness.md +0 -48
  144. package/agents/squad-forge/checklists/nuclear-structure-validation.md +0 -61
  145. package/agents/squad-forge/checklists/squad-operational.md +0 -24
  146. package/agents/squad-forge/checklists/user-validation.md +0 -23
  147. package/agents/squad-forge/data/executor-mapping-guide.yaml +0 -135
  148. package/agents/squad-forge/data/extraction-lenses.yaml +0 -330
  149. package/agents/squad-forge/data/forge-kb.md +0 -248
  150. package/agents/squad-forge/data/pu-classification.yaml +0 -229
  151. package/agents/squad-forge/data/quality-thresholds.yaml +0 -259
  152. package/agents/squad-forge/squad.yaml +0 -175
  153. package/agents/squad-forge/tasks/architect-squad.md +0 -398
  154. package/agents/squad-forge/tasks/assemble-squad.md +0 -831
  155. package/agents/squad-forge/tasks/extract-process.md +0 -378
  156. package/agents/squad-forge/tasks/fix-squad.md +0 -334
  157. package/agents/squad-forge/tasks/generate-prd.md +0 -265
  158. package/agents/squad-forge/tasks/generate-stories.md +0 -223
  159. package/agents/squad-forge/tasks/playback-validate.md +0 -263
  160. package/agents/squad-forge/tasks/rebuild-squad.md +0 -236
  161. package/agents/squad-forge/tasks/self-test.md +0 -237
  162. package/agents/squad-forge/tasks/start.md +0 -247
  163. package/agents/squad-forge/tasks/update-squad.md +0 -262
  164. package/agents/squad-forge/tasks/validate-squad.md +0 -377
  165. package/agents/squad-forge/templates/process-map-tmpl.yaml +0 -109
  166. package/agents/squad-forge/templates/pu-tmpl.yaml +0 -71
  167. package/agents/squad-forge/templates/squad-blueprint-tmpl.yaml +0 -113
  168. package/agents/squad-forge/workflows/wf-squad-forge.yaml +0 -300
  169. package/agents/worker-forge/README.md +0 -58
  170. package/agents/worker-forge/agents/knowledge-curator.md +0 -170
  171. package/agents/worker-forge/agents/role-designer.md +0 -150
  172. package/agents/worker-forge/agents/worker-chief.md +0 -273
  173. package/agents/worker-forge/agents/worker-smith.md +0 -258
  174. package/agents/worker-forge/data/worker-forge-kb.md +0 -264
  175. package/agents/worker-forge/knowledge/autonomous-agent-architectures.md +0 -275
  176. package/agents/worker-forge/knowledge/delegation-competency-performance.md +0 -256
  177. package/agents/worker-forge/knowledge/job-design-business-systems.md +0 -296
  178. package/agents/worker-forge/knowledge/knowledge-management-improvement.md +0 -242
  179. package/agents/worker-forge/skill.md +0 -7
  180. package/agents/worker-forge/squad.yaml +0 -101
  181. package/agents/worker-forge/tasks/assemble-worker.md +0 -239
  182. package/agents/worker-forge/tasks/discover-needs.md +0 -219
  183. package/agents/worker-forge/tasks/playback-validate.md +0 -126
  184. package/agents/worker-forge/tasks/propose-worker.md +0 -112
  185. package/agents/worker-forge/tasks/research-domain.md +0 -165
  186. package/agents/worker-forge/tasks/start.md +0 -67
  187. package/agents/worker-forge/tasks/validate-worker.md +0 -155
  188. package/agents/worker-forge/workflows/wf-worker-forge.yaml +0 -96
  189. package/docs/stories/AUROQ-2.1.0-hybrid-runtime.md +0 -64
  190. package/tests/installer-hybrid.test.mjs +0 -66
  191. package/tests/onepassword.test.mjs +0 -54
  192. package/tests/sync-codex-skills.test.mjs +0 -88
  193. /package/{agents → seeds/agents}/companion/data/contexto-dinamico.md +0 -0
  194. /package/{agents → seeds/agents}/companion/data/demandas-backlog.md +0 -0
  195. /package/{agents → seeds/agents}/companion/data/log-decisoes.md +0 -0
  196. /package/{agents → seeds/agents}/companion/data/padroes-observados.md +0 -0
  197. /package/{agents → seeds/agents}/companion/knowledge/expert-essencial.md +0 -0
  198. /package/{business → seeds/business}/campanhas/_template/BRIEFING.md +0 -0
  199. /package/{business → seeds/business}/campanhas/_template/CHECKLIST.md +0 -0
  200. /package/{business → seeds/business}/campanhas/_template/DIARIO.md +0 -0
  201. /package/{business → seeds/business}/campanhas/_template/RETROVISOR.md +0 -0
  202. /package/{business → seeds/business}/cockpit.md +0 -0
  203. /package/{business → seeds/business}/templates/tracker-template.md +0 -0
  204. /package/{docs → seeds/docs}/knowledge/expert-business/criacoes/.gitkeep +0 -0
  205. /package/{docs → seeds/docs}/knowledge/expert-business/posicionamento/.gitkeep +0 -0
  206. /package/{docs → seeds/docs}/knowledge/expert-business/posicionamento.md +0 -0
  207. /package/{docs → seeds/docs}/knowledge/expert-business/produto/.gitkeep +0 -0
  208. /package/{docs → seeds/docs}/knowledge/expert-business/publico-alvo.md +0 -0
  209. /package/{docs → seeds/docs}/knowledge/expert-mind/assessments/.gitkeep +0 -0
  210. /package/{docs → seeds/docs}/knowledge/expert-mind/historia.md +0 -0
  211. /package/{docs → seeds/docs}/knowledge/expert-mind/identidade/.gitkeep +0 -0
  212. /package/{docs → seeds/docs}/knowledge/expert-mind/identidade.md +0 -0
  213. /package/{docs → seeds/docs}/knowledge/expert-mind/proposito/.gitkeep +0 -0
  214. /package/{docs → seeds/docs}/knowledge/expert-mind/tom-de-voz.md +0 -0
  215. /package/{docs → seeds/docs}/knowledge/expert-mind/valores.md +0 -0
@@ -2,6 +2,6 @@
2
2
 
3
3
  Clona mentes reais em agentes digitais.
4
4
 
5
- CRITICAL: First, read and adopt the persona defined in `agents/clone-forge/agents/clone-forge-chief.md`.
6
- Then, read and execute the task defined in `agents/clone-forge/tasks/start.md`.
7
- Follow ALL instructions exactly as written. Those files are your single source of truth.
5
+ Todo conteúdo desta forja vem pelo MCP `arcane` (catálogo `auroq-core`). Chame a tool `forja_bundle` com forge_id `clone-forge` e a fase atual. Nunca procurar arquivo local desta forja; se a tool falhar, mostrar a mensagem e parar — não improvisar de memória.
6
+
7
+ CRITICAL: Do not read `agents/clone-forge/**`. Use the MCP `arcane` tools.
@@ -2,6 +2,6 @@
2
2
 
3
3
  Parceiro cognitivo pessoal. Situa, lembra, pensa junto, roteia.
4
4
 
5
- CRITICAL: First, read and adopt the persona defined in `agents/companion/agents/companion.md`.
6
- Then, read and execute the task defined in `agents/companion/tasks/start.md`.
7
- Follow ALL instructions exactly as written. Those files are your single source of truth.
5
+ Todo conteúdo deste agente vem pelo MCP `arcane` (catálogo `auroq-core`). Chame a tool `squad_ativar` com recurso_id `companion`. Nunca procurar arquivo local deste agente; se a tool falhar, mostrar a mensagem e parar — não improvisar de memória.
6
+
7
+ CRITICAL: Do not read `agents/companion/**`. Use the MCP `arcane` tools.
@@ -1,7 +1,7 @@
1
1
  # auroq-consultor
2
2
 
3
- Guia vivo do Auroq OS. Conhece todo o sistema — pastas, agentes, engenharia e como operar o negócio. Tira dúvidas, ensina e destrava o aluno.
3
+ Guia vivo do Auroq OS. Tira dúvidas, ensina e destrava o aluno.
4
4
 
5
- CRITICAL: First, read and adopt the persona defined in `agents/consultor/agents/consultor.md`.
6
- Then, read and execute the task defined in `agents/consultor/tasks/start.md`.
7
- Follow ALL instructions exactly as written. Those files are your single source of truth.
5
+ Todo conteúdo deste agente vem pelo MCP `arcane` (catálogo `auroq-core`). Chame a tool `squad_ativar` com recurso_id `consultor`. Nunca procurar arquivo local deste agente; se a tool falhar, mostrar a mensagem e parar — não improvisar de memória.
6
+
7
+ CRITICAL: Do not read `agents/consultor/**`. Use the MCP `arcane` tools.
@@ -2,6 +2,6 @@
2
2
 
3
3
  Extrai conhecimento de fontes brutas e estrutura em knowledge bases.
4
4
 
5
- CRITICAL: First, read and adopt the persona defined in `agents/etlmaker/agents/etl-chief.md`.
6
- Then, read and execute the task defined in `agents/etlmaker/tasks/start.md`.
7
- Follow ALL instructions exactly as written. Those files are your single source of truth.
5
+ Todo conteúdo desta forja vem pelo MCP `arcane` (catálogo `auroq-core`). Chame a tool `forja_bundle` com forge_id `etlmaker` e a fase atual. Nunca procurar arquivo local desta forja; se a tool falhar, mostrar a mensagem e parar — não improvisar de memória.
6
+
7
+ CRITICAL: Do not read `agents/etlmaker/**`. Use the MCP `arcane` tools.
@@ -1,7 +1,7 @@
1
1
  # mind-forge
2
2
 
3
- Fabrica de mentes sinteticas e consultores.
3
+ Fábrica de mentes sintéticas e consultores.
4
4
 
5
- CRITICAL: First, read and adopt the persona defined in `agents/mind-forge/agents/forge-chief.md`.
6
- Then, read and execute the task defined in `agents/mind-forge/tasks/start.md`.
7
- Follow ALL instructions exactly as written. Those files are your single source of truth.
5
+ Todo conteúdo desta forja vem pelo MCP `arcane` (catálogo `auroq-core`). Chame a tool `forja_bundle` com forge_id `mind-forge` e a fase atual. Nunca procurar arquivo local desta forja; se a tool falhar, mostrar a mensagem e parar — não improvisar de memória.
6
+
7
+ CRITICAL: Do not read `agents/mind-forge/**`. Use the MCP `arcane` tools.
@@ -2,6 +2,6 @@
2
2
 
3
3
  Cria squads multi-agente a partir dos seus processos.
4
4
 
5
- CRITICAL: First, read and adopt the persona defined in `agents/squad-forge/agents/forge-chief.md`.
6
- Then, read and execute the task defined in `agents/squad-forge/tasks/start.md`.
7
- Follow ALL instructions exactly as written. Those files are your single source of truth.
5
+ Todo conteúdo desta forja vem pelo MCP `arcane` (catálogo `auroq-core`). Chame a tool `forja_bundle` com forge_id `squad-forge` e a fase atual. Nunca procurar arquivo local desta forja; se a tool falhar, mostrar a mensagem e parar — não improvisar de memória.
6
+
7
+ CRITICAL: Do not read `agents/squad-forge/**`. Use the MCP `arcane` tools.
@@ -1,7 +1,7 @@
1
1
  # worker-forge
2
2
 
3
- Cria workers especializados para automacao e operacoes.
3
+ Cria workers especializados para automação e operações.
4
4
 
5
- CRITICAL: First, read and adopt the persona defined in `agents/worker-forge/agents/worker-chief.md`.
6
- Then, read and execute the task defined in `agents/worker-forge/tasks/start.md`.
7
- Follow ALL instructions exactly as written. Those files are your single source of truth.
5
+ Todo conteúdo desta forja vem pelo MCP `arcane` (catálogo `auroq-core`). Chame a tool `forja_bundle` com forge_id `worker-forge` e a fase atual. Nunca procurar arquivo local desta forja; se a tool falhar, mostrar a mensagem e parar — não improvisar de memória.
6
+
7
+ CRITICAL: Do not read `agents/worker-forge/**`. Use the MCP `arcane` tools.
@@ -0,0 +1,127 @@
1
+ #!/usr/bin/env node
2
+ 'use strict';
3
+ /**
4
+ * Auroq OS — Sync Hook
5
+ *
6
+ * --session-start (SessionStart) checa o GitHub ao abrir; PUXA se for seguro; relata o que chegou
7
+ * --remind (UserPromptSubmit) lembra, com moderacao, de trabalho nao entregue
8
+ *
9
+ * Regras de ouro:
10
+ * - Nunca bloqueia a sessao (sempre exit 0) e fica em silencio quando nao ha o que dizer.
11
+ * - So PUXA quando nao ha trabalho local em risco (working tree limpo, nada por enviar).
12
+ * - NUNCA entrega (commit/push) sozinho — entregar e decisao do expert.
13
+ * - Estado fica fora do repositorio (tmpdir) — nunca suja o git do aluno.
14
+ * - Cross-platform (Mac/Windows/Linux): git via execFileSync, sem shell.
15
+ */
16
+
17
+ const path = require('path');
18
+ const fs = require('fs');
19
+ const os = require('os');
20
+ const crypto = require('crypto');
21
+ const { execFileSync } = require('child_process');
22
+
23
+ const MODE = process.argv[2] || '--session-start';
24
+ const CWD = process.cwd();
25
+ const STATE_FILE = path.join(os.tmpdir(), 'auroq-sync', crypto.createHash('md5').update(CWD).digest('hex') + '.json');
26
+ const REMIND_AFTER_MS = 30 * 60 * 1000; // lembra quando ha trabalho nao entregue ha 30 min
27
+ const REMIND_EVERY_MS = 30 * 60 * 1000; // e no maximo 1 vez a cada 30 min
28
+
29
+ function git(args, timeout) {
30
+ return execFileSync('git', args, { cwd: CWD, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], timeout: timeout || 5000 }).trim();
31
+ }
32
+ function tryGit(args, timeout) { try { return git(args, timeout); } catch { return null; } }
33
+
34
+ function emit(eventName, text) {
35
+ if (!text) return;
36
+ process.stdout.write(JSON.stringify({ hookSpecificOutput: { hookEventName: eventName, additionalContext: text } }));
37
+ }
38
+
39
+ function readState() { try { return JSON.parse(fs.readFileSync(STATE_FILE, 'utf8')); } catch { return {}; } }
40
+ function writeState(s) { try { fs.mkdirSync(path.dirname(STATE_FILE), { recursive: true }); fs.writeFileSync(STATE_FILE, JSON.stringify(s)); } catch { /* silencioso */ } }
41
+
42
+ function isRepo() { return fs.existsSync(path.join(CWD, '.git')) && tryGit(['rev-parse', '--is-inside-work-tree']) === 'true'; }
43
+ function hasRemote() { const r = tryGit(['remote']); return !!(r && r.length); }
44
+ function dirtyFiles() { const out = tryGit(['status', '--porcelain']); return out ? out.split('\n').filter(Boolean) : []; }
45
+ function upstream() { return tryGit(['rev-parse', '--abbrev-ref', '--symbolic-full-name', '@{u}']); }
46
+ function countRange(range) { const n = tryGit(['rev-list', '--count', range]); return n === null ? 0 : (parseInt(n, 10) || 0); }
47
+ function describeCommits(range, limit) {
48
+ const out = tryGit(['log', '--no-merges', '--format=%an|%s', range, `-${limit || 8}`]) || '';
49
+ return out.split('\n').filter(Boolean).map(l => { const i = l.indexOf('|'); return `- ${l.slice(0, i)}: ${l.slice(i + 1)}`; });
50
+ }
51
+
52
+ function sessionStart() {
53
+ if (!isRepo() || !hasRemote()) return;
54
+ const up = upstream();
55
+ if (!up) return;
56
+ const dirty = dirtyFiles();
57
+ if (tryGit(['fetch', '--quiet'], 8000) === null) {
58
+ emit('SessionStart', '[Auroq sync] Nao consegui checar o GitHub agora (sem conexao?). O trabalho local esta intacto. So mencione se o expert perguntar de sincronizacao.');
59
+ return;
60
+ }
61
+ const behind = countRange(`HEAD..${up}`);
62
+ const ahead = countRange(`${up}..HEAD`);
63
+ const lines = [];
64
+
65
+ if (behind > 0 && dirty.length === 0 && ahead === 0) {
66
+ const before = tryGit(['rev-parse', 'HEAD']);
67
+ if (tryGit(['pull', '--ff-only', '--quiet'], 10000) !== null) {
68
+ lines.push(`[Auroq sync] Puxei ${behind} atualizacao(oes) do GitHub automaticamente ao abrir a sessao. O que chegou:`);
69
+ lines.push(...describeCommits(`${before}..HEAD`));
70
+ lines.push('Informe o expert em 1-3 linhas, em portugues de negocio (traduza as mensagens de commit; cite o autor quando houver colaborador). Se algo tocar no que ele vai fazer agora, aponte.');
71
+ } else {
72
+ lines.push(`[Auroq sync] Ha ${behind} atualizacao(oes) no GitHub que nao consegui puxar sozinho (historico divergiu). Sugira ao expert: "puxa as atualizacoes" — o ritual de sync (rule puxar-e-entregar) resolve com ele.`);
73
+ }
74
+ } else if (behind > 0) {
75
+ lines.push(`[Auroq sync] Ha ${behind} atualizacao(oes) no GitHub, mas NAO puxei: existe trabalho local nao entregue (${dirty.length} arquivo(s) alterado(s)${ahead ? `, ${ahead} commit(s) nao enviado(s)` : ''}). Puxar agora poderia misturar coisa pela metade.`);
76
+ lines.push('Diga ao expert em 1-2 linhas: ha atualizacoes esperando; primeiro "salva e entrega" o que ficou pendente, depois "puxa". Se ele pedir, execute o ritual (rule puxar-e-entregar) sem trocar de agente.');
77
+ } else if (ahead > 0 && dirty.length === 0) {
78
+ lines.push(`[Auroq sync] Em dia com o GitHub, mas ha ${ahead} commit(s) salvo(s) e NAO entregue(s) (push pendente). Ofereca em 1 linha: "quer que eu entregue pro GitHub agora?"`);
79
+ } else if (dirty.length > 0) {
80
+ lines.push(`[Auroq sync] Sem novidades no GitHub, mas ha trabalho local nao entregue de uma sessao anterior (${dirty.length} arquivo(s)). Mencione em 1 linha e siga; quando ele fechar um bloco, ofereca "salva e entrega".`);
81
+ } else {
82
+ lines.push('[Auroq sync] Tudo em dia com o GitHub. Nao precisa mencionar, a menos que o expert pergunte.');
83
+ }
84
+
85
+ const st = readState();
86
+ st.dirtySince = dirty.length ? (st.dirtySince || Date.now()) : 0;
87
+ st.lastRemind = 0;
88
+ writeState(st);
89
+ emit('SessionStart', lines.join('\n'));
90
+ }
91
+
92
+ function remind() {
93
+ if (!isRepo()) return;
94
+ const dirty = dirtyFiles();
95
+ const up = upstream();
96
+ const ahead = up ? countRange(`${up}..HEAD`) : 0;
97
+ const st = readState();
98
+ const now = Date.now();
99
+ if (dirty.length === 0 && ahead === 0) {
100
+ if (st.dirtySince) { st.dirtySince = 0; writeState(st); }
101
+ return;
102
+ }
103
+ if (!st.dirtySince) { st.dirtySince = now; writeState(st); return; }
104
+ if (now - st.dirtySince < REMIND_AFTER_MS) return;
105
+ if (st.lastRemind && now - st.lastRemind < REMIND_EVERY_MS) return;
106
+ st.lastRemind = now;
107
+ writeState(st);
108
+ const mins = Math.round((now - st.dirtySince) / 60000);
109
+ emit('UserPromptSubmit', `[Auroq lembrete] Ha trabalho nao entregue ha ~${mins} min (${dirty.length} arquivo(s) alterado(s)${ahead ? `, ${ahead} commit(s) sem push` : ''}). NAO interrompa o raciocinio atual. Ao fechar o bloco em andamento, ofereca em UMA linha: "quer que eu salve e entregue pro GitHub?". Nunca entregue sem o expert pedir.`);
110
+ }
111
+
112
+ let ran = false;
113
+ function main() {
114
+ if (ran) return;
115
+ ran = true;
116
+ try { if (MODE === '--remind') remind(); else sessionStart(); }
117
+ catch (e) { console.error(`[auroq-sync] ${e.message}`); }
118
+ process.exit(0);
119
+ }
120
+
121
+ // Consome o JSON que o Claude Code envia no stdin (nao depende dele) e roda no fim;
122
+ // fallback por timer garante execucao mesmo se o stdin nao fechar.
123
+ process.stdin.resume();
124
+ process.stdin.on('data', () => {});
125
+ process.stdin.on('end', main);
126
+ process.stdin.on('error', main);
127
+ setTimeout(main, 400).unref();
@@ -0,0 +1,19 @@
1
+ ---
2
+ name: Direto
3
+ description: Brevidade inteligente — resultado primeiro, contexto minimo e decisao clara
4
+ keep-coding-instructions: true
5
+ ---
6
+
7
+ # Brevidade inteligente
8
+
9
+ Comece pelo resultado. Pergunta simples recebe resposta simples; entrega ou
10
+ analise costuma caber em um paragrafo de 3 a 5 frases com: o que aconteceu, o
11
+ contexto minimo, o que muda para o expert e a decisao necessaria.
12
+
13
+ - Use **Na sua mao:** somente quando houver uma decisao ou acao real do expert.
14
+ - Use **Risco:** somente para risco material que muda a decisao.
15
+ - Preserve ressalva importante, teste que falhou, erro corrigido e atalho tomado.
16
+ - Explique primeiro o efeito em linguagem comum; detalhe tecnico so quando ajuda a decidir.
17
+ - Sem preambulo, repeticao, validacao vazia, emoji ou tabela quando uma frase resolve.
18
+ - Nao termine oferecendo aprofundamento. Se o expert pedir "aprofunda X", entregue apenas o detalhe daquele ponto.
19
+ - O tamanho acompanha o pedido. Concisao corta enfeite, nunca fato que muda a decisao.
@@ -6,11 +6,12 @@
6
6
 
7
7
  | Operacao | Exclusivo? | Outros Agentes |
8
8
  |----------|-----------|--------------|
9
- | `git push` / `git push --force` | SIM | BLOQUEADO |
9
+ | `git push --force` | SIM | BLOQUEADO |
10
+ | `git commit` / `git push` / `git pull` (salvar, entregar, puxar) | NAO — Ops e o DONO do ritual | QUALQUER agente executa o ritual do Ops (`rules/puxar-e-entregar.md`), sem pedir troca de agente |
10
11
  | `gh pr create` / `gh pr merge` | SIM | BLOQUEADO |
11
12
  | MCP add/remove/configure | SIM | BLOQUEADO |
12
13
  | Environment bootstrap | SIM | BLOQUEADO |
13
- | Commit inteligente (ritual completo) | SIM | Outros agentes delegam |
14
+ | Commit inteligente (definicao do ritual) | SIM (dono) | Outros agentes EXECUTAM o ritual quando o expert pede |
14
15
 
15
16
  ### Companion — Cerebro do Sistema
16
17
 
@@ -47,7 +48,7 @@
47
48
 
48
49
  | Permitido | Bloqueado |
49
50
  |---------|---------|
50
- | `git add`, `git commit`, `git status` | `git push` (delegar pra Ops) |
51
+ | `git add`, `git commit`, `git status`, `git push`/`pull` (pelo ritual do Ops, com pre-push) | `git push --force` (so Ops) |
51
52
  | `git branch`, `git checkout` (local) | `gh pr create/merge` (delegar pra Ops) |
52
53
  | Execucao de tasks operacionais | Criar novos agentes (delegar pro Meta Squad adequado) |
53
54
  | Atualizacao de documentos de trabalho | Decisoes estrategicas (delegar pro Expert) |
@@ -56,15 +57,16 @@
56
57
 
57
58
  | Permitido | Bloqueado |
58
59
  |---------|---------|
59
- | Executar pipeline completo com quality gates | `git push` (delegar pra Ops) |
60
+ | Executar pipeline completo com quality gates | `git push --force` / PR (so Ops) |
60
61
  | Criar documentos de output | Criar novos agentes (delegar pro Meta Squad adequado) |
61
62
  | Atualizar KBs e skills | Decisoes fora do escopo do squad |
62
63
 
63
64
  ## Cross-Agent Delegation
64
65
 
65
- ### Git Push Flow
66
+ ### Salvar / Entregar / Puxar Flow
66
67
  ```
67
- QUALQUER agente → Ops (*commit / *push)
68
+ Expert pede ("salva", "entrega", "puxa") → o agente ATIVO executa o ritual do Ops (rules/puxar-e-entregar.md)
69
+ Abertura de sessao → hook auroq-sync puxa sozinho se for seguro (nunca entrega sozinho)
68
70
  ```
69
71
 
70
72
  ### Novo Agente Flow
@@ -1,23 +1,23 @@
1
1
  # Evolucao Incremental — Rules
2
2
 
3
3
  > Constitution Art. VI: Nunca do zero. REUSE > ADAPT > CREATE.
4
+ > Carve-out Arcane: conteúdo de Companion, Consultor, forjas e Pack se busca no MCP `arcane`, não em `agents/`.
4
5
 
5
6
  ## Hierarquia de Verificacao
6
7
 
7
- Antes de criar QUALQUER artefato (documento, agente, processo, template):
8
+ Antes de criar QUALQUER artefato:
8
9
 
9
10
  ### Gate 1: REUSE — Ja existe?
10
- - Buscar no Exocortex (docs/knowledge/)
11
- - Buscar nos squads instalados (agents/)
12
- - Buscar nos processos documentados (business/processos/)
13
- - Buscar nos templates de campanha (business/campanhas/_template/)
11
+ - Buscar no Exocortex do aluno (`docs/knowledge/`)
12
+ - Buscar conteúdo Arcane no MCP `arcane` (`catalogo_listar`, `busca`)
13
+ - Buscar nos processos documentados (`business/processos/`)
14
+ - Buscar nos templates de campanha (`business/campanhas/_template/`)
14
15
 
15
16
  SE encontrou algo que resolve → USAR direto. Nao recriar.
16
17
 
17
18
  ### Gate 2: ADAPT — Existe algo parecido?
18
- - Buscar por artefato similar que pode ser adaptado
19
+ - Artefato similar que pode ser adaptado
19
20
  - Template que pode ser preenchido
20
- - KB de dominio adjacente que pode ser reutilizada
21
21
  - Processo de outra campanha que pode ser copiado
22
22
 
23
23
  SE encontrou algo parecido → ADAPTAR. Nao criar do zero.
@@ -25,19 +25,7 @@ SE encontrou algo parecido → ADAPTAR. Nao criar do zero.
25
25
  ### Gate 3: CREATE — Nao existe nada?
26
26
  - So agora criar do zero
27
27
  - Ao criar: documentar para futuro reuso
28
- - Usar templates padrao quando disponiveis
29
-
30
- ## Aplicacoes Praticas
31
-
32
- | Situacao | REUSE | ADAPT | CREATE |
33
- |----------|-------|-------|--------|
34
- | Nova campanha | Copiar _template/ | Ajustar campanha anterior | So se for modelo novo |
35
- | Novo processo | Verificar se ja tem SOP | Adaptar SOP similar | Documentar apos fazer |
36
- | Novo agente | Verificar se ja existe squad/worker | Adaptar agente existente | Criar via Meta Squad adequado (/squad-forge, /mind-forge, /worker-forge, /clone-forge) |
37
- | Novo documento | Verificar biblioteca-pmi/ | Adaptar doc existente | Criar e adicionar a biblioteca |
38
28
 
39
29
  ## Regra de Ouro
40
30
 
41
- **Cada artefato criado deve ser reusavel.** Se criou um processo, documente como SOP. Se criou um template, coloque em _template/. Se criou um documento, adicione a biblioteca.
42
-
43
- O sistema fica mais rico a cada uso — nao mais poluido.
31
+ Nunca varrer `agents/` atrás de persona, KB ou forja Arcane. Isso agora chega ao vivo.
@@ -1,16 +1,18 @@
1
1
  # MCP Usage — Auroq OS
2
2
 
3
+ > Carve-out Arcane: conteúdo licenciado (Companion interno, Consultor, forjas, Pack) vem **sempre** pelo MCP `arcane`, nunca do disco. Esta regra vence a preferência genérica por ferramentas nativas **só nesse conteúdo**.
4
+
3
5
  ## Prioridade de Ferramentas
4
6
 
5
- SEMPRE preferir ferramentas nativas do Claude Code sobre MCP:
7
+ SEMPRE preferir ferramentas nativas do Claude Code sobre MCP, **exceto** conteúdo Arcane:
6
8
 
7
9
  | Task | USAR | NAO USAR |
8
10
  |------|------|----------|
9
- | Ler arquivos | `Read` tool | MCP servers |
11
+ | Conteúdo Arcane (persona, KB, forja, Pack) | MCP `arcane` | Read/Grep em `agents/` |
12
+ | Ler arquivos do ALUNO (memória, docs, cockpit) | `Read` tool | MCP servers |
10
13
  | Escrever arquivos | `Write` / `Edit` tools | MCP servers |
11
14
  | Rodar comandos | `Bash` tool | MCP servers |
12
- | Buscar arquivos | `Glob` tool | MCP servers |
13
- | Buscar conteudo | `Grep` tool | MCP servers |
15
+ | Buscar arquivos do projeto do aluno | `Glob` / `Grep` | MCP servers |
14
16
 
15
17
  ## MCP Governance
16
18
 
@@ -20,19 +22,9 @@ Outros agentes sao **consumidores** de MCP, nao administradores. Se precisar de
20
22
 
21
23
  ## Quando usar MCP
22
24
 
23
- 1. Browser automation (Playwright) — testes, screenshots, interacao web
24
- 2. WhatsApp (quando configurado) — mensagens, contatos
25
- 3. Notion (quando configurado) — docs externos
25
+ 1. Conteúdo licenciado Arcane — MCP `arcane` (obrigatório)
26
+ 2. Servico com integracao estruturada — WhatsApp, Notion e equivalentes
27
+ 3. Playwright nos cenarios tecnicos
26
28
  4. Ferramentas externas sem equivalente nativo
27
29
 
28
- ## Quando NAO usar MCP
29
-
30
- - Operacoes com arquivos locais (usar ferramentas nativas)
31
- - Comandos de shell (usar Bash)
32
- - Qualquer coisa que uma ferramenta nativa resolve
33
-
34
- ## Rationale
35
-
36
- - Ferramentas nativas executam no sistema LOCAL
37
- - MCP servers podem ter latencia, falhas de conexao, custos
38
- - Ferramentas nativas sao mais rapidas e confiaveis pra operacoes locais
30
+ Se a tool `arcane` falhar: mostrar a mensagem e parar. Nao improvisar de memoria.
@@ -0,0 +1,29 @@
1
+ # Operacao autonoma — escopo, ferramentas e honestidade
2
+
3
+ ## Escopo
4
+
5
+ - Pedido de responder, explicar, revisar ou diagnosticar: inspecione e reporte; nao altere estado sem pedido.
6
+ - Pedido de mudar, construir, corrigir ou executar: faca ate o resultado e valide o que for relevante.
7
+ - Nao acrescente alternativa, melhoria ou proximo passo fora do pedido, salvo defeito real que mude o resultado.
8
+ - Pergunte somente quando faltar uma decisao material que nao possa ser descoberta com seguranca.
9
+
10
+ ## Resolver antes de devolver
11
+
12
+ 1. Verifique primeiro ferramentas nativas, CLI, API, conectores, MCPs e scripts ja configurados.
13
+ 2. Se faltar autenticacao, use o gerenciador de credenciais ja configurado antes de pedir ao expert. Nunca exponha segredo no chat ou em logs.
14
+ 3. Para web, prefira a superficie oficial conectada ao browser quando disponivel: Claude in Chrome no Claude Code; Browser ou Chrome no app ChatGPT/Codex.
15
+ 4. Use Playwright para testes repetiveis, DOM/console/rede, scraping estruturado ou como fallback quando o runtime nao tiver browser nativo.
16
+ 5. Use Computer Use para aplicativos nativos e interfaces sem CLI, API, conector ou controle direto de browser. E a superficie mais ampla e mais lenta, portanto e o ultimo recurso de UI.
17
+ 6. Persista ate o desfecho e diagnostique a causa real. Pare apenas diante de bloqueio comprovado depois de esgotar caminhos seguros e pertinentes.
18
+
19
+ Trabalho manual do expert fica restrito a senha pessoal, login, CAPTCHA,
20
+ permissao do sistema, aprovacao consequencial ou decisao de negocio nao
21
+ inferivel. Deixe tudo pronto ate esse ponto. Nao faca acao destrutiva, compra
22
+ ou ampliacao material de escopo sem autorizacao explicita.
23
+
24
+ ## Honestidade operacional
25
+
26
+ - Nao invente requisito, fato, prova ou conclusao para fechar a conta.
27
+ - Antes de chamar algo de pronto, procure suposicao escondida, default preguiçoso, amostra insuficiente ou atalho.
28
+ - Nunca declare browser, Computer Use, MCP, login ou integracao configurados sem executar o gate correspondente.
29
+ - Se houver bloqueio real, diga o que foi comprovado, o que falta e por que as ferramentas disponiveis nao resolvem.
@@ -0,0 +1,31 @@
1
+ # Puxar e Entregar — Qualquer Agente Executa o Ritual do Ops
2
+
3
+ > O expert NUNCA precisa trocar de agente pra salvar, entregar ou puxar trabalho.
4
+ > Quem estiver ativo (Companion, Organizer, squad, worker ou Claude sem agente) executa o ritual do Ops por baixo.
5
+ > O Ops continua sendo o DONO do ritual; os outros agentes o executam.
6
+
7
+ ## Intents (linguagem natural → acao)
8
+
9
+ | O expert diz (exemplos) | Acao |
10
+ |-------------------------|------|
11
+ | "salva", "guarda isso", "faz checkpoint", "commita" | SALVAR (commit inteligente) |
12
+ | "entrega", "manda pro GitHub", "sobe", "faz push" | ENTREGAR (push com pre-push) |
13
+ | "salva e entrega", "fecha o dia", "acabei por hoje" | SALVAR + ENTREGAR |
14
+ | "puxa", "atualiza do GitHub", "traz o que mudou", "sync" | PUXAR (sync) |
15
+
16
+ ## O ritual — fonte da verdade: `.claude/commands/AuroqOS/agents/ops.md`
17
+
18
+ Leia as secoes `*commit`, `*pre-push` e `*sync` do ops.md e execute os passos como estao. O minimo inegociavel:
19
+
20
+ - **SALVAR:** revisar o que mudou → conferir tracker/contexto → mensagem em linguagem de negocio (`progresso:`, `decisao:`, `campanha:`...) → `git add` dos arquivos relevantes (NUNCA `business/vault/`, `.env`, chaves) → commit → confirmar ao expert em 1 linha.
21
+ - **ENTREGAR:** pre-push OBRIGATORIO (vault/.env fora do staging, `.gitignore` protege, nenhum arquivo gigante, branch certa) → `git push` → confirmar.
22
+ - **PUXAR:** se ha trabalho local, SALVAR primeiro (commit antes de pull, sempre) → `git fetch` → `git pull` (merge — nunca rebase com o expert) → relatar em portugues o que chegou (autor + o que fez) → conflito: conduzir com o expert, mostrando as duas versoes; em `agents/companion/data/` a resposta quase sempre e juntar as duas.
23
+
24
+ ## Regras
25
+
26
+ 1. Nao pedir troca de agente. Nao dizer "chama o Ops". Faca.
27
+ 2. **Nunca entregar (push) sem o expert pedir.** O sistema so PUXA sozinho (hook de abertura) — entregar e decisao dele.
28
+ 3. As travas do pre-push valem pra TODO agente — sao o que impede senha de subir pro GitHub.
29
+ 4. Continua EXCLUSIVO do Ops: `git push --force`, Pull Request (`gh pr`), MCP/infra, bootstrap, `*update`.
30
+ 5. O hook de abertura (`.claude/hooks/auroq-sync.cjs`) ja puxou o que era seguro e pode ter deixado um aviso no contexto (atualizacoes esperando, trabalho pendente). Repasse ao expert em 1-2 linhas, sem drama, e siga.
31
+ 6. O lembrete de trabalho nao entregue chega no contexto no maximo a cada 30 min: ofereca "salva e entrega" em UMA linha ao fechar o bloco — nunca interrompa o raciocinio em andamento.
@@ -1 +1,22 @@
1
- { "language": "portuguese" }
1
+ {
2
+ "language": "portuguese",
3
+ "outputStyle": "Direto",
4
+ "hooks": {
5
+ "SessionStart": [
6
+ {
7
+ "matcher": "startup|resume|clear",
8
+ "hooks": [
9
+ { "type": "command", "command": "node .claude/hooks/auroq-sync.cjs --session-start", "timeout": 25000 }
10
+ ]
11
+ }
12
+ ],
13
+ "UserPromptSubmit": [
14
+ {
15
+ "matcher": "",
16
+ "hooks": [
17
+ { "type": "command", "command": "node .claude/hooks/auroq-sync.cjs --remind", "timeout": 5000 }
18
+ ]
19
+ }
20
+ ]
21
+ }
22
+ }
package/.gitignore CHANGED
@@ -29,3 +29,7 @@ Thumbs.db
29
29
 
30
30
  # Backups locais pré-sync (não vão pro npm/git)
31
31
  _backup-pre-sync/
32
+
33
+ # Overlay temporário do pack 2.3.0 (casca)
34
+ .pack-casca-backup/
35
+ *.tgz
package/AGENTS.md CHANGED
@@ -1,127 +1,18 @@
1
- # AGENTS.md — Auroq OS (Claude / Codex / Grok)
1
+ # AGENTS.md — Auroq OS
2
2
 
3
- Este arquivo define as instrucoes do projeto para qualquer harness CLI
4
- suportado: **Claude Code**, **Codex CLI** e **Grok Build**.
3
+ Sistema operacional de IA. Runtimes oficiais desta versão: Claude Code e Codex. Grok carrega este arquivo, mas o conteúdo ao vivo do MCP `arcane` não está garantido no Grok.
5
4
 
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.
5
+ ## Ativar
10
6
 
11
- ---
7
+ - Claude: `/companion`, `/ops`, `/consultor`, `/squad-forge`, …
8
+ - Codex: `$companion`, `$ops`, `$consultor`, `$squad-forge`, … (skills em `.agents/skills/`)
12
9
 
13
- ## O que e o Auroq OS
10
+ Todo conteúdo Arcane vem pelo MCP `arcane` (catálogos `auroq-core` e `arcane-pack`). Nunca procurar esse conteúdo em `agents/`. Se a tool falhar, mostre a mensagem e pare.
14
11
 
15
- Sistema Operacional de IA pra experts. Voce opera o negocio inteiro pelo
16
- terminal, com agentes especializados pra cada coisa. Constitution formal em
17
- `.auroq-core/constitution.md`.
12
+ ## O que fica no disco
18
13
 
19
- ## Mapa do projeto
14
+ Motor (CLI, hooks, scripts), pastas, git, casca (estes ponteiros) e o que VOCÊ criar (memória, docs, cockpit).
20
15
 
21
- - `.auroq-core/` — nucleo do framework (constitution, DNA, configs, scripts). **Nao modificar sem pedido explicito.**
22
- - `agents/<nome>/` — cada agente core. Persona em `agents/<nome>/agents/<nome>.md` + `tasks/` + `knowledge/` + `data/`
23
- - `.claude/commands/` — comandos de ativacao dos agentes (fonte de verdade)
24
- - `.claude/rules/` — regras de operacao (autoridade, memoria, commit, etc.)
25
- - `.synapse/` — Synapse Engine (contexto e memoria do sistema)
26
- - `business/` — **teu** negocio (cockpit, campanhas, processos). Dados teus — nunca sobrescrever.
27
- - `docs/knowledge/` — tua base de conhecimento (expert-mind, expert-business)
16
+ ## O que vem ao vivo
28
17
 
29
- ---
30
-
31
- ## Como ativar os agentes por harness
32
-
33
- ### Codex CLI (`$nome`)
34
-
35
- As skills ativaveis vivem em `.agents/skills/`, local oficial de skills de
36
- repositorio do Codex, e sao geradas por
37
- `node scripts/sync-codex-skills.mjs`. O modo local e o padrao porque isola cada
38
- negocio e evita colisao entre projetos. A instalacao global existe apenas como
39
- opcao explicita em `~/.agents/skills/` via `npm run sync:codex:global`. Digite `$nome` pra ativar. Depois de
40
- criar ou atualizar um agente, rode o sync de novo pra a skill aparecer.
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
-
56
- | Agente | Ativacao | O que faz |
57
- |--------|----------|-----------|
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:
72
- leia o arquivo em `.claude/commands/auroq-<nome>.md` (ou
73
- `.claude/commands/AuroqOS/agents/ops.md` pro Ops), adote a persona e siga as
74
- instrucoes do arquivo ate `*exit`.
75
-
76
- ---
77
-
78
- ## Constitution — principios inegociaveis (replica de `.auroq-core/constitution.md`)
79
-
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)*
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)*
82
- 3. **Documentar = investir** — todo trabalho significativo vira `.md`. O que nao e documentado, morre. *(MUST)*
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)*
84
- 5. **Qualidade com julgamento** — o expert julga; a IA nao se auto-aprova em entregas importantes. *(MUST)*
85
- 6. **Evolucao incremental** — `REUSE > ADAPT > CREATE`. Verifica o que ja existe antes de criar. *(SHOULD)*
86
-
87
- ## DNA Operacional (replica de `.auroq-core/dna-operacional.md`)
88
-
89
- 1. **Projeto antes de execucao** — trabalho com mais de 3 etapas comeca com plano. O plano e a coleira: executa o que esta nele.
90
- 2. **Documentacao continua** — atualiza o documento de trabalho a cada etapa (progresso, decisoes, problemas, estado). Autocompact apaga a conversa, nao o documento.
91
- 3. **Handoff perfeito** — o documento de trabalho **e** o handoff. Quem ler sabe onde o trabalho esta.
92
- 4. **Anti-viagem** — executa o planejado, nao adiciona "melhorias" nao pedidas. Muda escopo so com aprovacao.
93
- 5. **Anti-entropia** — papeis separados (quem executa nao se auto-valida), documentos > conversas, quality gates antes de aceitar output.
94
-
95
- ## Autoridade de agentes (de `.claude/rules/agent-authority`)
96
-
97
- - **Ops** detem exclusivamente `git push`, `commit`, `deploy`, gestao de MCP/infra e `*update`.
98
- - Os **Forges** criam agentes/squads/workers/clones; o **Companion** situa e roteia; o **Consultor** ensina o sistema.
99
- - Um agente nao invade o dominio de outro — **delega**. Em conflito de fronteira, escala pro Companion/expert.
100
-
101
- ## Comportamento com ferramentas
102
-
103
- - Prefira as ferramentas nativas do harness em uso (Claude, Codex ou Grok) pra arquivo, shell e busca local.
104
- - MCP e infra sao responsabilidade do **Ops**.
105
- - Nunca use API paga no Claude/Codex/Grok onde o plano ja resolve — e dinheiro jogado fora.
106
- - Em respostas grandes de ferramenta, filtre ruido e preserve so o relevante.
107
- - Use um runtime por sessao. Antes de trocar entre Claude Code, Codex e Grok, finalize ou documente o estado do trabalho.
108
-
109
- ## Gates da camada hibrida
110
-
111
- - `npm run auroq:sync:codex` — gera/atualiza as skills locais
112
- - `npm run auroq:sync:codex:check` — detecta drift sem escrever
113
- - `npm run auroq:validate` — valida estrutura e comandos
114
- - No repo da distribuicao: `npm run lint && npm run typecheck && npm test && npm run build`
115
-
116
- ## Memoria e contexto (carregar sob demanda)
117
-
118
- Quando o pedido depender de contexto/memoria ja definidos, leia:
119
- - Regras Claude: `.claude/CLAUDE.md`, `.claude/rules/`
120
- - Memoria/Synapse: `.synapse/` (`manifest`, `global`, `context`)
121
- - Teu negocio: `business/cockpit.md`, `business/`, `docs/knowledge/`
122
-
123
- ## Higiene de uso (do Consultor)
124
-
125
- - **Um chat por objetivo**: abre, resolve, o Ops commita + faz push, fecha. Chat-balaio engorda o contexto e a qualidade cai.
126
- - **O agente certo pra cada tarefa** — nao deixa o modelo cru fazer trabalho de especialista.
127
- - **Nao caia na labia da IA** — ela as vezes inventa, alucina ou te limita sem motivo. Questione, confirme, e pergunte no grupo da mentoria quando ela parecer viajando.
18
+ Companion interno, Consultor, forjas, Pack. Exige conta ativa e internet.