El arte del prompting
con Claude Code

Eres un desarrollador senior de React/Next.js/TypeScript.

Crea un componente React que [DESCRIPCIÓN DEL COMPONENTE].

Contexto técnico:
- Framework: Next.js 14 (App Router)
- Lenguaje: TypeScript (modo strict)
- Estilo: Tailwind CSS
- Gestión de estado: [zustand / React Context / ninguno]

Especificaciones funcionales:
- [Funcionalidad 1]
- [Funcionalidad 2]
- [Funcionalidad 3]

Restricciones:
- Responsive mobile-first
- Accesible (ARIA, gestión del foco)
- Rendimiento optimizado (memo, lazy loading si es necesario)
- Gestión de errores y estados de carga

Genera el código completo con:
1. El componente principal
2. Los tipos/interfaces de TypeScript
3. Un ejemplo de uso
4. Los tests unitarios (Vitest + Testing Library)

Eres un redactor técnico senior.

Redacta la documentación técnica para [NOMBRE DEL PROYECTO/MÓDULO].

Público objetivo: [desarrolladores junior / equipo interno / open-source]

Estructura esperada:
1. Visión general (2-3 frases)
2. Instalación y requisitos previos
3. Configuración
4. Guía de inicio rápido (Quick Start)
5. Referencia de API (cada función con parámetros, retorno, ejemplo)
6. Ejemplos de uso avanzados
7. FAQ y resolución de problemas

Convenciones:
- Ejemplos de código en [TypeScript/Python/etc.]
- Todos los fragmentos deben ser copiables y funcionales
- Usa admoniciones (nota, aviso, consejo) cuando sea pertinente
- Incluye un índice navegable al principio del documento

Eres un ingeniero DevOps/SRE senior.

Crea un script que automatice [DESCRIPCIÓN DE LA TAREA].

Entorno:
- SO: [Linux/macOS/Windows]
- Lenguaje: [Bash/Python/Node.js]
- Herramientas disponibles: [Docker, GitHub Actions, etc.]

Funcionamiento esperado:
1. [Paso 1 del proceso]
2. [Paso 2 del proceso]
3. [Paso 3 del proceso]

Requisitos:
- Gestión de errores robusta (exit codes, try/catch)
- Logging con niveles (info, warn, error)
- Modo dry-run para probar sin ejecutar
- Variables configurables vía .env o argumentos CLI
- Idempotente (se puede relanzar sin efectos secundarios)

Genera:
1. El script completo y comentado
2. El archivo .env.example
3. El README de uso
4. Un ejemplo de cron/schedule si es pertinente

Eres un data analyst senior experto en Python.

Analiza este dataset CSV y [OBJETIVO DEL ANÁLISIS].

Información sobre los datos:
- Fuente: [descripción de la fuente]
- Columnas principales: [col1, col2, col3, ...]
- Volumen: [número aproximado de filas]
- Periodo: [rango temporal de los datos]

Análisis solicitado:
1. Exploración: estadísticas descriptivas, valores ausentes, distribuciones
2. Limpieza: gestión de outliers, normalización, codificación
3. Análisis: [correlaciones / tendencias / segmentación / predicción]
4. Visualización: gráficos pertinentes con matplotlib/seaborn

Formato de salida:
- Código Python completo (pandas, numpy, matplotlib)
- Comentarios explicando cada paso
- Interpretación de los resultados en lenguaje no técnico
- Recomendaciones basadas en los insights

Eres un redactor web senior especializado en [ÁREA].

Redacta un artículo de blog sobre [TEMA].

Parámetros:
- Tono: [profesional / desenfadado / pedagógico]
- Longitud: [800-1200 palabras]
- Público objetivo: [descripción del lector tipo]
- Objetivo: [informar / convencer / tutorial]

Estructura:
1. Título llamativo (máx. 60 caracteres)
2. Introducción con gancho (problema/pregunta)
3. 3-5 secciones con subtítulos H2
4. Ejemplos concretos y datos cuantificados
5. Conclusión con llamada a la acción

SEO:
- Palabra clave principal: [palabra-clave]
- Palabras clave secundarias: [palabra-clave-2, palabra-clave-3]
- Meta description (máx. 155 caracteres)
- Sugerencias de enlaces internos

Restricciones:
- Sin jerga innecesaria
- Frases cortas (máx. 20 palabras)
- Un párrafo = una idea
- Incluye listas con viñetas para facilitar la lectura

# Etape 1 : Analyse
"Analyse ce codebase et identifie les problemes de performance.
Liste chaque probleme avec : fichier, ligne, severite, description."

# Etape 2 : Priorisation (utilise la sortie de l'etape 1)
"A partir de cette liste de problemes, cree un plan d'action priorise.
Criteres : impact utilisateur, complexite de correction, risque de regression."

# Etape 3 : Implementation (utilise la sortie de l'etape 2)
"Implemente la correction du probleme #1 : [description].
Genere le code corrige, les tests de non-regression, et un benchmark avant/apres."

# Etape 4 : Validation
"Revois les corrections appliquees. Verifie qu'elles ne cassent rien
et que les tests passent. Suggere des ameliorations supplementaires si pertinent."

# Dans votre CLAUDE.md, definissez des agents specialises :

## Agents disponibles

| Agent          | Role                        | Quand l'utiliser              |
|----------------|-----------------------------|-------------------------------|
| planner        | Planification               | Avant toute feature complexe  |
| tdd-guide      | Test-Driven Development     | Nouvelles features, bug fixes |
| code-reviewer  | Revue de code               | Apres chaque implementation   |
| security-check | Analyse de securite         | Avant chaque commit           |
| architect      | Decisions d'architecture    | Choix techniques importants   |
# Exemple d'utilisation dans un prompt :

"Utilise l'agent planner pour decomposer cette feature en taches.
Puis lance en parallele :
- Agent 1 (tdd-guide) : ecrit les tests pour le module auth
- Agent 2 (tdd-guide) : ecrit les tests pour le module API
- Agent 3 (security-check) : analyse les implications securite

Une fois les tests ecrits, implemente le code pour les faire passer."

# Workflow complet : nouvelle feature du planning a la production

## Phase 1 : Recherche et planification
"Recherche les implementations existantes de [feature] sur GitHub.
Evalue les 3 meilleures options selon : securite, extensibilite, pertinence.
Genere un plan d'implementation detaille avec phases et risques."

## Phase 2 : TDD (Test-Driven Development)
"En suivant le plan, ecris d'abord les tests (RED).
Pour chaque module :
1. Ecris le test → verifie qu'il echoue
2. Ecris l'implementation minimale → verifie qu'il passe (GREEN)
3. Refactorise → verifie que tout passe toujours (REFACTOR)"

## Phase 3 : Revue et securite
"Lance en parallele :
- Code review : qualite, patterns, maintenabilite
- Security review : injections, auth, secrets, XSS
- Performance review : N+1, memory leaks, bundle size
Corrige les issues CRITICAL et HIGH avant de continuer."

## Phase 4 : Integration et deploiement
"Cree la PR avec un resume complet des changements.
Verifie que le CI passe. Deploie en staging pour validation."