[DOC] Añadir sección AI Agent Skills & Prompt Guidance al inicio de copilot-instructions.md para centralizar mejores prácticas y skills detallados.

.github/copilot-instructions.md

@@ -1,3 +1,43 @@
+# AI Agent Skills & Prompt Guidance
+
+Para máxima productividad y calidad, los agentes AI deben seguir estas pautas y consultar los archivos de skills detallados:
+
+## 1. Skills por Lenguaje/Stack
+
+- **Python/Odoo ORM**: `.github/skills/python.md`
+- **XML/Odoo Views**: `.github/skills/xml.md`
+- **HTML/CSS/QWeb**: `.github/skills/html_css.md`
+- **JavaScript/Odoo Web**: `.github/skills/javascript.md`
+
+## 2. Ejecución de tests
+
+Siempre usa:
+
+```bash
+docker-compose run odoo odoo -d odoo --test-enable --stop-after-init -u addon_name
+```
+
+> NOTA: Usa `docker-compose run` (no `exec`) para evitar efectos de caché.
+
+## 3. Patrones y convenciones clave
+
+- Sigue OCA guidelines y skills.
+- No pongas lógica en QWeb, solo acceso a datos preparados en el controller.
+- Usa `main_seller_id` en vez de `default_supplier_id` en product_main_seller.
+- Para bulk updates, prefiere `search().write()` sobre loops.
+
+## 4. Errores comunes a evitar
+
+- No uses `_()` en definiciones de campos, solo en métodos ejecutables.
+- No pongas lógica de negocio en JavaScript, solo en Python.
+- No uses estilos inline en QWeb salvo casos justificados.
+
+## 5. Documentación y referencias
+
+- Consulta este archivo para patrones globales.
+- Consulta los archivos de skills para detalles por lenguaje.
+- Para troubleshooting de templates, revisa `docs/QWEB_BEST_PRACTICES.md` y `docs/FINAL_SOLUTION_SUMMARY.md`.
+
 # GitHub Copilot Instructions - Kidekoop Addons Custom
 
 ## Project Overview
@@ -157,7 +197,9 @@ docker-compose exec odoo odoo -d odoo -u addon_name --stop-after-init
 docker-compose logs -f odoo
 
 # Ejecutar tests
-docker-compose exec odoo odoo -d odoo --test-enable --stop-after-init -u addon_name
+docker-compose run odoo odoo -d odoo --test-enable --stop-after-init -u addon_name
+
+# NOTA: Usa `docker-compose run` (no `exec`) para lanzar un contenedor limpio y evitar efectos de caché. Cambia `addon_name` por el módulo a testear.
 
 # Acceder a shell de Odoo
 docker-compose exec odoo bash