diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
index 7868104..c13e0c0 100644
--- a/.claude/CLAUDE.md
+++ b/.claude/CLAUDE.md
@@ -59,16 +59,17 @@ dev-scripts/server/        → gestión del launcher (start, stop, restart, ps,
 dev-scripts/agent/         → gestión de agentes (new, register, verify, avatar, remove, list)
 ```
 
-## Políticas para LLMs
+## Reglas 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`.
+Las reglas guían cómo ejecutar tareas específicas respetando la arquitectura del proyecto.
+Ver índice completo en `.claude/rules/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 |
-| `.claude/policies/create_command.md` | Al añadir un comando directo (!xxx) a un agente |
+| Regla | Cuándo aplicarla |
+|-------|------------------|
+| `.claude/rules/create_agent.md` | Al crear un nuevo bot/agente Matrix |
+| `.claude/rules/create_tool.md` | Al añadir una nueva tool para function calling |
+| `.claude/rules/create_command.md` | Al añadir un comando directo (!xxx) a un agente |
+| `.claude/rules/create_issue.md` | Al crear un nuevo issue en `dev/issues/` |
 
 Documentación detallada para humanos en `docs/creating-agents.md`.
 
@@ -104,7 +105,7 @@ Secciones principales del config: `agent`, `personality`, `llm`, `tools`, `matri
 
 ## Cómo añadir un nuevo bot
 
-Guía rápida (detalle completo en `docs/creating-agents.md`, policy en `.claude/policies/create_agent.md`):
+Guía rápida (detalle completo en `docs/creating-agents.md`, regla en `.claude/rules/create_agent.md`):
 
 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`
@@ -173,6 +174,11 @@ Nunca commitear `.env`. Plantilla en `.env.example`.
 - **Go version**: 1.23.5 en `/usr/local/go/bin`
 - **No usar** frameworks de agentes externos — arquitectura propia
 
+## Documentacion de desarrollo
+
+Ver `dev/README.md` para el indice de documentacion interna (issues pendientes, diseños tecnicos, etc.).
+Issues detallados en `dev/issues/`.
+
 ## Próximas extensiones naturales
 
 - Scheduling: cron runner en `shell/` para `ScheduleCfg`
diff --git a/skills/README.md b/skills/README.md
index 9f80d45..8a98a33 100644
--- a/skills/README.md
+++ b/skills/README.md
@@ -59,4 +59,4 @@ Cuerpo markdown con instrucciones completas (< 500 lineas idealmente).
 3. Opcionalmente agregar scripts/, references/, templates/, assets/
 4. La skill estara disponible automaticamente para agentes con `skills.enabled: true`
 
-Ver policy completa en `.claude/policies/create_skill.md` (pendiente).
+Ver regla completa en `.claude/rules/create_skill.md` (pendiente).