Instalación Rápida

Instalador nativo - no requiere Node.js

curl -fsSL https://claude.ai/install.sh | bash

Con npm - requiere Node.js 18+

npm install -g @anthropic-ai/claude-code

Nivel 1 - Modo Planificación (Planning Mode)

Aprovecha la herramienta para hacer preguntas al usuario antes de ejecutar código. Garantiza precisión milimétrica.

En lugar de empezar a picar código a ciegas, puedes iniciar Claude Code diciendo:

> Necesito crear un automatizador en Python para enviar emails a los alumnos. Usa el modo planificación para crear un plan detallado antes de escribir código.

Claude usará la herramienta interna askUserQuestions para aclarar el contexto (ej. ¿Usaremos la API de SendGrid o SMTP?, ¿Dónde guardamos los logs?) y generará un archivo plan.md estructurado. Tú apruebas el plan primero, y solo entonces, empieza a programar.

Nivel 2 - EL FRAMEWORK CLAUDE.md

Construye una Máquina de Contenido o Código que Suene como Tú

Tu archivo CLAUDE.md es lo primero que Claude lee en cada sesión. Si lo haces bien, Claude escribirá con tu tono y seguirá tus reglas desde el principio. Si lo haces mal, pasarás más tiempo editando que creando.

La regla de oro: Corto. Específico. Solo añade lo que Claude no puede deducir por sí mismo.

✅ PREGUNTA 1: ¿QUÉ ES ESTO?

Una línea. Orienta a Claude inmediatamente. No un párrafo. No un manifiesto de tu marca.

✅ PREGUNTA 2: ¿CÓMO SE EJECUTA?

Los pasos exactos. Nada que Claude tenga que adivinar.

• El calendario de contenidos está en Notion — extrae los temas de la vista "Listos para escribir"
• Los posts generados van a /output/drafts como archivos markdown, uno por plataforma
• Las imágenes y recursos de marca se guardan en /assets/brand
• Para previsualizar: abre los borradores y revísalos antes de copiarlos a la herramienta de programación

✅ PREGUNTA 3: ¿QUÉ PATRONES DEBO SEGUIR?

Aquí es donde ocurre la magia. Tu voz, tus reglas, tus innegociables.

Tono de voz (Frogames Formación):

IMPORTANTE — sigue esto al pie de la letra:

• Escribe como si estuvieras hablando con un estudiante tomando un café, no haciendo una presentación corporativa aburrida.
• Usa frases cortas y directas. Evita el "nosotros" o "nuestro equipo", habla de tú a tú.
• Está bien empezar frases con "Y", "Pero", "Así que".
• Nunca uses lenguaje engañoso o de vendehúmos como: "desbloquea", "revolucionario", "cambio de paradigma", "sinergia".
• El tono es amigable, didáctico y muy técnico pero accesible. Nada de palabras malsonantes.

Formato por plataforma:

• LinkedIn: Línea de gancho (hook) primero, salto de línea, y luego el cuerpo. Termina siempre con una pregunta o CTA (llamada a la acción).
• X (Twitter): Sin hashtags, hilos de máximo 5 posts, estilo muy conversacional.
• Instagram: Descripciones cortas (menos de 100 palabras), 3-5 hashtags relevantes solo al final.
• Nunca uses emojis como viñetas (bullet points). Máximo un emoji por post, si acaso.

Reglas de contenido:

• Cada post debe enseñar algo técnico o compartir una experiencia real — nada de contenido vacío o genérico.
• Menciona herramientas específicas (Unity, Python, N8N, Claude), números o resultados siempre que sea posible.
• Al mencionar herramientas de IA, posicionalas como "asistentes", no como reemplazos de los programadores.
• Mi audiencia son estudiantes, desarrolladores y emprendedores tecnológicos. Mantén la explicación clara.

✅ PREGUNTA 4: ¿QUÉ COSAS RARAS HAY AQUÍ? (GOTCHAS)

Las excepciones y cosas contra-intuitivas que podrían confundir a Claude.

