🧭 ¿Qué es esta skill?
Es la metodología SSTDG empaquetada como skill de Claude Code: 8 fases (Stack → Brief → Estrategia de conversión → Principios de diseño → Copy → Construcción → Review y Polish → Handoff y Deploy) que envuelven el stack técnico ya probado, sin asumir integraciones (Stripe, Odoo, captcha, GA4...) que el proyecto no necesita.
No es un scaffolder de código — es la capa de método y decisiones. La Fase 5 (Construcción) delega en las skills técnicas de siempre; SSTDG aporta lo que esas no cubren: brief, estrategia, diseño, copy, review y el cierre con aprendizaje.
Lo más particular: aprende sola. Al cerrar la Fase 7 de cada proyecto real, actualiza automáticamente sus propios checklists de referencia y añade una entrada a LEARNINGS.md — no es una plantilla estática, cada landing nueva hereda lo aprendido en la anterior.
📖 Vista general de la metodología: Regalo 8 en Workshop de IA.
📁 Estructura de la skill
La skill se organiza en 16 archivos Markdown, pensados para cargarse fase por fase (no todos de golpe):
skill/
SKILL.md → punto de entrada: las 8 fases, Fase 0, reglas y protocolo de aprendizaje
phases/
01-brief.md → Fase 1: qué es el proyecto, para quién, qué necesita
02-estrategia-conversion.md → Fase 2: funnel, CTA principal, objeciones, prueba social
03-principios-diseno.md → Fase 3: dirección visual, tono, referencias
04-copy.md → Fase 4: contenido real sección por sección
05-construccion.md → Fase 5: a qué skill técnica delegar, log de decisiones
06-review-polish.md → Fase 6: checklist de "compila y corre" a "listo para publicar"
07-handoff-deploy.md → Fase 7: deploy, checklist de entrega, y el paso de aprendizaje
reference/
stack-decision-matrix.md → Fase 0: qué integraciones (Stripe, Odoo, captcha, GA4...) aplican y cuándo
conversion-structure.md → esqueleto de 9 bloques de sección para Fases 2 y 4
seo-checklist.md → checklist de SEO para Fases 5 y 6
security-checklist.md → checklist de seguridad para Fases 0 y 6
LEARNINGS.md → bitácora fecha/proyecto/qué cambió/por qué, se actualiza sola al cerrar cada proyecto
Cada archivo de fase sigue el mismo patrón: un objetivo, la salida esperada (docs/sstdg/0N-nombre.md dentro del proyecto de esa landing) y las preguntas o pasos concretos de esa fase — se carga solo cuando la metodología entra a esa fase, no de una sola vez.
📋 SKILL.md — listo para copiar
Este es el archivo de entrada completo de la skill. Cópialo tal cual a .claude/skills/sstdg-landing-methodology/SKILL.md en tu proyecto (o donde tu herramienta de agentes espere las skills) — los archivos de phases/ y reference/ que referencia van en el zip de recursos, más abajo.
---
name: sstdg-landing-methodology
description: Metodología propia de ramonjmz (SSTDG) para crear landing pages de principio a fin — desde el brief hasta el deploy — con un stack que se adapta al proyecto (Next.js + Tailwind + shadcn/ui, y opcionalmente Stripe, Odoo CRM, GA4/Meta Pixel, captcha/seguridad, SEO). Úsala SIEMPRE que el usuario diga "crea una nueva landing", "necesito una landing", "arranca un proyecto de landing nuevo" o equivalentes — es el punto de entrada por defecto para cualquier landing nueva, y decide caso por caso si delega en `course-landing-full-stack`, `landing-from-prd` y/o `stripe-odoo-checkout-flow` para la parte técnica. También úsala si el usuario pide "auditar con la metodología SSTDG" una landing ya existente, o "añade [X] a la metodología SSTDG" para actualizarla con un aprendizaje nuevo.
---
# Metodología SSTDG (by ramonjmz)
Metodología de 8 fases para construir landing pages de alta conversión, de principio a fin. No es un scaffolder de código — es la capa de **método y decisiones** que envuelve tu stack técnico ya probado. Cada landing nueva pasa por las 8 fases en orden; el stack técnico exacto se decide por proyecto, no se asume.
**Relación con tus otras skills** (no las duplica, las orquesta):
- Fase 5 (Construcción) delega en [`course-landing-full-stack`](../course-landing-full-stack/SKILL.md) (clonar el proyecto de referencia) o [`landing-from-prd`](../landing-from-prd/SKILL.md) (scaffold desde cero si no aplica clonar).
- Si el proyecto vende algo, Fase 5 delega también en [`stripe-odoo-checkout-flow`](../stripe-odoo-checkout-flow/SKILL.md).
- SSTDG aporta lo que esas tres no cubren: Brief, Estrategia de conversión, Principios de diseño, Copy (fases 1-4) y Review visual/Polish, Handoff, Deploy con checklist propio (fases 6-8).
## Dónde viven los outputs
Cada landing ya vive en su propia carpeta dentro de `/Users/ramonjmz/Claude/01. Landing Builder/<nombre-proyecto>/`. Los documentos de cada fase se guardan **dentro del proyecto de esa landing**, no en un repositorio central:
```
<nombre-proyecto>/
docs/sstdg/
00-stack-decision.md
01-brief.md
02-estrategia-conversion.md
03-principios-diseno.md
04-copy.md
05-construccion.md (log de decisiones técnicas, no el código)
06-review-polish.md
07-handoff-deploy.md
```
Si `docs/sstdg/` no existe todavía en un proyecto nuevo, créala al arrancar la Fase 1. Si el proyecto ya tenía una carpeta `Docs/` de otra convención (ver `course-landing-full-stack`), `docs/sstdg/` convive con ella — no la reemplaces, son cosas distintas (una es la copy fuente, esta es el rastro de decisiones de método).
## Las 8 fases
Ejecuta las fases **en orden**, sin saltarte ninguna aunque el proyecto parezca simple — la disciplina de pasar por las 8 (aunque una fase tome dos líneas en un proyecto pequeño) es lo que evita el patrón real de "construimos rápido y luego reescribimos el copy/posicionamiento tres veces". Cada fase tiene su propio archivo de referencia con el detalle — cárgalo cuando entres a esa fase, no todos de golpe:
0. [`reference/stack-decision-matrix.md`](reference/stack-decision-matrix.md) — decide el stack ANTES del brief formal (ver más abajo).
1. [`phases/01-brief.md`](phases/01-brief.md) — qué es el proyecto, para quién, qué necesita realmente.
2. [`phases/02-estrategia-conversion.md`](phases/02-estrategia-conversion.md) — funnel, CTA principal, objeciones, prueba social.
3. [`phases/03-principios-diseno.md`](phases/03-principios-diseno.md) — dirección visual, tono, referencias.
4. [`phases/04-copy.md`](phases/04-copy.md) — contenido real sección por sección.
5. [`phases/05-construccion.md`](phases/05-construccion.md) — delega en las skills técnicas, registra decisiones.
6. [`phases/06-review-polish.md`](phases/06-review-polish.md) — pase visual + checklist de seguridad/SEO/accesibilidad.
7. [`phases/07-handoff-deploy.md`](phases/07-handoff-deploy.md) — deploy, checklist de entrega, y el paso de aprendizaje (§ Aprendizaje).
## Fase 0 — Decidir el stack (antes de todo)
**No asumas Stripe + Odoo + captcha + GA4 + Meta Pixel en cada landing.** Antes de arrancar la Fase 1, lee [`reference/stack-decision-matrix.md`](reference/stack-decision-matrix.md) y decide con el usuario (una sola tanda de `AskUserQuestion`, no una por integración):
- ¿Este proyecto cobra algo directamente (→ Stripe + Odoo) o es solo captación de leads (→ formulario/WhatsApp, sin checkout)?
- ¿Necesita analítica (GA4/Meta Pixel) desde el día uno o se añade después?
- ¿El formulario de contacto/registro es público y sin fricción (→ necesita captcha/rate-limit) o es un enlace compartido de bajo volumen (→ no lo necesita todavía)?
- ¿Hay un proyecto de referencia clonable (`course-landing-full-stack`) o este arranca de cero (`landing-from-prd`)?
Registra la decisión en `docs/sstdg/00-stack-decision.md` (usa la plantilla del archivo de referencia) — esto es lo que Fase 5 lee para saber qué construir, y lo que Fase 7 usa para armar el checklist de handoff correcto (no tiene sentido pedir credenciales de Stripe en el handoff de una landing sin pagos).
## Qué NO hacer (aplica a las 8 fases)
- **No saltar directo a Fase 5 (construcción)** porque "ya sabes lo que quiere el cliente" — incluso un brief de 10 minutos en Fase 1 evita el patrón real y repetido de reescribir posicionamiento/copy después de lanzar.
- **No asumir el stack completo por defecto.** Cada integración (Stripe, Odoo, captcha, GA4, Meta Pixel) se decide en Fase 0 con una razón, no se copia automáticamente del último proyecto.
- **No inventar contenido que lea como real** — sin testimonios inventados, precios inventados, credenciales inventadas, casos de éxito inventados. Placeholder honesto (`"Próximamente"` + `// TODO:`) siempre que falte un dato real (mismo criterio que `landing-from-prd` §0 y `course-landing-full-stack` §2).
- **No mezclar cuentas de Stripe/Odoo de otro proyecto** — cada landing que cobra es un negocio/producto distinto aunque el patrón de código sea idéntico; nunca reusar productos, prices o records de otro proyecto.
- **No declarar "listo" sin pasar por Fase 6 completa** (visual + seguridad + SEO) ni sin el checklist de Fase 7 — "compila y corre" no es lo mismo que "revisado".
- **No dejar credenciales reales en el repo** ni pegarlas en `docs/sstdg/*.md` — esos documentos son de método/decisiones, no de secretos. Igual que las skills técnicas: secretos van a `.env.local`/Vercel, nunca al repo ni a estos docs.
- **No actualizar la metodología (`reference/*.md`, `LEARNINGS.md`) a mitad de un proyecto activo** — los aprendizajes se registran al cerrar Fase 7 (ver § Aprendizaje), para no reescribir las reglas mientras las estás aplicando.
## Aprendizaje (la metodología va aprendiendo sola)
Al cerrar la Fase 7 de cada proyecto, actualiza automáticamente y sin pedir confirmación:
1. **[`LEARNINGS.md`](LEARNINGS.md)** — añade una entrada nueva (fecha, proyecto, qué se descubrió/cambió y por qué) siguiendo el formato del archivo.
2. Si el aprendizaje es una regla reusable (no un detalle de un solo proyecto), refléjalo también en el archivo de referencia que corresponda: una capa de seguridad nueva → [`reference/security-checklist.md`](reference/security-checklist.md); una mejora SEO → [`reference/seo-checklist.md`](reference/seo-checklist.md); un criterio de cuándo usar qué integración → [`reference/stack-decision-matrix.md`](reference/stack-decision-matrix.md).
Esto es automático porque así lo pidió el usuario — no preguntes "¿quieres que actualice la metodología?" cada vez. Sí avisa en el reporte de handoff qué archivos de la metodología se actualizaron y por qué, para que quede a la vista. Ver el detalle completo del protocolo en `phases/07-handoff-deploy.md` § Aprendizaje.
📦 Zip con la skill completa
🚧 Próximamente aquí mismo: el .zip con los 16 archivos completos (phases/, reference/ y LEARNINGS.md), listo para descomprimir directo en tu carpeta de skills.