docs: update references after agent directory rename and devops removal

Actualizar todas las referencias en documentación para reflejar los
nuevos nombres de directorio (assistant-bot, asistente-2) y la
eliminación del agente devops-bot. Archivos actualizados: CLAUDE.md,
create_agent.md, README.md, e2ee.md, creating-agents.md,
03-bot-interaction.md.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-06 00:55:20 +00:00
parent 1a649fdcb2
commit df714c44dd
6 changed files with 9 additions and 29 deletions
+2 -5
View File
@@ -47,8 +47,7 @@ shell/bus/ → comunicación inter-agente via Go channels
shell/protocols/ → adaptadores MCP (mcp.go)
agents/runtime.go → Agent{}: ensambla core + shell, maneja eventos
agents/assistant/ → reglas puras + config del assistant-bot
agents/devops/ → reglas puras + config del devops-bot
agents/assistant-bot/ → reglas puras + config del assistant-bot
internal/config/schema.go → tipos completos del YAML de configuración
internal/config/loader.go → Load() con expand env vars, LoadMeta() sin validación
@@ -76,7 +75,6 @@ Documentación detallada para humanos en `docs/creating-agents.md`.
|----------------|-----------|---------|------------------------------------------|
| assistant-bot | activo | GPT-4o | Asistente general, responde DMs |
| asistente-2 | activo | GPT-4o | Asistente con tools (current_time) |
| devops-bot | pendiente | Claude | SSH, deployments, healthchecks |
## Dependencias clave
@@ -153,7 +151,6 @@ MATRIX_ADMIN_TOKEN # token admin para registrar bots (cmd/register)
MATRIX_TOKEN_<BOT> # access token de cada bot
OPENAI_API_KEY # OpenAI
ANTHROPIC_API_KEY # Anthropic/Claude
SSH_PRIVATE_KEY_PATH # clave SSH para el devops-bot
```
Nunca commitear `.env`. Plantilla en `.env.example`.
@@ -172,5 +169,5 @@ Nunca commitear `.env`. Plantilla en `.env.example`.
- Conversation history: mantener `[]Message` por room en memoria/SQLite
- RBAC real: conectar `SecurityCfg.Roles` al listener
- E2EE: habilitar `encryption.enabled: true` con crypto store de mautrix
- MCP: exponer tools del devops-bot como MCP server en el puerto configurado
- MCP: exponer tools de los agentes como MCP server en el puerto configurado
- A2A: agent card HTTP endpoint para comunicación con agentes externos
+1 -4
View File
@@ -18,7 +18,6 @@ normales: sin token, sin listener propio, sin `user_id`.
```
agents/
assistant/ → bot normal (Matrix user, token, listener)
devops/ → bot normal
specials/ → componentes de sistema, sin identidad Matrix
orchestrator/ → middleware de coordinación multi-bot
scheduler/ → (futuro) cron runner
@@ -67,7 +66,6 @@ orchestration:
- room_id: "${MATRIX_ROOM_SHARED}"
participants: # bots que participan en esta sala
- id: assistant-bot
- id: devops-bot
```
---
@@ -147,7 +145,6 @@ type QualityScore struct {
System (prompts/routing.md):
Eres un coordinador de agentes. Disponibles:
- assistant-bot: Asistente general, preguntas, resúmenes, redacción
- devops-bot: SSH, deployments, infraestructura
Responde SOLO con el ID del bot más adecuado.
User: [pregunta del humano]
@@ -275,4 +272,4 @@ shell/bus/bus.go → soporte para TaskEvent routing
### Fase 4 — Observabilidad
- Topic del room refleja estado del pipeline en curso
- `"[2/3] devops-bot respondió · evaluando..."` → topic actualizado en tiempo real
- `"[2/3] bot respondió · evaluando..."` → topic actualizado en tiempo real
+1 -1
View File
@@ -229,4 +229,4 @@ Luego seguir con registro, verificación y arranque usando los dev-scripts.
- **No** commitear tokens ni passwords — solo van en `.env`
- **No** compartir crypto stores entre agentes — cada uno tiene su `store_path`
- Si el agente usa tool_use, asegurarse de que `llm.tool_use.enabled: true` en el config
- Usar `agents/asistente2/` como referencia completa de un agente con tools habilitadas
- Usar `agents/asistente-2/` como referencia completa de un agente con tools habilitadas
+1 -13
View File
@@ -84,8 +84,7 @@ agents_and_robots/
├── agents/ ← definición de cada bot
│ ├── runtime.go Agent{}: ensambla core + shell
── assistant/ reglas + config del assistant-bot
│ └── devops/ reglas + config del devops-bot
── assistant/ reglas + config del assistant-bot
├── internal/config/ esquema YAML completo + loader con env vars
@@ -272,17 +271,6 @@ Asistente general con GPT-4o. Responde a DMs y menciones. Sin acceso a herramien
@assistant-bot:matrix-af2f3d.organic-machine.com
```
### devops-bot
Bot de infraestructura. Ejecuta comandos SSH en targets configurados. Requiere `ANTHROPIC_API_KEY`.
Comandos Matrix:
- `!help` — lista de comandos
- `!healthcheck` — health check de producción
- `!status` — estado de servicios
- `!deploy staging` / `!deploy production` (requiere power level ≥ 50)
- `!logs` — últimas líneas de journalctl
---
## Dependencias
+1 -2
View File
@@ -135,7 +135,7 @@ System prompt que recibe el LLM. Debe incluir:
- Estilo de respuesta
- Limitaciones
Usar como referencia: `agents/assistant/prompts/assistant-system.md` o `agents/asistente2/prompts/system.md`.
Usar como referencia: `agents/assistant-bot/prompts/assistant-system.md` o `agents/asistente-2/prompts/system.md`.
## Paso 2: Registrar el agente en el launcher
@@ -151,7 +151,6 @@ mibotAgent "github.com/enmanuel/agents/agents/mibot"
var rulesRegistry = map[string]func() []decision.Rule{
"assistant-bot": assistantagent.Rules,
"mi-bot": mibotAgent.Rules, // ← nuevo
"devops-bot": devopsagent.Rules,
}
```
+3 -4
View File
@@ -41,7 +41,7 @@ Y se referencia en `config.yaml`:
```yaml
encryption:
enabled: true
store_path: "./agents/assistant/data/crypto/"
store_path: "./agents/assistant-bot/data/crypto/"
pickle_key: "${PICKLE_KEY_ASSISTANT_BOT}"
trust_mode: tofu
```
@@ -67,9 +67,8 @@ Un pickle key fijo por agente en `.env` evita este problema.
Cada agente debe tener su propia crypto.db para evitar corrupción cruzada:
```
agents/assistant/data/crypto/crypto.db
agents/asistente2/data/crypto/crypto.db
agents/devops/data/crypto/crypto.db
agents/assistant-bot/data/crypto/crypto.db
agents/asistente-2/data/crypto/crypto.db
```
**No compartir** la crypto store entre agentes.