• En Notion hay columnas de "Estado" y "Estado del Post" — usa "Estado del Post" (la otra es antigua).
• A LinkedIn no le gustan los posts que empiezan con un enlace externo — nunca empieces con una URL.
• Los temas marcados como "Reciclar" deben reescribirse a partir de un artículo del blog en /content/blog, no desde cero.
• La carpeta /templates tiene formatos viejos que ya no uso en Frogames — ignórala completamente.

✅ PREGUNTA 5: ¿CÓMO TRABAJAMOS?

El proceso. Qué ocurre antes, durante y después de crear el contenido o el código.

• Siempre genera 3 variaciones de cada post/código para que pueda elegir mi favorito.
• Nomenclatura de archivos: [fecha]-[plataforma]-[tema].md (ej. 2026-02-04-linkedin-claude-code-tips.md).
• Nunca publishes ni programes nada automáticamente — solo borradores, yo lo reviso todo.
• Si un tema no está claro, escribe una interpretación de 1 línea al principio del borrador.
• Cuando recicles contenido, cambia el ángulo/enfoque — no te limites a resumir el original.

✅ EL TRUCO DE "APUNTAR, NO VOLCAR"

Mantén CLAUDE.md limpio. Dile a Claude dónde encontrar los detalles, no pongas todos los detalles ahí dentro.

• Para la guía completa de la voz de marca con ejemplos, mira /docs/brand-voice.md.
• Para las categorías y temáticas de los pilares de contenido, ve a /docs/content-pillars.md.
• Para ver ejemplos de los mejores posts del pasado, revisa la carpeta /content/best-performers/.

Claude lee estos archivos solo cuando es necesario. Tu archivo principal se mantiene rápido y enfocado.

✅ PLANTILLA LISTA PARA COPIAR Y PEGAR

# Proyecto
[Una frase: qué hace esto, qué plataformas o stack usa, de dónde vienen las tareas]

# Cómo Funciona
- [Dónde está el calendario/tareas]
- [Dónde se guardan los borradores/código]
- [Dónde se almacenan los recursos]

# Tono de Voz (Brand Voice)
IMPORTANTE:
- [Cómo suenas — ¿conversacional? ¿autoridad? ¿didáctico?]
- [Palabras/frases que NUNCA usas]
- [Estilo de frases — ¿cortas y directas? ¿storytelling?]

# Reglas de la Plataforma o Código
- LinkedIn/Python: [formato, longitud, convenciones]
- X/Unity: [formato, reglas específicas]

# Gotchas (Cosas a tener en cuenta)
- [Cosas contra-intuitivas de tu proyecto]
- [Archivos legacy que debe ignorar]

# Flujo de trabajo
- [Cuántas variaciones hacer]
- [Convención para nombrar archivos]
- [Qué es lo que Claude NUNCA debe hacer sin tu aprobación]

✅ CONSEJOS PRO

• Si ya tienes un proyecto, ejecuta /init dentro de Claude Code. Leerá tus archivos y redactará un CLAUDE.md por ti. Luego, recorta sin piedad — borrar es más fácil que escribir desde cero.
• Corrige errores en tiempo real: cuando Claude se equivoque a mitad de sesión, simplemente dile: "Añade a mi CLAUDE.md que nunca usamos hashtags en los posts de X".
• Añade la palabra "IMPORTANTE:" a las reglas críticas — esto mejora genuinamente la forma en que Claude sigue las instrucciones.
• Separa lo personal de lo compartido — Usa CLAUDE.md (subido a Git) para el equipo, y CLAUDE.local.md (ignorado en Git) para tus gustos personales.

Nivel 3 - Comandos Slash, Skills y Hooks

Slash Commands (Comandos con barra)

Comandos que activas manualmente en momentos específicos.

• /project:linkedin-post — "escríbeme 3 posts de LinkedIn sobre este tema"
• /project:weekly-batch — "genera todos los posts de esta semana desde el calendario de Notion"

Skills (Habilidades)

Conocimiento en segundo plano que Claude carga automáticamente cuando es relevante. A diferencia de los comandos, las skills pueden incluir carpetas enteras con archivos de soporte.

• brand-voice — tu tono, palabras prohibidas, y una carpeta con 10 posts de ejemplo. Claude usa esto cada vez que escribe algo.
• audience-profile — quiénes son los estudiantes de Frogames, qué les interesa, su nivel técnico.

