APC debe ser seguro para clonar, APX debe ser local a la máquina
Decide dónde pertenecen los datos haciéndote una sola pregunta.
¿Sobrevivirían estos datos a un nuevo clon en otra máquina?
Si la respuesta es sí, ponlos en APC. Si no, ponlos en APX.
Esta regla mantiene la integridad de tu stack. APC permanece portátil. APX permanece útil en la máquina que ejecuta el trabajo. Cuando estas capas se desdibujan, los proyectos se vuelven difíciles de compartir y de auditar.
APC es el contrato del proyecto. APX es el runtime.
Los datos de APC son seguros para clonar. Otro desarrollador o máquina debería poder leerlos inmediatamente después de un git checkout. Deben ser revisables en git.
Buenos ejemplos de APC: • AGENTS.md para contratos del repositorio • .apc/project.json para la identidad del proyecto • .apc/agents/ para roles de agentes • .apc/skills/ para habilidades reutilizables • .apc/mcps.json para sugerencias compartidas
Los datos de APX son locales a la máquina. Estos datos permanecen en la máquina o se reconstruyen allí. Es el estado de ejecución, no contexto portátil.
Buenos ejemplos de APX: • Configuración de runtime en ~/.apx/config.json • Modos de permisos locales • Sesiones y registros de mensajes • Cachés locales • Secretos por máquina
Un repositorio no debería imponer la configuración local de una persona a todos los demás.
Cuando APC permanece seguro para clonar, puedes revisar la estructura del proyecto sin archivos ocultos. Puedes comparar (diff) instrucciones en lugar de perseguir efectos secundarios.
Cuando APX permanece local a la máquina, el runtime se adapta sin cambiar el proyecto. Una máquina puede usar un modo de permisos diferente, mientras que otra mantiene un historial más largo. El contrato del proyecto sigue siendo el mismo.
Antes de añadir un nuevo archivo, hazte estas tres preguntas:
- ¿Necesita leer esto cada herramienta compatible? Ponlo en APC.
- ¿Describe el proyecto en lugar de la máquina? Ponlo en APC.
- ¿Depende de credenciales locales o de una ejecución reciente? Ponlo en APX.
Ejemplos: • ¿Un nuevo rol de agente? APC. • ¿Un token de bot de Telegram? APX. • ¿Una nota sobre las reglas de revisión del proyecto? APC. • ¿Un registro de la última conversación? APX.
APC contiene lo que sobrevive a un clon. APX contiene lo que solo importa en la máquina actual. Esta regla simple mantiene la cordura del sistema.
Fuente: https://dev.to/agentprojectcontext/apc-should-stay-clone-safe-apx-should-stay-machine-local-59n9
Comunidad de aprendizaje opcional: https://t.me/GyaanSetuAi