El proyecto APC endurece sus reglas: lo no definido en .apc/ debe ignorarse
Una aclaración sobre la especificación de estructura de carpetas evita que archivos experimentales se conviertan en instrucciones ocultas para los agentes de IA.
El proyecto Agent Project Context (APC) ha publicado una nota aclaratoria sobre cómo deben interpretarse los archivos dentro de su directorio .apc/. La regla central es clara: si un consumidor de APC se topa con una ruta que no está definida en la especificación oficial ni en una extensión formal registrada, debe ignorarla. No debe tratar el contenido de ese archivo como una instrucción válida para el agente.
El problema de las instrucciones fantasma
APC actúa como la capa de contexto portable, mientras que APX es el runtime que ejecuta ese contrato. La distinción es operativa. El riesgo surge cuando un equipo añade un archivo local, como .apc/triage-priority.md, con notas experimentales o datos de pruebas. Si una herramienta genérica recorre todo el árbol de directorios y alimenta cualquier archivo Markdown al modelo, ese borrador experimental se convierte silenciosamente en política del proyecto. Diferentes herramientas interpretarían el mismo checkout de forma distinta, rompiendo la predicción del comportamiento del agente.
La solución técnica impide que la ubicación física de un archivo determine su semántica. Un lector compatible debe identificar explícitamente qué camino está leyendo y qué significa según la especificación. Si no puede identificarlo, debe dejarlo intacto. Esto protege a los revisores humanos, que pueden leer el archivo, pero impide que un parser genérico invente interpretaciones.
¿Qué hacer si la regla debe ser estable? La guía recomienda colocar instrucciones permanentes en AGENTS.md. Si la regla aplica solo a ciertos paths o tareas, debe ir en un archivo definido bajo .apc/rules/. Si es un procedimiento invocable, el sitio correcto es .apc/skills/. Estos superficies dan a los lectores una razón legítima para cargar el contenido y a los revisores una forma de auditar el alcance.
Esto no exime de responsabilidad en materia de seguridad. Ignorar rutas desconocidas es una regla de parsing, no un control de privacidad. La especificación insiste en que no se deben guardar credenciales, conversaciones crudas, cachés o memoria de runtime privada en .apc/. El estado de ejecución de APX vive en el almacenamiento local del usuario, típicamente en ~/.apx/projects/<project-id>/. Mantener esos datos fuera del repo es obligatorio para evitar fugas de datos sensibles.
Para los equipos que gestionan repositorios con agentes de IA, esto cambia el flujo de revisión. Cuando aparezca un nuevo archivo en .apc/ en un pull request, la pregunta crítica es: ¿esta ruta está definida en la spec o en una extensión explícita? Si la respuesta es no, el contenido debe moverse a documentación estándar del proyecto, a AGENTS.md o definirse como una extensión formal de APC. Esto asegura que cualquier herramienta compatible lea el mismo contrato sin heredar comportamientos no documentados de archivos sueltos.
La especificación completa de la estructura de carpetas está disponible en la documentación oficial de APC.
