From df714c44ddb086b73369d6f9da503a22fb81211e Mon Sep 17 00:00:00 2001 From: Enmanuel Date: Fri, 6 Mar 2026 00:55:20 +0000 Subject: [PATCH] docs: update references after agent directory rename and devops removal MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- .claude/CLAUDE.md | 7 ++----- .claude/plans/03-bot-interaction.md | 5 +---- .claude/policies/create_agent.md | 2 +- README.md | 14 +------------- docs/creating-agents.md | 3 +-- docs/e2ee.md | 7 +++---- 6 files changed, 9 insertions(+), 29 deletions(-) diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md index e50af07..d6ace34 100644 --- a/.claude/CLAUDE.md +++ b/.claude/CLAUDE.md @@ -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_ # 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 diff --git a/.claude/plans/03-bot-interaction.md b/.claude/plans/03-bot-interaction.md index de5f6f0..fc919ca 100644 --- a/.claude/plans/03-bot-interaction.md +++ b/.claude/plans/03-bot-interaction.md @@ -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 diff --git a/.claude/policies/create_agent.md b/.claude/policies/create_agent.md index 063ce92..d942061 100644 --- a/.claude/policies/create_agent.md +++ b/.claude/policies/create_agent.md @@ -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 diff --git a/README.md b/README.md index 4535f84..5ab1c6a 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/docs/creating-agents.md b/docs/creating-agents.md index 92c3810..35f5722 100644 --- a/docs/creating-agents.md +++ b/docs/creating-agents.md @@ -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, } ``` diff --git a/docs/e2ee.md b/docs/e2ee.md index c6d341b..57a96c5 100644 --- a/docs/e2ee.md +++ b/docs/e2ee.md @@ -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.