🌱 Empieza aquí · Arreglos de tienda Shopify en rondas seguras

Esta semilla le enseña a tu asistente una disciplina de oro para tocar tu tienda Shopify: nunca editar la tienda viva directo. En vez de eso, arregla los defectos en rondas, prueba cada cambio en un tema de pruebas con contraseña, lo revisa a tamaño real en escritorio y celular, verifica que no rompió el SEO, y solo publica a la tienda que ven tus clientes cuando tú lo firmas. Menos sustos en producción, cero "lo arreglé pero rompí otra cosa".

Para instalarla

Abre esta carpeta con Claude Code o Cowork y dile a tu asistente:

"Siembra esta semilla 🌱"

Con eso basta de tu parte. Tu asistente hace todo lo demás y al final te dice cómo comprobar que quedó funcionando. Vas a ver algunas palabras en inglés en la pantalla (Shopify, staging, Liquid); ni caso, él te guía.

¿Otras formas de pedírselo? "instala esta semilla", "pon a funcionar el método de arreglos de tema Shopify", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Este componente es un workflow (método de trabajo), no un programa ejecutable. No es un hook (gancho de automatización): no lleva chmod, no lleva entrada en settings.json y no ejecuta ningún script. Se "siembra" colocando el método donde tú, el asistente, lo leas de forma automática cuando trabajes con la tienda, para aplicar la disciplina staging-primero por tu cuenta.

1. Copia el método donde lo leas siempre

El kernel trae dos archivos:

• kernel/fix-tema-shopify.md — el método en sí (la disciplina staging-primero, las 4 fases, el control de calidad).
• kernel/lista-de-fixes.ejemplo.md — una plantilla para capturar los defectos a arreglar.

Coloca fix-tema-shopify.md en el lugar que tu plataforma carga como instrucción permanente:

Claude Code (macOS / Linux / Windows con Git Bash):

mkdir -p "$HOME/.claude/rules"
cp kernel/fix-tema-shopify.md "$HOME/.claude/rules/fix-tema-shopify.md"

Los archivos dentro de ~/.claude/rules/ se cargan solos al inicio de cada sesión. Copia ahí solo fix-tema-shopify.md. La plantilla de fixes NO va en esa carpeta (es una guía que usas en el paso 2, cuando llegue una lista real de defectos).

Cowork: usa la misma carpeta de reglas si tu proyecto la soporta (.claude/rules/fix-tema-shopify.md). Si no, coloca fix-tema-shopify.md dentro del proyecto y agrega una línea que apunte a él en el archivo de instrucciones del proyecto (el CLAUDE.md), por ejemplo: "Cuando arregle la tienda Shopify, aplica siempre el método de fix-tema-shopify.md: staging primero, publicar solo tras firma."

Codex: Codex lee su archivo de instrucciones AGENTS.md. Copia el contenido de fix-tema-shopify.md dentro de AGENTS.md (o agrégale un puntero al archivo si lo guardas aparte en el proyecto), para que el método se cargue con el resto de tus instrucciones.

2. Confirma que las herramientas están listas

El método usa herramientas de plataforma (no propietarias). Antes de la primera ronda, verifica que la persona tenga:

• Shopify CLI instalado (@shopify/cli, requiere Node ≥ 20). Compruébalo con shopify version. Con eso corres shopify theme pull / push / check.
• Acceso a la tienda (usuario con permisos para duplicar/publicar temas).
• Una herramienta de QC visual (por ejemplo Chrome DevTools o Playwright) para revisar el staging a tamaño real en escritorio y celular.

Si alguna falta, díselo a la persona antes de arrancar; no arranques a ciegas.

3. Aterriza el método a ESTA tienda (recomendado)

Cuando llegue una lista real de defectos, abre kernel/lista-de-fixes.ejemplo.md y llénala con los casos reales (un renglón por defecto). Reemplaza los placeholders:

• <TU-PROYECTO> → la carpeta real donde vas a trabajar el tema descargado.
• Mi Tienda STAGING [fecha] → el nombre real que le pondrás al tema de pruebas.

Con esa lista clara, sigue las 4 fases del método: diseñar la ronda → arreglar con validación → probar (data + SEO + QC visual) → decidir (pasa / itera / escala).

4. Verificación post-siembra (obligatoria)

Como es un método (texto), la verificación tiene dos partes: que el archivo quedó en su lugar, y que la disciplina se aplica de verdad.

a) El archivo quedó colocado (ejemplo Claude Code):

ls -la "$HOME/.claude/rules/fix-tema-shopify.md"; echo "exit=$?"

Salida esperada: una línea que lista el archivo (con su tamaño) y exit=0. Si sale No such file or directory, la copia no se hizo; repite el paso 1.

b) La disciplina se aplica (prueba de comportamiento, en una conversación nueva): Pídele a la persona que abra una sesión nueva y te dé un defecto de su tienda para arreglar. La conducta correcta es que propongas trabajar en un tema de staging con contraseña, valides el cambio antes de subirlo, hagas QC visual, y digas explícitamente que NO publicarás a la tienda viva hasta que la persona firme. Si en vez de eso propones editar la tienda viva directo, el método no se cargó: revisa que fix-tema-shopify.md esté en la carpeta de reglas (o dentro de AGENTS.md en Codex).

Cuando ambas partes pasen, avísale a la persona en una línea qué gana con esto.

✅ ¿Cómo sé que funcionó?

De ahora en adelante, cuando le pidas a tu asistente arreglar algo de tu tienda, no va a meter mano directo en producción. Primero va a crear un tema espejo con contraseña, probar ahí, enseñarte el antes/después, y esperar tu "ok, publícalo". La tienda que ven tus clientes deja de ser el lugar donde se experimenta.

No tienes que hacer nada especial en el día a día. Solo vas a notar que los arreglos llegan probados, con capturas de escritorio y celular, y que la decisión de publicar siempre pasa por ti. Eso es todo. 🌱