docs: actualizar paths y simplificar policy de creación de agentes

Se actualizan todas las referencias a dev-scripts para usar los nuevos paths
con subdirectorios server/ y agent/ en:
- .claude/CLAUDE.md — sección de dev-scripts y guía rápida
- .claude/policies/create_agent.md — simplificada y reorganizada como guía ejecutable
- README.md — sección de uso y estructura de directorios
- docs/creating-agents.md — todos los pasos del flujo

La policy create_agent.md se reduce de ~230 a ~140 líneas, eliminando
secciones redundantes y reorganizando como checklist práctico con ruta rápida
via create-full.sh.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-06 21:53:40 +00:00
parent 5697b92ab8
commit bff41b9ccd
4 changed files with 170 additions and 194 deletions
+31 -22
View File
@@ -55,6 +55,8 @@ cmd/launcher/main.go → inicia agentes, tiene rulesRegistry
cmd/agentctl/main.go → CLI de gestión (list, start, stop, remove)
cmd/register/main.go → registra bots en Synapse via admin API
dev-scripts/ → scripts bash para operaciones del día a día
dev-scripts/server/ → gestión del launcher (start, stop, restart, ps, logs, dashboard)
dev-scripts/agent/ → gestión de agentes (new, register, verify, avatar, remove, list)
```
## Políticas para LLMs
@@ -103,42 +105,49 @@ Secciones principales del config: `agent`, `personality`, `llm`, `tools`, `matri
Guía rápida (detalle completo en `docs/creating-agents.md`, policy en `.claude/policies/create_agent.md`):
1. Crear scaffold: `./dev-scripts/new-agent.sh <id> "Display Name"` o manual en `agents/<id>/`
1. Crear scaffold: `./dev-scripts/agent/new-agent.sh <id> "Display Name"` o manual en `agents/<id>/`
2. Crear `agent.go` (reglas puras), `config.yaml`, `prompts/system.md`
3. Registrar en `cmd/launcher/main.go` → import + `rulesRegistry`
4. Registrar en Matrix: `./dev-scripts/register.sh <id> "Display Name"`
5. Avatar y nombre: `./dev-scripts/avatar.sh <id> static/<imagen>.jpg`
4. Registrar en Matrix: `./dev-scripts/agent/register.sh <id> "Display Name"`
5. Avatar y nombre: `./dev-scripts/agent/avatar.sh <id> static/<imagen>.jpg`
6. Verificación E2EE: `go run -tags goolm ./cmd/verify --homeserver ... --username <id> --password ... --token ...`
7. Arrancar: `./dev-scripts/start.sh <id>`
7. Arrancar: `./dev-scripts/server/start.sh <id>`
## Dev-scripts disponibles
```bash
./dev-scripts/list.sh # ver todos los bots y estado
./dev-scripts/start.sh [agent-id] # iniciar uno o todos
./dev-scripts/stop.sh [agent-id] # detener uno o todos
./dev-scripts/restart.sh [agent-id] # reiniciar uno o todos
./dev-scripts/ps.sh [agent-id] # procesos con detalle (PID, mem, CPU, uptime)
./dev-scripts/remove.sh <agent-id> # deshabilitar (sin borrar datos)
./dev-scripts/register.sh <id> [name] # registrar bot en Matrix
./dev-scripts/logs.sh [agent-id] # tail -f de logs
./dev-scripts/new-agent.sh <id> [name] # scaffold completo
# === server/ — gestión del launcher ===
./dev-scripts/server/start.sh # iniciar el launcher
./dev-scripts/server/stop.sh # detener el launcher
./dev-scripts/server/restart.sh # reiniciar el launcher
./dev-scripts/server/ps.sh # procesos con detalle (PID, mem, CPU, uptime)
./dev-scripts/server/logs.sh [lines] # tail -f de logs
./dev-scripts/server/dashboard.sh # TUI interactiva
# Gestión unificada del servidor
./dev-scripts/server.sh start [id] # iniciar agentes
./dev-scripts/server.sh stop [id] # detener agentes
./dev-scripts/server.sh restart [id] # reiniciar agentes
./dev-scripts/server.sh status # resumen general del servidor
./dev-scripts/server.sh ps [id] # procesos con detalle
./dev-scripts/server.sh logs [id] # tail -f de logs
./dev-scripts/server.sh kill [id] # SIGKILL forzado (emergencia)
# Gestión unificada (wrapper)
./dev-scripts/server/server.sh start # iniciar
./dev-scripts/server/server.sh stop # detener
./dev-scripts/server/server.sh restart # reiniciar
./dev-scripts/server/server.sh status # resumen general del servidor
./dev-scripts/server/server.sh ps # procesos con detalle
./dev-scripts/server/server.sh logs # tail -f de logs
./dev-scripts/server/server.sh kill # SIGKILL forzado (emergencia)
# === agent/ — gestión de agentes ===
./dev-scripts/agent/list.sh # ver todos los bots y estado
./dev-scripts/agent/new-agent.sh <id> [name] # scaffold completo
./dev-scripts/agent/register.sh <id> [name] # registrar bot en Matrix
./dev-scripts/agent/verify.sh [agent-id] # verificación E2EE
./dev-scripts/agent/avatar.sh <id> <img> # subir avatar
./dev-scripts/agent/reset-password.sh <id> # resetear password
./dev-scripts/agent/remove.sh <agent-id> # deshabilitar (sin borrar datos)
```
PID files: `run/<id>.pid` | Log files: `run/<id>.log`
## Gestión de procesos
Los bots corren como procesos independientes lanzados por `agentctl` o `dev-scripts/start.sh`.
Los bots corren como procesos independientes lanzados por `agentctl` o `dev-scripts/server/start.sh`.
Cada proceso escribe su PID en `run/<id>.pid` y su log en `run/<id>.log`.
`is_running()` usa `kill -0 <pid>` para verificar sin matar el proceso.