Flujos de trabajo principales

Apothem ofrece cuatro capacidades principales: un perfil de gobernanza compartido, un corpus de reglas, una canalización de planificación estructurada y una puerta de conformidad en tiempo real.

El perfil compartidoCopy Anchor Link

Tu perfil de Apothem reside en ~/.config/apothem/profile.yaml a menos que pases --profile PATH. Es la única fuente de verdad de la que cada adaptador de entorno deriva su configuración nativa:

identity:
  name: "Example User"
preferences:
  style: "concise"
rules:
  - "Validate external input before writing files."

Crea el perfil si todavía no existe y luego inspecciónalo. Los instaladores de un solo paso y apothem install ya escriben un perfil inicial en la primera ejecución, y profile init se detiene con un error y deja sin cambios un archivo existente a menos que pases --force.

apothem profile init
apothem profile show --json

La primera reglaCopy Anchor Link

Añade reglas compartidas al YAML del perfil y luego vuelve a materializar el entorno seleccionado. Cuando esas reglas incluyan datos de ejemplo, usa marcadores de posición ficticios para que ninguna identidad o credencial real acabe en un perfil compartido o en una ejecución de CI.

apothem profile set rules '["Always include a brief summary at the end of every response."]'
apothem update --harness claude-code
apothem verify --harness claude-code

El primer planCopy Anchor Link

La canalización /plan se ejecuta dentro de tu entorno como comandos de barra, no a través del binario apothem. Una vez instalado un entorno, inicia un plan desde el chat de la herramienta:

/plan-spec

/plan-spec refina tu prosa en una especificación, y /plan-generate materializa una suite de plan bajo <project-root>/.apothem/plans/{suite}/. Consulta la referencia de comandos de la canalización para ver el flujo completo.

Puerta de conformidadCopy Anchor Link

Desde un checkout de Apothem, ejecuta:

PYTHONPATH=src python -m apothem.conformity.gate --all .

Tras una instalación con script, ejecuta:

PYTHONPATH="$HOME/.apothem/src" python3 -m apothem.conformity.gate --all .

Ejecuta todas las comprobaciones mecánicas de conformidad e informa de aprobado/fallido por cada barra.