From 625b9582b356401c6ac86dd4215dcebda8f08d25 Mon Sep 17 00:00:00 2001
From: snt <snt@esgaroth.criptomart.net>
Date: Fri, 20 Feb 2026 20:29:43 +0100
Subject: [PATCH] =?UTF-8?q?[DOC]=20A=C3=B1adir=20secci=C3=B3n=20AI=20Agent?=
 =?UTF-8?q?=20Skills=20&=20Prompt=20Guidance=20al=20inicio=20de=20copilot-?=
 =?UTF-8?q?instructions.md=20para=20centralizar=20mejores=20pr=C3=A1cticas?=
 =?UTF-8?q?=20y=20skills=20detallados.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/copilot-instructions.md | 44 ++++++++++++++++++++++++++++++++-
 1 file changed, 43 insertions(+), 1 deletion(-)

diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
index a62dd49..ad05bc1 100644
--- a/.github/copilot-instructions.md
+++ b/.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