Cómo trabajar con Claude en proyectos de IA
El sistema invisible que sostiene todo

El problema real

La mayoría de la gente usa Claude como un chat glorificado.

Abren una conversación.

Pegan un prompt.

Copian el resultado.

Y cuando quieren volver a esa configuración 3 días después, no la encuentran.

O peor:

Mezclan 5 proyectos diferentes en la misma ventana de contexto.

Claude se satura.

Las respuestas pierden coherencia.

Y acaban diciendo: "Es que la IA no funciona bien."

Cómo trabajo yo

Llevo 14 años en telecomunicaciones y más de un año construyendo agentes de voz con IA en producción y diferentes sistemas de automatización metiendo IA.

He saturado ventanas de contexto.

He perdido configuraciones perfectas por no documentarlas.

He cometido todos los errores.

01. Proyectos, no chats sueltos

Esto cambia todo.

La gente abre Claude, empieza a escribir y genera todo en la misma conversación infinita.

Yo no trabajo así.

Trabajo desde Projects.

Qué es un Project en Claude

Un contenedor que tiene:

• Nombre descriptivo
• Descripción clara del proyecto
• Instrucciones específicas del proyecto
• Archivos asociados (aquí van las spec y las skill)

Proyecto vs Chat

Aquí hay una distinción muy importante.

El Proyecto es el contenedor general.

Los Chats dentro del proyecto son tareas.

Ejemplo real

Proyecto: Militech – Generador de contenido

Dentro de ese proyecto:
├── Post del martes 17 de febrero
├── Artículo blog Mili Pérez
├── Carrusel LinkedIn
└── Post Instagram

Cada chat es una tarea concreta.

Pero hereda:

• Las instrucciones del proyecto
• Las spec
• Las skill

Así no saturamos la ventana de contexto.

No mezclamos cosas.

Ventanas de contexto separadas

Ejemplo real de cómo trabajo:

Chat: "Post martes 17 febrero"

En ese chat creo todo el contenido de ese día:

• Post LinkedIn
• Carrusel
• Adaptación blog

De esa conversación luego saco información muy valiosa para mejorar mis spec y mis skill.

No mezclar spec y skill en configuración global

Recomendación importante:

No meter spec y skill en la configuración global de la cuenta.

Vamos a tener:

• Spec diferentes por proyecto
• Skill diferentes por proyecto
• Instrucciones diferentes por proyecto

Cada proyecto tiene su lógica.

Ejemplos de proyectos reales

Para que lo veas claro:

• Militech – Generador de contenido
• Fábrica de Agentes IA
• Sistemas de automatización para tickets con IA y chatbot
• Mili Pérez Viajes

Este último, por ejemplo, tiene:

• Mi tono de comunicación de viajes
• Cómo escribo en Instagram
• Cómo escribo en el blog Mili Travel
• Qué estructura uso
• Qué estilo narrativo sigo

Son proyectos completamente distintos.

Cada uno con:

• Descripción bien definida
• Instrucciones propias
• Archivos propios (spec + skill)
• Contexto independiente

02. No todos los proyectos se gestionan igual

Dentro de los proyectos hay algo muy importante que entender:

No todos los proyectos se gestionan igual.

Tipo 1: Proyectos de identidad y contenido

Tengo proyectos que son menos críticos desde el punto de vista técnico.

Más orientados a identidad y comunicación.

Ejemplo:

Militech – Generador de contenido

Ahí no estoy trabajando con instrucciones técnicas que tenga que iterar constantemente.

Ahí trabajo sobre:

• Identidad de marca
• Tono de comunicación
• Voz propia
• Patrones de escritura que detecto
• Estilo narrativo

En este proyecto no necesito estar iterando ventanas de contexto constantemente con Claude.

Trabajo con:

• Instrucciones sobre identidad de marca
• MCPs
• Consulta a mis mejores artículos del blog
• Archivos locales que tengo en mi ordenador
• Deploy en GitHub
• Netlify como servidor

Ese es mi stack.

Es un proyecto más estable.

Más de identidad que de ingeniería.

Tipo 2: Proyectos críticos de ingeniería

En cambio, el proyecto:

Elio – Agentes IA

Es completamente diferente.

Aquí estamos hablando de:

• Agentes de voz reales
• Arquitectura de sistemas
• Construcción técnica de abajo hacia arriba

Y aquí cambia totalmente el enfoque.

En este tipo de proyecto:

• No meto spec
• No meto skill

No porque no sean útiles.

Sino porque aquí lo que necesito es otra cosa.

Aquí lo que meto son instrucciones de ingeniería de prompt muy específicas.

En inglés.

Para qué

Para que Claude:

• No me lance arquitecturas por su cuenta
• No me genere sistemas sin validar conmigo
• No se invente pasos
• No asuma cosas que no le he confirmado

Yo quiero que el proyecto se construya de abajo hacia arriba.

Validando cada paso conmigo.

Principio clave: Claude no decide, consulta

En este proyecto le doy instrucciones para que:

• Me consulte siempre antes de avanzar
• Valide la base de conocimiento que yo le genero
• No genere ningún paso previo si no tiene claridad absoluta
• Me haga preguntas estructuradas antes de proponer arquitectura

Lo convierto en un sistema interactivo de diseño.

No en un generador automático.

Y esto es clave.

Porque si no haces esto, Claude te lanza:

• Arquitecturas preciosas
• Diagramas maravillosos
• Flujos perfectos

Pero que no están alineados con tu realidad técnica.

Ni con tu base de conocimiento.

Comparativa

03. Diferencia entre Instrucciones, SPEC y SKILL

Aquí es donde la gente se pierde.

No es lo mismo.

1. INSTRUCCIONES DEL PROYECTO

Qué son:

