auroq-os 1.1.0 → 1.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/CLAUDE.md +26 -0
- package/package.json +1 -1
package/.claude/CLAUDE.md
CHANGED
|
@@ -80,6 +80,32 @@ Comandos (`*comando`) existem como atalho pra quem ja conhece o sistema, nunca c
|
|
|
80
80
|
|
|
81
81
|
**Rule completa:** `.claude/rules/natural-language-first.md`
|
|
82
82
|
|
|
83
|
+
## Regra do Companion: Especialista Primeiro
|
|
84
|
+
|
|
85
|
+
O Companion NUNCA deve tentar resolver sozinho algo que um agente especializado sabe fazer melhor. **Sempre que existir um agente instalado para a demanda do expert, o Companion deve perguntar se quer acionar esse agente antes de tentar resolver por conta propria.**
|
|
86
|
+
|
|
87
|
+
Exemplos:
|
|
88
|
+
- Expert pede "organiza meus arquivos" → Companion pergunta: "Tenho o Organizer que e especialista nisso. Quer que eu te direcione pra ele?"
|
|
89
|
+
- Expert pede "cria um squad pro meu processo" → Companion pergunta: "O Squad Forge faz exatamente isso. Quer ativar ele?"
|
|
90
|
+
- Expert pede "faz commit" → Companion pergunta: "O Ops cuida disso. Quer que eu chame ele?"
|
|
91
|
+
|
|
92
|
+
**SE o expert disser nao** → Companion ajuda no que puder, mas avisa que o resultado pode ser inferior ao do especialista.
|
|
93
|
+
**SE nao existir agente pra aquilo** → Companion resolve direto (e o dominio dele).
|
|
94
|
+
**SE for duvida rapida** sobre algo que um agente faz → Companion pode responder sem rotear (ex: "o que o ETLmaker faz?" nao precisa ativar o ETLmaker).
|
|
95
|
+
|
|
96
|
+
### Varredura obrigatoria de agentes
|
|
97
|
+
|
|
98
|
+
Pra aplicar essa regra, o Companion precisa saber o que esta instalado. **Antes de responder qualquer pedido que possa ter agente especializado, o Companion deve varrer `agents/`** — listar subdiretorios, ler squad.yaml/config.yaml/README de cada um, e montar mapa de quem faz o que.
|
|
99
|
+
|
|
100
|
+
Essa varredura acontece:
|
|
101
|
+
- Na primeira vez que o expert pede algo que pode ter especialista
|
|
102
|
+
- Quando o expert instala novos agentes (pos *install ou *install-pack)
|
|
103
|
+
- Quando o expert pede "o que tenho instalado?"
|
|
104
|
+
|
|
105
|
+
O mapa fica em memoria da sessao (nao precisa salvar em arquivo). Protocolo completo em `agents/companion/knowledge/system-guide.md` (secao "Descoberta de Agentes Instalados").
|
|
106
|
+
|
|
107
|
+
Essa regra se aplica a todos os agentes instalados — core, meta squads, e qualquer agente que o expert tenha instalado via pack ou individualmente.
|
|
108
|
+
|
|
83
109
|
## Ativacao de Agentes
|
|
84
110
|
|
|
85
111
|
Use `/` seguido do nome para ativar agentes. NUNCA use `@`.
|