docs: add agent creation guide and LLM policies index
Documentación y políticas para la creación de agentes: - docs/creating-agents.md: guía completa paso a paso para humanos (scaffold, config, registro Matrix, avatar, verificación E2EE, arranque, troubleshooting) - .claude/policies/create_agent.md: policy para LLMs con estructura de archivos, convenciones y reglas a seguir al crear agentes - .claude/policies/index.md: índice de todas las policies disponibles - .claude/policies/create_tool.md: movido desde .claude/rules/ (misma policy) - CLAUDE.md: añadida sección de políticas, actualizada tabla de agentes con asistente-2, y actualizado el flujo de "Cómo añadir un nuevo bot" con pasos de avatar y verificación E2EE Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
+22
-6
@@ -58,11 +58,24 @@ cmd/register/main.go → registra bots en Synapse via admin API
|
||||
dev-scripts/ → scripts bash para operaciones del día a día
|
||||
```
|
||||
|
||||
## Políticas para LLMs
|
||||
|
||||
Las políticas guían cómo ejecutar tareas específicas respetando la arquitectura del proyecto.
|
||||
Ver índice completo en `.claude/policies/index.md`.
|
||||
|
||||
| Política | Cuándo aplicarla |
|
||||
|----------|------------------|
|
||||
| `.claude/policies/create_agent.md` | Al crear un nuevo bot/agente Matrix |
|
||||
| `.claude/policies/create_tool.md` | Al añadir una nueva tool para function calling |
|
||||
|
||||
Documentación detallada para humanos en `docs/creating-agents.md`.
|
||||
|
||||
## Agentes existentes
|
||||
|
||||
| ID | Estado | LLM | Descripción |
|
||||
|----------------|-----------|---------|------------------------------------------|
|
||||
| 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
|
||||
@@ -90,12 +103,15 @@ Secciones principales del config: `agent`, `personality`, `llm`, `tools`, `matri
|
||||
|
||||
## Cómo añadir un nuevo bot
|
||||
|
||||
1. Generar scaffold: `./dev-scripts/new-agent.sh <id> "Display Name"`
|
||||
2. Registrarlo en Matrix: `./dev-scripts/register.sh <id> "Display Name"`
|
||||
3. Añadir el token al `.env`
|
||||
4. Añadir una línea en `cmd/launcher/main.go` → `rulesRegistry`
|
||||
5. Editar `agents/<id>/agent.go` con las reglas reales
|
||||
6. Arrancar: `./dev-scripts/start.sh <id>`
|
||||
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>/`
|
||||
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`
|
||||
6. Verificación E2EE: `go run -tags goolm ./cmd/verify --homeserver ... --username <id> --password ... --token ...`
|
||||
7. Arrancar: `./dev-scripts/start.sh <id>`
|
||||
|
||||
## Dev-scripts disponibles
|
||||
|
||||
|
||||
Reference in New Issue
Block a user