Ejemplo de plantilla (Skill) para LinkedIn (linkedin-post-template.md):

En lugar de depender de la creatividad de la IA, le das un esqueleto probado que Claude cargará automáticamente:

# Plantilla para Posts de LinkedIn (Frogames)

## Estructura obligatoria:
1. **Gancho (Hook):** Una afirmación contraintuitiva o un problema técnico común. (Máx 2 líneas).
2. **Contexto / Dolor:** Por qué este problema frustra a los desarrolladores.
3. **Solución Técnica:** Explicación clara y concisa (mencionar herramientas como Unity, N8N o Claude).
4. **Cierre / CTA:** Pregunta abierta para los comentarios y enlace a Frogames Formación.

## Ejemplo de post ideal:
"El 99% de los programadores pierde horas configurando IA desde cero.
No tienes que programar todo tú mismo.
Ayer conecté Claude Code con N8N y automaticé mis scripts de ventas en 15 minutos. 
¿Sigues perdiendo el tiempo o ya automatizas? Aprende cómo en cursos.frogamesformacion.com"

Hooks (Ganchos) - No requieren un "Cerebro" 🧠

Los hooks son disparadores automáticos que se ejecutan (como un script bash) sin gastar tokens de la IA. Estos se configuran dentro del archivo .claude/settings.json de tu proyecto.

Hook para detectar palabras prohibidas

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "if echo \"$CLAUDE_FILE_PATH\" | grep -q 'output/drafts'; then grep -inwE 'vendehumos|desbloquea|revolucionario|sinergia' \"$CLAUDE_FILE_PATH\" && echo '⚠️ PALABRAS PROHIBIDAS DETECTADAS — reescribe antes de aprobar' || echo '✅ Sin palabras prohibidas'; fi"
          }
        ]
      }
    ]
  }
}

Hooks para comprobar límite de palabras y auto-formateo

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "if echo \"$CLAUDE_FILE_PATH\" | grep -q 'output/drafts'; then WC=$(wc -w < \"$CLAUDE_FILE_PATH\"); if [ $WC -gt 200 ]; then echo \"⚠️ El post tiene $WC palabras — supera el límite de 200\"; fi; fi"
          },
          {
            "type": "command",
            "command": "if echo \"$CLAUDE_FILE_PATH\" | grep -q '.md$'; then npx prettier --write \"$CLAUDE_FILE_PATH\" 2>/dev/null; fi"
          }
        ]
      }
    ]
  }
}

Nivel 4 - MCPs (Servidores Model Context Protocol)

Un MCP es un puente entre Claude Code y una aplicación externa (Airtable, Notion, GitHub). Claude puede leer tu calendario de contenidos, revisar tareas y crear registros directamente.

Puedes configurar esto creando un archivo llamado .mcp.json en la raíz de tu proyecto, o simplemente usando el comando integrado /mcp add airtable.

Ejemplo de .mcp.json conectando Airtable:

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": ["-y", "airtable-mcp-server"],
      "env": {
        "AIRTABLE_API_KEY": "tu_token_de_acceso_personal"
      }
    }
  }
}

Nivel 5 - Frameworks de Proyectos (GSD)

El framework GSD (Get Shit Done) ayuda a resolver el mayor problema de las sesiones largas de Claude: la pérdida de memoria de la IA o 'context rot' (que suele ocurrir cuando pasas de 10.000 tokens).

GSD estructura tu proyecto creando una carpeta .planning con documentos macro. Aquí tienes un ejemplo real de cómo se ven por dentro:

1. roadmap.md (Las fases del proyecto)

# Roadmap: Automatizador de Embudos Frogames
- [x] Fase 1: Setup del servidor N8N y conexión de APIs (Airtable).
- [ ] Fase 2: Scripts de automatización de emails promocionales.
- [ ] Fase 3: Integración de pagos y facturas con Stripe.

2. requirements.md (Los requisitos técnicos)

# Requisitos Técnicos
- Lenguaje: Python 3.12 y Node.js 18+.
- Base de datos: Supabase (PostgreSQL).
- Regla innegociable: El código final debe estar comentado en español y ser muy didáctico, pensado para que lo entiendan los alumnos de Frogames Formación.