Las instrucciones base que le das al LLM al inicio del proyecto para que entienda:

• Qué problema estás resolviendo
• Cómo debe trabajar contigo (iteración, validación)
• Qué metodología seguir (de abajo hacia arriba, sin romper lo que funciona)
• Restricciones y límites del proyecto

Ejemplo:

Cuando empiezas un proyecto de agente de voz o automatización compleja, le das instrucciones de cómo debe colaborar contigo.

Cómo iterar.

Qué validar.

Caso real:

Proyecto: Elio – Agentes IA

Instrucciones del proyecto:
- No generes arquitectura sin validar conmigo
- No asumas integraciones que no he confirmado
- Pregunta antes de proponer flujos
- Construye de abajo hacia arriba
- No rellenes huecos con suposiciones

2. SPEC (Especificaciones)

Qué son:

Documentos de referencia que definen estándares o conocimiento que el LLM debe seguir.

Ejemplos reales míos:

• SPEC-01: Identidad visual (colores, tipografía, elementos de marca)
• SPEC-02: Voz y tono (cómo sueno yo)
• SPEC-03: LinkedIn formato (medidas, estructura de posts)

Cuándo las uso:

En proyectos de identidad y contenido.

Donde necesito que Claude mantenga consistencia de marca, estilo y formato.

Cuándo NO las uso:

En proyectos de ingeniería.

Donde estoy construyendo sistemas técnicos desde cero.

Y necesito validación constante.

3. SKILL (Habilidades)

Qué son:

Procedimientos paso a paso para ejecutar tareas específicas.

Ejemplos reales míos:

• SKILL-01: Generar carrusel LinkedIn
  • Paso 1: definir contenido
  • Paso 2: generar HTML
  • Paso 3: renderizar PNG
  • Paso 4: compilar PDF
• SKILL-02: Escribir post LinkedIn
  • Paso 1: identificar tipo
  • Paso 2: gancho
  • Paso 3: desarrollo
  • Paso 4: cierre
  • Paso 5: hashtags

Cuándo las uso:

Cuando quiero que Claude ejecute una tarea siguiendo un proceso probado y optimizado.

Tabla de diferencias

Por qué importa esta distinción

Si metes todo en el mismo sitio, Claude se confunde.

Si metes instrucciones de ingeniería en un proyecto de contenido, vas a tener problemas.

Si metes spec de identidad visual en un proyecto técnico, Claude va a perder el foco.

04. Las instrucciones de ingeniería de prompt

Aquí es donde la mayoría se pierde.

Porque las instrucciones de ingeniería de prompt no son prompts bonitos.

Son reglas explícitas que le das a Claude para que:

• No se invente arquitecturas
• No asuma integraciones que no tienes
• No rellene huecos con suposiciones
• Pregunte antes de proponer
• Valide cada paso contigo

He adaptado las instrucciones que uso para crear agentes de voz en producción.

Incluyen:

• Rol y objetivo del sistema
• Personalidad de Claude en el proyecto
• Contexto del problema
• Estructura exacta del sistema
• Flujo de validación paso a paso
• Gestión de integraciones
• Variables dinámicas
• Base de conocimientos
• 17 preguntas estratégicas obligatorias
• Lista de verificación de auditoría
• Etapas del proceso
• Recordatorios importantes
• Ejemplos de conversaciones reales

Todo documentado.

Todo probado en producción.

Todo con ejemplos reales.

05. Nota crítica

Si metes las instrucciones de ingeniería de sistemas en tu configuración global, Claude va a intentar validar arquitectura cuando le pidas que te escriba un post de LinkedIn.

Si metes las spec de identidad visual en la configuración global, Claude va a intentar aplicar colores corporativos cuando estés diseñando un sistema de tickets.

Cada proyecto tiene su configuración.

Cada proyecto tiene sus instrucciones.

Cada proyecto tiene sus archivos.

Lo que hemos visto hoy

Lo que viene después

En los próximos artículos voy a desglosar:

Parte 2: Cómo se ve en la práctica

Conversación completa construyendo el sistema de tickets con IA.

Desde el primer mensaje hasta el código en producción.

Sin inventar nada.

Parte 3: SPEC - Cuándo usarlas y cómo crearlas

Qué son las especificaciones.

Cuándo meterlas en un proyecto.

Cómo crearlas desde cero.

Ejemplos reales.

Parte 4: SKILL - Automatizar tareas repetitivas

Qué son las habilidades.

Cómo documentar procedimientos paso a paso.

Ejemplos reales.

Cuándo usar skill vs cuándo no.

Parte 5: Iteración y refinamiento

Cómo mejorar proyectos basándote en resultados reales.

Qué métricas mirar.

Cuándo ajustar instrucciones, spec o skill.

Parte 6: Errores que he cometido

Los proyectos que saturé por mala estructura.

Las configuraciones que perdí por no documentar.

Las suposiciones que me costaron semanas de trabajo.

Parte 7: De prototipo a producción

Cómo llevar un proyecto de Claude a sistema real.

Qué validar.

Qué documentar.

Qué automatizar.

Por qué estoy escribiendo esto

Llevo más de un año trabajando así con Claude.

He iterado más de 400 proyectos.

He cometido todos los errores.

He encontrado lo que funciona.

Y nadie está contando esto desde las trincheras.

Todo el mundo enseña prompts bonitos.

Nadie enseña estructura.

Nadie enseña validación.

Nadie enseña iteración real.

06. Conclusión

Si vas a trabajar con Claude en proyectos de IA, empieza por aquí:

1. Estructura tus proyectos
2. Separa ventanas de contexto
3. Diferencia entre proyectos de identidad y proyectos de ingeniería
4. Usa instrucciones, spec y skill en su contexto correcto
5. No mezcles configuraciones en global