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.
- package/.auroq-core/constitution.md +11 -151
- package/.auroq-core/core-config.yaml +1 -1
- package/.auroq-core/dna-operacional.md +9 -131
- package/.claude/CLAUDE.md +5 -466
- package/.claude/commands/AuroqOS/agents/ops.md +4 -1781
- package/.claude/commands/auroq-clone-forge.md +3 -3
- package/.claude/commands/auroq-companion.md +3 -3
- package/.claude/commands/auroq-consultor.md +4 -4
- package/.claude/commands/auroq-etlmaker.md +3 -3
- package/.claude/commands/auroq-mind-forge.md +4 -4
- package/.claude/commands/auroq-squad-forge.md +3 -3
- package/.claude/commands/auroq-worker-forge.md +4 -4
- package/.claude/hooks/auroq-sync.cjs +127 -0
- package/.claude/output-styles/direto.md +19 -0
- package/.claude/rules/agent-authority.md +8 -6
- package/.claude/rules/evolucao-incremental.md +8 -20
- package/.claude/rules/mcp-usage.md +10 -18
- package/.claude/rules/operacao-autonoma.md +29 -0
- package/.claude/rules/puxar-e-entregar.md +31 -0
- package/.claude/settings.json +22 -1
- package/.gitignore +4 -0
- package/AGENTS.md +10 -119
- package/README.md +8 -7
- package/bin/auroq-os.js +68 -18
- package/lib/auth.js +6 -6
- package/lib/credentials.js +13 -1
- package/package.json +18 -8
- package/scripts/postpack-casca.mjs +32 -0
- package/scripts/prepack-casca.mjs +47 -0
- package/scripts/validate-hybrid.mjs +2 -0
- package/.auroq-core/development/sistema-gestao-projetos.md +0 -193
- package/.auroq-core/development/sistema-memoria.md +0 -157
- package/agents/clone-forge/.state.json +0 -7
- package/agents/clone-forge/README.md +0 -81
- package/agents/clone-forge/agents/clone-forge-chief.md +0 -885
- package/agents/clone-forge/agents/cognitive-motor.md +0 -384
- package/agents/clone-forge/agents/innerlens.md +0 -453
- package/agents/clone-forge/checklists/clone-forge-validation.md +0 -160
- package/agents/clone-forge/checklists/driver-quality-gate.md +0 -79
- package/agents/clone-forge/checklists/miu-quality-gate.md +0 -86
- package/agents/clone-forge/checklists/psychometric-quality-gate.md +0 -76
- package/agents/clone-forge/checklists/smoke-test-clone.md +0 -313
- package/agents/clone-forge/config.yaml +0 -221
- package/agents/clone-forge/data/clone-anti-patterns.yaml +0 -148
- package/agents/clone-forge/data/clone-forge-kb.md +0 -106
- package/agents/clone-forge/data/clone-validation.yaml +0 -190
- package/agents/clone-forge/data/driver-catalog.yaml +0 -2595
- package/agents/clone-forge/data/driver-relationship-templates.yaml +0 -242
- package/agents/clone-forge/data/miu-classification-taxonomy.yaml +0 -273
- package/agents/clone-forge/data/output-examples.yaml +0 -102
- package/agents/clone-forge/data/poc-schema.yaml +0 -320
- package/agents/clone-forge/data/psychometric-systems.yaml +0 -1514
- package/agents/clone-forge/data/source-tiers.yaml +0 -119
- package/agents/clone-forge/data/source-type-handlers.yaml +0 -282
- package/agents/clone-forge/tasks/aggregate-profile.md +0 -519
- package/agents/clone-forge/tasks/clone-review.md +0 -105
- package/agents/clone-forge/tasks/collect-and-merge-sources.md +0 -621
- package/agents/clone-forge/tasks/deep-interview.md +0 -737
- package/agents/clone-forge/tasks/extract-dna-enriched.md +0 -371
- package/agents/clone-forge/tasks/extract-mius.md +0 -1018
- package/agents/clone-forge/tasks/extract-thinking-dna.md +0 -654
- package/agents/clone-forge/tasks/extract-voice-dna.md +0 -620
- package/agents/clone-forge/tasks/fidelity-score.md +0 -109
- package/agents/clone-forge/tasks/gap-analysis-questionnaire.md +0 -517
- package/agents/clone-forge/tasks/generate-agent-from-profile.md +0 -874
- package/agents/clone-forge/tasks/infer-drivers.md +0 -431
- package/agents/clone-forge/tasks/ingest-local-content.md +0 -578
- package/agents/clone-forge/tasks/map-psychometrics.md +0 -459
- package/agents/clone-forge/tasks/start.md +0 -805
- package/agents/clone-forge/tasks/validate-clone-forge.md +0 -743
- package/agents/clone-forge/tasks/validate-clone.md +0 -130
- package/agents/clone-forge/templates/driver-profile-tmpl.yaml +0 -137
- package/agents/clone-forge/templates/manifest-tmpl.yaml +0 -161
- package/agents/clone-forge/templates/miu-tmpl.yaml +0 -109
- package/agents/clone-forge/templates/poc-module-tmpl.yaml +0 -259
- package/agents/clone-forge/templates/quality-dashboard-360-tmpl.md +0 -218
- package/agents/clone-forge/workflows/wf-clone-forge-full.yaml +0 -678
- package/agents/clone-forge/workflows/wf-clone-forge-quick.yaml +0 -320
- package/agents/companion/agents/companion.md +0 -326
- package/agents/companion/knowledge/arcane-method.md +0 -247
- package/agents/companion/knowledge/companion-foundation.md +0 -57
- package/agents/companion/knowledge/modus-operandi.md +0 -161
- package/agents/companion/knowledge/system-guide.md +0 -380
- package/agents/companion/tasks/new-project.md +0 -111
- package/agents/companion/tasks/save-memory.md +0 -73
- package/agents/companion/tasks/start.md +0 -159
- package/agents/companion/tasks/weekly-review.md +0 -82
- package/agents/consultor/agents/consultor.md +0 -185
- package/agents/consultor/knowledge/01-arquitetura-e-engenharia.md +0 -157
- package/agents/consultor/knowledge/02-operar-o-negocio.md +0 -136
- package/agents/consultor/knowledge/03-os-8-agentes.md +0 -96
- package/agents/consultor/knowledge/04-filosofia-e-didatica.md +0 -131
- package/agents/consultor/knowledge/05-fazer-no-dia-a-dia.md +0 -99
- package/agents/consultor/knowledge/06-quando-criar-agente-ou-squad.md +0 -109
- package/agents/consultor/knowledge/07-logicas-de-uso-e-higiene.md +0 -87
- package/agents/consultor/tasks/start.md +0 -26
- package/agents/etlmaker/agents/analyst.md +0 -189
- package/agents/etlmaker/agents/architect.md +0 -173
- package/agents/etlmaker/agents/auditor.md +0 -217
- package/agents/etlmaker/agents/composer.md +0 -201
- package/agents/etlmaker/agents/etl-chief.md +0 -259
- package/agents/etlmaker/agents/extractor.md +0 -184
- package/agents/etlmaker/data/archive/extraction-lenses.yaml +0 -178
- package/agents/etlmaker/data/archive/miu-types.yaml +0 -128
- package/agents/etlmaker/data/etlmaker-kb.md +0 -175
- package/agents/etlmaker/data/quality-gates.yaml +0 -208
- package/agents/etlmaker/skill.md +0 -230
- package/agents/etlmaker/squad.yaml +0 -182
- package/agents/etlmaker/tasks/compose-volume.md +0 -292
- package/agents/etlmaker/tasks/ingest-sources.md +0 -157
- package/agents/etlmaker/tasks/integrate-package.md +0 -357
- package/agents/etlmaker/tasks/map-territory.md +0 -394
- package/agents/etlmaker/tasks/start.md +0 -225
- package/agents/etlmaker/tasks/validate-final.md +0 -471
- package/agents/etlmaker/templates/kb-template.md +0 -180
- package/agents/etlmaker/workflows/wf-knowledge-etl.yaml +0 -371
- package/agents/mind-forge/README.md +0 -64
- package/agents/mind-forge/agents/forge-chief.md +0 -293
- package/agents/mind-forge/agents/knowledge-miner.md +0 -280
- package/agents/mind-forge/agents/mind-smith.md +0 -306
- package/agents/mind-forge/checklists/analysis-completeness.md +0 -34
- package/agents/mind-forge/checklists/mind-quality.md +0 -55
- package/agents/mind-forge/data/extraction-lenses.yaml +0 -229
- package/agents/mind-forge/data/forge-kb.md +0 -182
- package/agents/mind-forge/data/kf-classification.yaml +0 -307
- package/agents/mind-forge/skill.md +0 -7
- package/agents/mind-forge/squad.yaml +0 -167
- package/agents/mind-forge/tasks/analyze-knowledge.md +0 -278
- package/agents/mind-forge/tasks/forge-mind.md +0 -199
- package/agents/mind-forge/tasks/ingest-sources.md +0 -130
- package/agents/mind-forge/tasks/playback-validate.md +0 -146
- package/agents/mind-forge/tasks/start.md +0 -137
- package/agents/mind-forge/tasks/validate-mind.md +0 -237
- package/agents/mind-forge/templates/agent-tmpl.md +0 -124
- package/agents/mind-forge/templates/config-tmpl.yaml +0 -17
- package/agents/mind-forge/templates/kb-tmpl.md +0 -66
- package/agents/mind-forge/workflows/wf-mind-forge.yaml +0 -168
- package/agents/squad-forge/README.md +0 -110
- package/agents/squad-forge/agents/forge-chief.md +0 -297
- package/agents/squad-forge/agents/forge-smith.md +0 -535
- package/agents/squad-forge/agents/process-archaeologist.md +0 -398
- package/agents/squad-forge/checklists/architecture-coherence.md +0 -28
- package/agents/squad-forge/checklists/extraction-completeness.md +0 -48
- package/agents/squad-forge/checklists/nuclear-structure-validation.md +0 -61
- package/agents/squad-forge/checklists/squad-operational.md +0 -24
- package/agents/squad-forge/checklists/user-validation.md +0 -23
- package/agents/squad-forge/data/executor-mapping-guide.yaml +0 -135
- package/agents/squad-forge/data/extraction-lenses.yaml +0 -330
- package/agents/squad-forge/data/forge-kb.md +0 -248
- package/agents/squad-forge/data/pu-classification.yaml +0 -229
- package/agents/squad-forge/data/quality-thresholds.yaml +0 -259
- package/agents/squad-forge/squad.yaml +0 -175
- package/agents/squad-forge/tasks/architect-squad.md +0 -398
- package/agents/squad-forge/tasks/assemble-squad.md +0 -831
- package/agents/squad-forge/tasks/extract-process.md +0 -378
- package/agents/squad-forge/tasks/fix-squad.md +0 -334
- package/agents/squad-forge/tasks/generate-prd.md +0 -265
- package/agents/squad-forge/tasks/generate-stories.md +0 -223
- package/agents/squad-forge/tasks/playback-validate.md +0 -263
- package/agents/squad-forge/tasks/rebuild-squad.md +0 -236
- package/agents/squad-forge/tasks/self-test.md +0 -237
- package/agents/squad-forge/tasks/start.md +0 -247
- package/agents/squad-forge/tasks/update-squad.md +0 -262
- package/agents/squad-forge/tasks/validate-squad.md +0 -377
- package/agents/squad-forge/templates/process-map-tmpl.yaml +0 -109
- package/agents/squad-forge/templates/pu-tmpl.yaml +0 -71
- package/agents/squad-forge/templates/squad-blueprint-tmpl.yaml +0 -113
- package/agents/squad-forge/workflows/wf-squad-forge.yaml +0 -300
- package/agents/worker-forge/README.md +0 -58
- package/agents/worker-forge/agents/knowledge-curator.md +0 -170
- package/agents/worker-forge/agents/role-designer.md +0 -150
- package/agents/worker-forge/agents/worker-chief.md +0 -273
- package/agents/worker-forge/agents/worker-smith.md +0 -258
- package/agents/worker-forge/data/worker-forge-kb.md +0 -264
- package/agents/worker-forge/knowledge/autonomous-agent-architectures.md +0 -275
- package/agents/worker-forge/knowledge/delegation-competency-performance.md +0 -256
- package/agents/worker-forge/knowledge/job-design-business-systems.md +0 -296
- package/agents/worker-forge/knowledge/knowledge-management-improvement.md +0 -242
- package/agents/worker-forge/skill.md +0 -7
- package/agents/worker-forge/squad.yaml +0 -101
- package/agents/worker-forge/tasks/assemble-worker.md +0 -239
- package/agents/worker-forge/tasks/discover-needs.md +0 -219
- package/agents/worker-forge/tasks/playback-validate.md +0 -126
- package/agents/worker-forge/tasks/propose-worker.md +0 -112
- package/agents/worker-forge/tasks/research-domain.md +0 -165
- package/agents/worker-forge/tasks/start.md +0 -67
- package/agents/worker-forge/tasks/validate-worker.md +0 -155
- package/agents/worker-forge/workflows/wf-worker-forge.yaml +0 -96
- package/docs/stories/AUROQ-2.1.0-hybrid-runtime.md +0 -64
- package/tests/installer-hybrid.test.mjs +0 -66
- package/tests/onepassword.test.mjs +0 -54
- package/tests/sync-codex-skills.test.mjs +0 -88
- /package/{agents → seeds/agents}/companion/data/contexto-dinamico.md +0 -0
- /package/{agents → seeds/agents}/companion/data/demandas-backlog.md +0 -0
- /package/{agents → seeds/agents}/companion/data/log-decisoes.md +0 -0
- /package/{agents → seeds/agents}/companion/data/padroes-observados.md +0 -0
- /package/{agents → seeds/agents}/companion/knowledge/expert-essencial.md +0 -0
- /package/{business → seeds/business}/campanhas/_template/BRIEFING.md +0 -0
- /package/{business → seeds/business}/campanhas/_template/CHECKLIST.md +0 -0
- /package/{business → seeds/business}/campanhas/_template/DIARIO.md +0 -0
- /package/{business → seeds/business}/campanhas/_template/RETROVISOR.md +0 -0
- /package/{business → seeds/business}/cockpit.md +0 -0
- /package/{business → seeds/business}/templates/tracker-template.md +0 -0
- /package/{docs → seeds/docs}/knowledge/expert-business/criacoes/.gitkeep +0 -0
- /package/{docs → seeds/docs}/knowledge/expert-business/posicionamento/.gitkeep +0 -0
- /package/{docs → seeds/docs}/knowledge/expert-business/posicionamento.md +0 -0
- /package/{docs → seeds/docs}/knowledge/expert-business/produto/.gitkeep +0 -0
- /package/{docs → seeds/docs}/knowledge/expert-business/publico-alvo.md +0 -0
- /package/{docs → seeds/docs}/knowledge/expert-mind/assessments/.gitkeep +0 -0
- /package/{docs → seeds/docs}/knowledge/expert-mind/historia.md +0 -0
- /package/{docs → seeds/docs}/knowledge/expert-mind/identidade/.gitkeep +0 -0
- /package/{docs → seeds/docs}/knowledge/expert-mind/identidade.md +0 -0
- /package/{docs → seeds/docs}/knowledge/expert-mind/proposito/.gitkeep +0 -0
- /package/{docs → seeds/docs}/knowledge/expert-mind/tom-de-voz.md +0 -0
- /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
|
-
|
|
6
|
-
|
|
7
|
-
|
|
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
|
-
|
|
6
|
-
|
|
7
|
-
|
|
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.
|
|
3
|
+
Guia vivo do Auroq OS. Tira dúvidas, ensina e destrava o aluno.
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
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
|
-
|
|
6
|
-
|
|
7
|
-
|
|
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
|
-
|
|
3
|
+
Fábrica de mentes sintéticas e consultores.
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
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
|
-
|
|
6
|
-
|
|
7
|
-
|
|
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
|
|
3
|
+
Cria workers especializados para automação e operações.
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
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
|
|
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
|
|
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` (
|
|
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` (
|
|
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
|
-
###
|
|
66
|
+
### Salvar / Entregar / Puxar Flow
|
|
66
67
|
```
|
|
67
|
-
|
|
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
|
|
8
|
+
Antes de criar QUALQUER artefato:
|
|
8
9
|
|
|
9
10
|
### Gate 1: REUSE — Ja existe?
|
|
10
|
-
- Buscar no Exocortex (docs/knowledge
|
|
11
|
-
- Buscar
|
|
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
|
-
-
|
|
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
|
-
|
|
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
|
-
|
|
|
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`
|
|
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.
|
|
24
|
-
2.
|
|
25
|
-
3.
|
|
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
|
-
|
|
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.
|
package/.claude/settings.json
CHANGED
|
@@ -1 +1,22 @@
|
|
|
1
|
-
{
|
|
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
package/AGENTS.md
CHANGED
|
@@ -1,127 +1,18 @@
|
|
|
1
|
-
# AGENTS.md — Auroq OS
|
|
1
|
+
# AGENTS.md — Auroq OS
|
|
2
2
|
|
|
3
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
14
|
+
Motor (CLI, hooks, scripts), pastas, git, casca (estes ponteiros) e o que VOCÊ criar (memória, docs, cockpit).
|
|
20
15
|
|
|
21
|
-
|
|
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.
|