3. state.md (La memoria del progreso)

# Estado Actual
- Fase 1 completada con éxito. El webhook de Airtable responde con status 200 OK.
- Bloqueo actual: La Fase 2 requiere que Juan Gabriel apruebe las plantillas HTML de los emails antes de que Claude empiece a programar los envíos.

Y ejecuta este bucle por cada fase del proyecto:

• /gsd:plan phase X (Genera un plan.md para la fase)
• /gsd:execute phase Z (Genera un summary.md con lo ejecutado)
• /gsd:verify phase Y (Usa un archivo uat.md o Pruebas de Aceptación de Usuario para validar)

Ejemplo de uat.md (Validación de la Fase 1):

# Pruebas de Aceptación: Fase 1 (N8N + Airtable)
## Prueba 1: Conexión N8N
- [ ] Ejecutar el workflow de prueba en N8N local.
- [ ] Verificar que la ejecución no arroja errores en la consola.
## Prueba 2: Inserción en Airtable
- [ ] Enviar un payload JSON de prueba simulando un alumno.
- [ ] Comprobar visualmente que el registro aparece en la tabla "Nuevos Leads" de Airtable en menos de 5 segundos.

Nivel 6 - Equipos de Sub-agentes

Los sub-agentes son "personas" especializadas a las que delegas trabajo en contextos aislados (investigador, revisor de código, arquitecto). Se guardan en la carpeta .claude/agents/.

¿Por qué usarlos?

1. Calidad (En Serie): Como ilustra el grafo superior, cada agente tiene un rol estricto. El investigador navega por internet sacando datos reales, y luego el escritor principal redacta en base a eso. Todo ocurre en la misma sesión pero sin ensuciar el contexto principal.
2. Velocidad (En Paralelo): Abres varias terminales de Claude en paralelo. Una escribe código de Unity, la otra redacta posts para redes.

Ejemplo de content-researcher.md (Investigador):

---
name: content-researcher
description: Investiga temas para contenido. Busca datos y ejemplos reales.
allowed-tools: Read, Grep, Glob, WebSearch, WebFetch
---
# Content Researcher
Eres un especialista en investigación. Encuentra ángulos interesantes, estadísticas y resúmelo en menos de 300 palabras. NUNCA escribas el post final.

Ejemplo de content-reviewer.md (Revisor):

---
name: content-reviewer
description: Revisa los borradores de posts contra las guías de tono. Solo lectura.
allowed-tools: Read, Grep, Glob
---
# Content Reviewer
Eres un revisor de tono de marca. Revisa los borradores en /output/drafts/ y asegúrate de que cumplen las reglas de Frogames y los límites de palabras. NUNCA edites los borradores, solo marca ✅ Pasa o ❌ Falla con los errores encontrados.

Nivel 7 - Pipelines 100% Autónomos

Este es el nivel final. Claude trabaja en un problema complejo mientras tú duermes.

El Bucle Ralph (Ralph Loop):

Escribes historias de usuario en un archivo JSON (prd.json) con criterios de aceptación. Ralph lee la lista, toma la primera tarea, escribe el código, pasa los tests, hace el commit y pasa a la siguiente. Empieza cada bucle con una sesión limpia de Claude (reiniciando el contexto), para evitar la pérdida de memoria ('context rot').

Instalación:

/plugin marketplace add anthropics/claude-code
/plugin install ralph-wiggum

Tu prd.json en Frogames Formación podría verse así:

{
  "project": "Lote de Contenido Semanal - Febrero 2026",
  "stories": [
    {
      "id": "post-001",
      "title": "LinkedIn: Automatización con N8N vs Programar desde cero",
      "description": "Escribe un post de LinkedIn sobre cómo N8N ayuda a crear SaaS rápido. Usa tono Frogames.",
      "acceptance_criteria": [
        "Menos de 200 palabras",
        "Empieza con un gancho potente",
        "Guardado en output/drafts/"
      ],
      "status": "pending"
    }
  ]
}

Luego ejecutas:

/ralph-loop "Procesa el prd.json. Para cada historia 'pending': escribe el post, verifica los criterios y guárdalo. Cuando termines todo, devuelve BATCH_DONE" --completion-promise "BATCH_DONE"