egutierrez
bcbbd974e3
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>
24 lines
1.3 KiB
Markdown
24 lines
1.3 KiB
Markdown
# Políticas del proyecto
|
|
|
|
Guías operativas para LLMs que trabajan en este codebase. Cada política describe cómo ejecutar una tarea específica respetando la arquitectura y convenciones del proyecto.
|
|
|
|
## Políticas disponibles
|
|
|
|
| Política | Archivo | Cuándo aplicarla |
|
|
|----------|---------|------------------|
|
|
| **Crear agente** | [create_agent.md](create_agent.md) | Al crear un nuevo bot/agente Matrix completo |
|
|
| **Crear herramienta** | [create_tool.md](create_tool.md) | Al añadir una nueva tool para LLM function calling |
|
|
|
|
## Cuándo consultar las políticas
|
|
|
|
- **Crear agente**: cuando el usuario pida crear un nuevo bot, agente, o asistente. Incluye la estructura de archivos, reglas puras, config YAML, system prompt y registro en el launcher.
|
|
- **Crear herramienta**: cuando el usuario pida añadir una nueva herramienta/tool al sistema. Incluye el patrón Def (puro) + Exec (impuro), registro en runtime.go y habilitación en config.
|
|
|
|
## Principio general
|
|
|
|
Todas las políticas respetan el patrón **pure core / impure shell**:
|
|
- `pkg/` es puro — nunca añadir side effects
|
|
- `shell/` es impuro — todo I/O va aquí
|
|
- `agents/` compone ambos — reglas puras + ensamblado con shell
|
|
- `tools/` sigue el mismo patrón: `Def` (datos puros) + `Exec` (función impura)
|