AGENTS.md: el archivo que cada agente IA lee primero

Cada vez que empiezas una conversación con IA, empiezas desde cero. El IA no te recuerda. Tienes que re-explicarte.

AGENTS.md arregla esto. Es un archivo que cada agente IA lee automáticamente, antes de hacer nada. Lo escribes una vez. Cada herramienta que lo soporta carga tu contexto instantáneamente.

Piénsalo como el brief que darías a un asistente nuevo el primer día: “Aquí quién soy, aquí cómo trabajo, aquí qué espero.”

Qué va en AGENTS.md

Tu identidad y rol, cómo prefieres trabajar, reglas y límites, enlaces a contexto.

Identidad:

• Quién eres (fundador, ingeniero, escritor, consultor)
• Qué estás construyendo ahora
• Tus valores centrales

Cómo trabajas:

• Timezone, idioma, estilo de comunicación
• Formato preferido (listas vs. prosa, conciso vs. detallado)
• Cómo tomar decisiones (pregunta primero vs. decide por mí)
• Qué herramientas usas

Reglas:

• Qué hacer siempre (commit, push, incluir fuentes, resumir)
• Qué nunca hacer (compartir API keys, asumir datos de clientes, tomar decisiones financieras)
• Qué requiere aprobación explícita (publicar, enviar mensajes, decidir)

Enlaces:

• Tu Segundo Cerebro
• Tus SOPs
• Tus proyectos actuales

Estructura de ejemplo

# AGENTS.md para [Tu Nombre]

## Quién soy
Soy [rol]. Estoy construyendo [qué]. Mis valores: [lista].

## Cómo trabajo
- Zona horaria: [timezone]
- Idioma: [idioma]
- Prefiero: [conciso/detallado], [listas/prosa]
- Uso: [herramientas]

## Qué hacer siempre
- Commit y push después de cambios
- Incluir fuentes
- Escribir resúmenes
- Preguntar antes de cambios irreversibles

## Qué nunca hacer
- Usar API keys en archivos
- Asumir datos de clientes
- Tomar decisiones financieras
- Publicar sin aprobación

## Contexto
- Mi Segundo Cerebro: ~/obsidian-vault
- Mis SOPs: /docs/SOPs.md

Errores comunes

Hacerlo demasiado detallado. Escribes 5 páginas queriendo ser exhaustivo. Pero cada línea extra diluye las reglas importantes. Una página máximo.

No actualizarlo. Lo escribes una vez y lo olvidas. Tus metas cambian. Actualiza cuando tu trabajo cambia.

Mezclar personal y profesional. Tu AGENTS.md debe ser profesional y compartible. Notas privadas van en un vault separado.

No usarlo en todas partes. Configuras AGENTS.md pero sigues pegando prompts en ChatGPT. El punto es evitar pegar.

---

Próximos pasos

Escribe tu AGENTS.md hoy. Mantén corto. Actualiza cuando cambie tu trabajo.

Mira [[Segundo Cerebro en Obsidian]] — tu AGENTS.md debe apuntar a tu Segundo Cerebro.

También lee [[por qué los SOPs importan]] — buenos SOPs hacen AGENTS.md más efectivo.