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:
+31
-22
@@ -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.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user