fix: skills and agent reference plugin files by bare relative paths #37

Summary

Most of the plugin-level file references in the skills and the ffca-layer-auditor agent are bare relative paths such as references/ffca/overview.md or scripts/validate_layers.dart, with no ${CLAUDE_PLUGIN_ROOT}/ prefix. Nothing resolves these to the plugin's own files: Claude Code only expands ${CLAUDE_PLUGIN_ROOT}, and an agent working in a user's repo resolves a relative path against that repo. They only work when the model guesses the base from an earlier ${CLAUDE_PLUGIN_ROOT}/references/ffca/ mention in the same file.

Found while adding the plugin to vgv_ai_cli. That CLI rewrites ${CLAUDE_PLUGIN_ROOT} to the plugin's location for Codex, Copilot and Antigravity, so it can only fix paths that use the placeholder.

Where (at v0.1.2)

About 56 bare references across 5 files:

Examples:

• skills/ffca-feature/SKILL.md:25 reads "Read references/ffca/overview.md, section Feature layers…"
• skills/ffca-architecture/SKILL.md:39 reads "Read references/ffca/project_structure.md, section Dependency rules…"
• skills/ffca-audit/SKILL.md:27 reads "The agent runs dart run scripts/validate_layers.dart --all…". Run from the user's repo, this fails. The fallback on line 30 and the agent itself (agents/ffca-layer-auditor.md:39) correctly use dart run ${CLAUDE_PLUGIN_ROOT}/scripts/validate_layers.dart --all.

Expected

Every reference to a file the plugin ships uses ${CLAUDE_PLUGIN_ROOT}/…, e.g. ${CLAUDE_PLUGIN_ROOT}/references/ffca/overview.md.

Suggested fix

• Prefix every bare references/… and scripts/… path in skills/ and agents/ with ${CLAUDE_PLUGIN_ROOT}/.
• Optionally add a check (e.g. in skills_lint.yaml or CI) that fails on a bare references/ or scripts/ path in those folders.