Todos los artículos

Agentes de IA y Codex

Deja de explicar tu negocio a la IA en cada sesión: crea su manual operativo

Por · Actualizado junio de 2026

Respuesta corta

Deja de copiar y pegar el contexto de tu empresa en cada chat. Un archivo de instrucciones como AGENTS.md funciona como un manual operativo permanente que los agentes de IA leen automáticamente. Al definir tu negocio, ofertas, tono, reglas y límites de escalado en una sola página markdown, transformas explicaciones repetitivas en infraestructura duradera.

Deja de explicar tu negocio a la IA en cada sesión: crea su manual operativo

Si cada nueva conversación con la IA empieza con «Mira, mi empresa se dedica a…», no tienes un sistema de inteligencia artificial. Tienes un becario muy rápido que sufre de amnesia.

La mayor pérdida de tiempo con la IA en una pequeña empresa no es elegir el modelo equivocado. Es la fricción constante de volver a teclear el mismo contexto, el perfil de tus clientes, tus criterios de calidad y lo que nunca debe hacer en una ventana de chat vacía.

El error es tratar a la IA como una interfaz de chat desechable. El primer paso correcto es construir su manual operativo: un archivo de instrucciones central (habitualmente llamado AGENTS.md o CLAUDE.md) que los agentes leen automáticamente antes de empezar a trabajar.

Prompts vs Plantillas vs Manuales Operativos

Para entender por qué el trabajo diario suele ser caótico, analiza los tres niveles de instrucciones:

  1. Prompts puntuales: Preguntas improvisadas en el chat. Sirven para una consulta rápida, pero tienen cero memoria empresarial.
  2. Plantillas reutilizables: Textos guardados que copias y pegas. Mejoran el resultado, pero exigen trabajo manual y fallan cuando alguien olvida pegarlos.
  3. El Manual Operativo (AGENTS.md): Un documento permanente y estructurado guardado en tu espacio de trabajo. Cada agente lo lee al arrancar la sesión y aplica tus normas a cada respuesta.

El nombre del archivo varía según el software, pero el manual operativo no cambia.


Las 7 secciones de un brief operativo eficaz

Un buen manual no cuenta toda la historia de tu empresa. Fija límites, define fuentes oficiales de información y aclara cuándo avisar a una persona mediante siete bloques:

# AGENTS.md - Manual Operativo de Empresa

## 1. Negocio y Audiencia
Quiénes somos: [ej. Instaladora solar residencial en Cataluña].
Audiencia principal: [Propietarios de viviendas unifamiliares que buscan reducir su factura de luz].

## 2. Ofertas y Servicios Principales
- Instalaciones fotovoltaicas llave en mano (3 kW a 10 kW).
- Sistemas de almacenamiento con baterías.
- Gestión de subvenciones locales y compensación de excedentes.

## 3. Tono y Voz
- Lenguaje directo, práctico y sin tecnicismos innecesarios.
- Comunicación de igual a igual. Cero humo publicitario o frases corporativas vacías.
- Nunca uses rayas largas. Emplea comas, paréntesis, dos puntos o puntos.

## 4. Reglas y Restricciones Negativas
- Nunca prometas plazos exactos de cobro de subvenciones ni garantices concesiones.
- Nunca inventes nombres de clientes, testimonios ni porcentajes sin verificar.
- Explica siempre las premisas antes de realizar un cálculo técnico.

## 5. Fuentes de Verdad
- Tarifas y catálogo de materiales: `docs/tarifas-2026.md`
- Procedimientos de visita técnica: `docs/sop-estudio-solar.md`

## 6. Qué Puedes Hacer de Forma Autónoma
- Redactar borradores de seguimiento basados en notas de propuestas.
- Estructurar resúmenes técnicos a partir de fichas de fabricantes en PDF.
- Limpiar y formatear datos de contacto de clientes potenciales.

## 7. Qué Debes Escalar a un Humano
- Cualquier petición de descuento especial fuera de tarifa.
- Reclamaciones formales de clientes o disputas legales.
- Validación final de cualquier presupuesto antes de su envío.

Ejemplo real: el manual operativo de una instaladora solar

Comprueba la diferencia cuando un agente redacta un correo de seguimiento con y sin manual operativo:

  • Sin AGENTS.md: La IA escribe tres párrafos genéricos con lenguaje inflado («¡Nos complace presentarle nuestra solución solar de vanguardia!»), promete una bonificación fiscal que caducó el año pasado y usa un tono excesivamente formal.
  • Con AGENTS.md: La IA consulta la fuente de verdad, recuerda que las bonificaciones requieren validación técnica previa, utiliza un tono directo, menciona la potencia exacta de 5,4 kWp del tejado del cliente y deja la confirmación final de precio en manos del responsable comercial.

Conexión con tus SOPs y tu Segundo Cerebro

El archivo AGENTS.md es la puerta de entrada, no toda la biblioteca.

Cuando el conocimiento de tu negocio está repartido en correos sueltos, notas desordenadas y la memoria de tus empleados, la IA siempre responderá con lugares comunes. Al centralizar la información de tu empresa en un Segundo Cerebro en Markdown (por ejemplo con Obsidian), tu archivo de instrucciones puede dirigir a los agentes hacia Procedimientos Operativos Estándar (SOPs) precisos.

Para entender por qué los procesos deben estar claros antes de automatizar, consulta nuestra guía sobre por qué los SOPs van antes que la automatización.


El sprint de 45 minutos para crearlo

Puedes redactar tu primer manual operativo hoy mismo en tres bloques de 15 minutos:

  1. Minutos 0 al 15 (Datos clave): Rellena las secciones 1, 2 y 3. Define tu modelo de negocio, cliente objetivo y estilo de redacción.
  2. Minutos 15 al 30 (Límites y escalado): Identifica los tres errores más graves que un asistente podría cometer con un cliente. Añádelos a las secciones 4 (Restricciones) y 7 (Escalado).
  3. Minutos 30 al 45 (Fuentes oficiales): Localiza tus dos documentos de referencia esenciales (grilla de precios, lista de servicios) y enlázalos en la sección 5.

Guarda este archivo como AGENTS.md en tu carpeta de trabajo o pégalo en las instrucciones de tu proyecto. Tu equipo dispondrá de una base sólida y permanente para cada interacción con la IA.


Si tu equipo tiene este problema, esto es lo que trabajamos en una formación práctica de IA para pymes. Te ayudamos a crear los manuales de instrucciones de tu empresa, estructurar tu base de conocimiento y desplegar flujos de agentes adaptados a tu operativa diaria.

Preguntas frecuentes

¿Cuál es la diferencia entre un prompt y un archivo de instrucciones?

Un prompt es una indicación temporal que escribes en la ventana de chat y que desaparece al cerrar la sesión. Un archivo de instrucciones como AGENTS.md o CLAUDE.md es un documento permanente en tu espacio de trabajo. Las herramientas compatibles lo cargan automáticamente al inicio de cada sesión, garantizando que se cumplan tus estándares sin copiar a mano.

¿Todas las herramientas de IA leen AGENTS.md automáticamente?

El nombre del archivo varía según la herramienta. Entornos para desarrolladores y agentes de código como Cursor, Windsurf, Codex o Claude Code buscan AGENTS.md o CLAUDE.md por defecto. Para entornos de chat como ChatGPT Team o Claude Projects, pegas exactamente el mismo texto de 7 secciones en las instrucciones del proyecto. El nombre cambia, pero el manual operativo es idéntico.

¿Qué extensión debe tener un archivo AGENTS.md?

Mantén el archivo por debajo de 100 líneas (entre 500 y 800 palabras). Si incluyes demasiada información, el modelo diluye las reglas críticas. Los procedimientos detallados deben ir en Procedimientos Operativos Estándar (SOPs) vinculados, mientras que AGENTS.md actúa como el contrato de comportamiento básico.

¿Con qué frecuencia se debe actualizar este archivo?

Actualízalo cada vez que cambien tus ofertas, cuando añadas una nueva regla operativa o cuando la IA cometa un error repetitivo. Al ser un único archivo centralizado, cualquier modificación se aplica automáticamente a todas las sesiones futuras.

¿Quieres esto dentro de tu propia empresa?

Simple AI Studio imparte un bootcamp de implementación para fundadores y equipos pequeños. Sales con un sistema de IA funcionando, no con diapositivas.

Sigue leyendo