Conceptos
Glosario que define los perfiles compartidos, los adaptadores de entorno, las reglas, los hooks, las puertas de conformidad, las skills y los trabajadores delegados en Apothem.
Una referencia rápida de los términos que encontrarás a lo largo de la documentación de Apothem.
Perfil compartido
Un archivo YAML validado por esquema en ~/.config/apothem/profile.yaml (sustitúyelo con --profile PATH).
Es la única fuente de verdad de tu identidad, preferencias y configuración; cada adaptador
de entorno lo lee durante la instalación y deriva de él la configuración nativa de ese entorno.
Adaptador de entorno
Un adaptador específico de cada plataforma que traduce el perfil compartido al formato de configuración nativo de un entorno concreto. Los entornos de ejecución admitidos se enumeran en:
Claude Code, Cursor, Gemini CLI, etc.Instalar Apothem siempre significa: instalar el perfil compartido y, a continuación, materializar uno o más adaptadores.
Regla de comportamiento
Un archivo Markdown bajo src/apothem/rules/ que se carga en cada interacción (siempre activa) o
solo al editar archivos bajo una ruta específica (filtrada por ruta). Las reglas codifican cómo debe
comportarse el entorno. Cuatro reglas están siempre activas: agnostic-posture, authority-inquiry,
session-closure y context-management. El índice de reglas, apothem-rule-index, se carga con
ellas y nombra cada una de las demás reglas y cuándo leerla. Un entorno que no delimita las reglas por
ruta no carga ninguna de las demás, así que el índice es la forma en que una sesión las encuentra.
Hook
Un script de Python registrado en la configuración de hooks de un entorno (settings.json en Claude Code) que se dispara ante eventos del ciclo de vida, como PreToolUse, PostToolUse, SessionStart y Stop; algunos adaptadores también registran PreCompact y PostCompact. Los hooks aplican los mandatos de conformidad en tiempo real, antes de que la salida llegue al disco. Los adaptadores de entornos sin mecanismo de hooks lo omiten.
Puerta de conformidad
La fracción mecánica de la puerta de pre-emisión de quince barras (M1-M15): los validadores verificables por máquina
que se ejecutan antes de emitir un artefacto; consultivos de forma predeterminada, bloqueantes
con --strict. La puerta de pre-emisión es el piso de calidad; la
puerta de conformidad ejecuta sus barras verificables por máquina, y los hooks aplican barras individuales en tiempo real.
Suite de plan
Un directorio estructurado en <project-root>/.apothem/plans/<suite-name>/ que contiene una especificación, un plan maestro, archivos PHASE.md por fase y artefactos de salida. La canalización /plan gestiona las suites de plan.
Skill
Una técnica reutilizable e invocable mediante comando de barra, empaquetada como un archivo SKILL.md bajo src/apothem/skills/<name>/. Las skills amplían la superficie de comandos de barra más allá de la canalización /plan integrada.
Trabajador delegado
Un asistente persistente y con alcance específico definido en la ruta canónica:
src/apothem/agents/<name>.mdLos trabajadores delegados se encargan de la investigación, la auditoría, la verificación de calidad y la gestión de memoria.