Skip to content
Apothem

Preguntas frecuentes

Preguntas habituales sobre el propósito de Apothem, los entornos compatibles, la opcionalidad de la suite de plan, la personalización de reglas, los tipos de artefactos y las ubicaciones del estado del ecosistema.

Preguntas habituales, en orden de frecuencia.

¿Qué es apothem?

Apothem es un gestor de configuración agnóstico respecto al host para entornos de asistente de programación. Defines un único perfil compartido y Apothem lo materializa en la superficie de configuración nativa de cada herramienta — combinando reglas de comportamiento, estándares creativos, comandos de barra, trabajadores delegados persistentes, hooks y skills en un único corpus gobernado que se mantiene coherente en todos los entornos.

¿Con qué entornos de asistente funciona?

Apothem es agnóstico respecto al entorno. Los adaptadores por entorno bajo src/apothem/harnesses/<harness>/ proyectan el perfil compartido en el directorio de configuración nativo de cada herramienta. El registro de entornos usado en tiempo de ejecución es la fuente autoritativa del conjunto de entornos compatibles; las páginas de entornos documentan cada uno. Actualmente, el registro cubre los siguientes entornos compatibles:

Claude Code, GitHub Copilot, Cursor, Gemini CLI, Codex, Windsurf, OpenCode,
Antigravity, Open-Claw, Hermes, Qwen Code, CodeBuddy, Kiro, Trae, Zed,
GLM (Z.ai) y Kimi Code

El adaptador de Claude Code se materializa en ~/.claude/; su despachador de hooks es neutral respecto al anfitrión: primero resuelve la raíz del ecosistema a partir de $CLAUDE_PROJECT_DIR, después de $LLM_PROJECT_DIR, luego prueba búsquedas relativas al script y al directorio de trabajo, y por último recurre a $HOME/.claude.

¿Necesito usar la canalización de la suite de plan?

No. La canalización de la suite de plan es un componente del ecosistema. Las reglas de comportamiento, los estándares creativos, los hooks y la cadena de herramientas de validación son útiles de forma independiente.

¿Cómo personalizo las reglas sin bifurcar el repositorio?

Añade una cadena a la lista rules: en ~/.config/apothem/profile.yaml y vuelve a ejecutar la instalación o la actualización. Los archivos de regla bajo src/apothem/rules/ editan el árbol de código fuente empaquetado, que el instalador del archivo comprimido reemplaza cuando se ejecuta con --yes.

¿Cómo desactivo una regla temporalmente?

Cambia el nombre del archivo para que quede fuera del patrón src/apothem/rules/*.md o muévelo a un directorio hermano que el cargador no explore.

¿Cuál es la diferencia entre reglas, skills y trabajadores delegados?

  • Reglas gobiernan el comportamiento: obligaciones siempre activas o filtradas por ruta que el asistente sigue.
  • Skills son técnicas reutilizables y detectables: una señal de detección, un procedimiento y un hook de aplicación.
  • Trabajadores delegados son roles persistentes con sus propias restricciones de herramientas y prompts de sistema, despachados mediante el protocolo de orquestación de trabajadores.

¿Cómo informo de un problema de seguridad?

Consulta SECURITY.md. Los canales admitidos son GitHub Security Advisories y [email protected].

¿Cómo contribuyo?

Consulta Contribuir. En resumen: lee CONTRIBUTING.md, bifurca el repositorio, abre un PR con la plantilla de PR canónica rellenada y asegúrate de que las comprobaciones de CI pasen — la guía del desarrollador enumera las puertas que un PR debe superar.

¿Dónde vive el estado del ecosistema?

  • El estado de plan por suite vive bajo <project>/.apothem/plans/{suite}/.
  • La memoria de Apothem vive bajo .apothem/memory/ dentro de la raíz de instalación (para Claude Code: ~/.claude/.apothem/memory/; ~/.apothem/memory/ cuando workspace.scope es user-home; <project>/.apothem/memory/ en las instalaciones con ámbito de proyecto). La propia memoria automática de Claude Code vive bajo la raíz de configuración del entorno, en projects/{hash}/memory/ (para Claude Code: ~/.claude/projects/{hash}/memory/).
  • La memoria entre proyectos vive bajo esa misma raíz de configuración del entorno, en .apothem/memory/ (para Claude Code: ~/.claude/.apothem/memory/).
  • El scratch por sesión vive bajo <project>/.apothem/plans/{suite}/_inputs/.

¿Puedo retomar un trabajo de larga duración en una nueva sesión o en otra máquina?

Sí. El trabajo de larga duración externaliza su estado completo a una suite .apothem/plans/ local del proyecto — un contrato de reanudación más un protocolo de arranque en frío —, de modo que el trabajo no vive dentro de un único historial de chat. Como el estado está en los archivos de tu proyecto, una sesión nueva en cualquier cuenta o máquina apuntada al mismo proyecto retoma el trabajo donde quedó. Apothem no transfiere los archivos entre cuentas por sí mismo; viajan del mismo modo en que ya viajan los archivos de tu proyecto (control de versiones, un checkout compartido, un directorio sincronizado). Consulta Planificación reanudable.

¿Apothem necesita pip?

No, no para el motor en sí. El motor es un árbol de fuentes autocontenido con dependencias incorporadas: se ejecuta como python -m apothem desde cualquier checkout, la caché de npx o el árbol del plugin sobre Python del sistema 3.10+, y no instala nada de su propio código en site-packages (click y rich son los únicos prerrequisitos del intérprete). La única excepción opcional: si falta click o rich, el instalador ofrece ejecutar pip install solo para esos dos por ti — con tu confirmación, o --yes / APOTHEM_AUTO_INSTALL_DEPS=1. Los paquetes propios de Apothem nunca se instalan en site-packages.

¿Cómo se ejecutan los hooks sin un paquete instalado?

apothem install materializa el despachador de hooks y la puerta de conformidad bajo la raíz del entorno (para Claude Code: ~/.claude/.apothem/support/hooks/ y ~/.claude/.apothem/support/conformity/), y las entradas de hook renderizadas invocan esos scripts por ruta absoluta. Ambos son scripts autónomos de la biblioteca estándar, de modo que los hooks funcionan en una máquina que nunca ha visto pip install.

¿Cómo desinstalo por completo?

Ejecuta apothem uninstall --harness <name> por cada entorno instalado, elimina el motor según tu canal de instalación y borra ~/.apothem/ (copias de seguridad) más ~/.config/apothem/ (tu perfil) si quieres no dejar residuos. La guía de desinstalación recorre cada canal.

¿Bajo qué licencia está el ecosistema?

MIT — consulta LICENSE.

Recorrido de un plan

Recorrido de extremo a extremo de la canalización /plan para una tarea real.

Contribuir a Apothem — Guía del desarrollador

Mantén y extiende el ecosistema de Apothem creando reglas, comandos, ayudantes, skills y hooks con esquemas canónicos, requisitos de frontmatter y procedimientos de validación.

On this page

¿Qué es apothem?¿Con qué entornos de asistente funciona?¿Necesito usar la canalización de la suite de plan?¿Cómo personalizo las reglas sin bifurcar el repositorio?¿Cómo desactivo una regla temporalmente?¿Cuál es la diferencia entre reglas, skills y trabajadores delegados?¿Cómo informo de un problema de seguridad?¿Cómo contribuyo?¿Dónde vive el estado del ecosistema?¿Puedo retomar un trabajo de larga duración en una nueva sesión o en otra máquina?¿Apothem necesita pip?¿Cómo se ejecutan los hooks sin un paquete instalado?¿Cómo desinstalo por completo?¿Bajo qué licencia está el ecosistema?