home

Pablo IB

search
Blog 4 min read

Reporte de correcciones — Blog pabloib

Fecha: 2026-04-16 Motivo: Error factual sobre .pi/AGENTS.md + placeholders de API keys Commits: c8222f5 y 4839735 en master (ya deployed) + correcciones locales adicionales pendientes de commit Prioridad: Cerrar revisión de copy y dejar todos los artículos consistentes

El error

Los siguientes artículos afirmaban que .pi/AGENTS.md era una ubicación válida donde Pi carga contexto automáticamente. Eso es falso. Pi solo carga AGENTS.md o CLAUDE.md directamente en cada directorio (cwd y padres), nunca dentro de .pi/.

Fuente verificada: código fuente de Pi (resource-loader.js → loadContextFileFromDir).

Artículos corregidos (ya en producción)

1. Tu AGENTS.md — Contexto que el agente entiende

Cambio aplicado:

AntesDespués
/projects/web/app/.pi/AGENTS.md ← También válidoEliminada
Solo el diagramaAñadido párrafo: “Pi busca AGENTS.md o CLAUDE.md directamente en cada directorio, caminando desde el cwd hacia arriba. No busca dentro de subdirectorios como .pi/”

Revisión SEO/copy:

  • El párrafo nuevo tiene tono consistente con el resto del artículo
  • El diagrama de jerarquía se lee bien (3 niveles, sin .pi/)
  • La sección “SYSTEM.md — Controlando el system prompt” menciona .pi/SYSTEM.md correctamente como feature distinta
  • Corregido hallazgo adicional: front matter mal cerrado (--- pegado al primer párrafo) y lastmod actualizado a 2026-04-16

2. Pi desde cero — Instalación y primera sesión

Cambios aplicados:

AntesDespués
./AGENTS.md o ./.pi/AGENTS.md — instrucciones del proyecto actual./AGENTS.md — instrucciones del proyecto actual (o ./CLAUDE.md como alias)
“Todos se concatenan automáticamente.”“Pi busca estos archivos directamente en cada directorio (no dentro de subdirectorios como .pi/). Todos se concatenan automáticamente.”
ANTHROPIC_API_KEY con placeholder tipo sk-ant-tu-clave-aquiANTHROPIC_API_KEY con placeholder <tu-api-key>
OPENAI_API_KEY con placeholder tipo sk-tu-clave-aquiOPENAI_API_KEY con placeholder <tu-api-key>
.bashrc con placeholder tipo sk-ant-....bashrc con placeholder <tu-api-key>
Sección troubleshooting con placeholder tipo sk-ant-...Sección troubleshooting con placeholder <tu-api-key>

Revisión SEO/copy:

  • El párrafo de AGENTS.md fluye bien con el texto anterior
  • <tu-api-key> es claro para el lector y evita falsos positivos de secret guard
  • La sección troubleshooting (“No API key found”) sigue teniendo sentido con el nuevo placeholder
  • Corregido hallazgo adicional: front matter mal cerrado (--- pegado al primer párrafo)
  • Corregido hallazgo adicional: link interno roto al artículo de AGENTS.md
  • Corregido hallazgo adicional: prerequisites → prerrequisitos
  • Corregido hallazgo adicional: resumen final alineado con el placeholder <tu-api-key>
  • lastmod actualizado a 2026-04-16

Artículo corregido tras la revisión

3. Cómo configurar Pi para proyectos TypeScript

Problema detectado: Placeholder que imitaba una API key real en ejemplo de settings.json (línea 50).

Corrección aplicada: "apiKey": "<tu-api-key>"

Revisión SEO/copy:

  • Placeholder corregido para mantener consistencia con el resto de artículos
  • Revisión manual completada: no hay menciones a .pi/AGENTS.md en el artículo
  • lastmod actualizado a 2026-04-16

Artículos sin cambios pero que mencionan AGENTS.md

Estos artículos mencionan AGENTS.md de forma genérica (sin .pi/) y no requieren corrección factual, pero conviene revisar por coherencia:

ArtículoURLMencionesEstado
Por qué Pi cambió mi workflowlink1 (link al artículo de AGENTS.md)✅ OK
Gestión de contexto y sesioneslink1 (en diagrama)✅ OK
Skills — Superpoderes bajo demandalink1 (link al artículo de AGENTS.md)✅ OK
Cómo monté un LLM Wiki con Hugo y Pilink6 (uso correcto de AGENTS.md en raíz)✅ OK
El patrón LLM Wiki de Karpathylink2 (referencia metafórica)✅ OK

Artículos sin mención de AGENTS.md (sin impacto)

  • Ant Colony: cuando un agente no es suficiente
  • Del caos al orden: gestionando contexto con Pi
  • Mis 10 extensiones favoritas de Pi
  • Prompt engineering para agentes de código
  • Serena vs OneTool: ¿cuándo usar cada uno?
  • Extensiones — Pi que se programa a sí mismo
  • Patrones avanzados — Multi-agente y automatización
  • Builds reproducibles en Hugo con npx
  • Debugging con Pi: del stack trace al fix

Hallazgos adicionales de la revisión manual

HallazgoArchivoEstado
Front matter mal cerrado (--- pegado al primer párrafo)2026-04-12-tu-agents-md-contexto-que-el-agente-entiende.md✅ Corregido
Front matter mal cerrado (--- pegado al primer párrafo)2026-04-12-pi-desde-cero-instalacion-y-primera-sesion.md✅ Corregido
Link interno roto hacia el artículo de AGENTS.md (/posts/)2026-04-12-pi-desde-cero-instalacion-y-primera-sesion.md✅ Corregido
Inconsistencia de copy: prerequisites en inglés2026-04-12-pi-desde-cero-instalacion-y-primera-sesion.md✅ Corregido
Resumen final con placeholder residual ...2026-04-12-pi-desde-cero-instalacion-y-primera-sesion.md✅ Corregido

Acciones pendientes

#AcciónResponsablePrioridad
1Revisar manualmente “Del caos al orden” y “Gestión de contexto” por si tienen diagramas con .pi/AGENTS.md que el scanner de texto no detectó en bloques de código con formato especialSEO/copyMedia
2Confirmar que ~/.pi/agent/AGENTS.md (config global) está bien diferenciado de .pi/AGENTS.md (subdirectorio de proyecto) en todos los artículosSEO/copyMedia
3Decidir si el postmortem técnico (docs/postmortems/2026-04-16-agents-md-location-error.md) debe publicarse como artículo o queda como doc internoEditorBaja

Referencia rápida: qué es correcto y qué no

Patrón¿Correcto?Nota
~/.pi/agent/AGENTS.md✅ SíConfig global de Pi (funciona)
<proyecto>/AGENTS.md✅ SíContexto de proyecto (pi lo carga)
<proyecto>/CLAUDE.md✅ SíAlias de AGENTS.md
<proyecto>/.pi/AGENTS.md❌ NoPi NO lo carga automáticamente
<proyecto>/.pi/SYSTEM.md✅ SíSystem prompt override (feature distinta)
<proyecto>/.pi/settings.json✅ SíConfig de proyecto (feature distinta)