Skip to content

fix(docs): resolver la documentación de agentes/skills vía ${CLAUDE_PLUGIN_ROOT}#3

Open
Asermar wants to merge 1 commit into
FacturaScripts:mainfrom
Asermar:fix/docs-path-plugin-root
Open

fix(docs): resolver la documentación de agentes/skills vía ${CLAUDE_PLUGIN_ROOT}#3
Asermar wants to merge 1 commit into
FacturaScripts:mainfrom
Asermar:fix/docs-path-plugin-root

Conversation

@Asermar

@Asermar Asermar commented Jul 22, 2026

Copy link
Copy Markdown

Problema

Los agentes y skills que consultan la documentación empaquetada (docs-expert de fs-dev y fs-user, y los agentes de desarrollo) indican rutas relativas ./agents/docs/ (y ./agents/projects/ en fs-user) en sus instrucciones de Glob/Read.

Esas rutas se resuelven contra el cwd del proyecto del usuario, no contra el directorio del plugin. En la práctica el Glob devuelve 0 archivos y el agente no encuentra la documentación, por lo que tiende a responder de memoria en lugar de citar las fuentes reales.

Causa

./agents/docs/**/*.md desde, p. ej., /home/user/miproyecto busca en /home/user/miproyecto/agents/docs/, que no existe. La documentación vive en el directorio de instalación del plugin.

Solución

Sustituir la ruta relativa por ${CLAUDE_PLUGIN_ROOT}/agents/.... El harness expande ${CLAUDE_PLUGIN_ROOT} al directorio de instalación del plugin dentro del cuerpo de agentes y skills, por lo que:

  • resuelve correctamente sin depender del cwd,
  • es portable entre máquinas,
  • sobrevive a cambios de versión (no hay ruta ni versión hardcodeadas).

Alcance

Solo cambios de ruta en markdown de agentes/skills (23 ficheros, 77/77 líneas). Sin cambios de código ni de comportamiento más allá de dónde se leen los .md.

Verificación

Con la ruta relativa, Glob ./agents/docs/**/*.md → 0 archivos. Con ${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md → se localizan los 154 .md de fs-dev y 106 de fs-user, y docs-expert cita archivos reales.

Los agentes y skills (docs-expert y los agentes dev) leían la documentación
empaquetada desde la ruta relativa ./agents/docs/ (y ./agents/projects/ en
fs-user), que se resuelve contra el cwd del proyecto del usuario y no contra el
directorio del plugin. Resultado: el Glob devuelve 0 archivos y los agentes no
encuentran la documentación, cayendo en responder de memoria.

Se sustituye por ${CLAUDE_PLUGIN_ROOT}/agents/..., variable que el harness
expande al directorio de instalación del plugin, por lo que es portable entre
máquinas y sobrevive a cambios de versión.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant